Installation et configuration de...

IBM Planning AnalyticsVersion 2.0.0

Installation et configuration dePlanning Analytics

��

ImportantAvant d'utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à lasection «Remarques», à la page 397.

LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBMDECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DECONTREFACON AINSI QU'EN CAS DE DEFAUT D'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE.

Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui ysont fournies sont susceptibles d'être modifiées avant que les produits décrits ne deviennent eux-mêmesdisponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ouservices non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés.

Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM,référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenairecommercial.

Vous pouvez également consulter les serveurs Internet suivants :v http://www.fr.ibm.com (serveur IBM en France)

v http://www.ibm.com/ca/fr (serveur IBM au Canada)

v http://www.ibm.com (serveur IBM aux Etats-Unis)

Compagnie IBM FranceDirection Qualité17, avenue de l'Europe92275 Bois-Colombes Cedex

Le présent document s'applique à IBM Planning Analytics version 2.0.0 et peut aussi s'appliquer aux éditionsultérieures de ce produit.

Licensed Materials - Property of IBM. Eléments sous licence - Propriété d'IBM.

© Copyright IBM Corporation 2007, 2017.

http://www.fr.ibm.com

http://www.ibm.com/ca/fr

http://www.ibm.com

Table des matières

Avis aux lecteurs canadiens . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Chapitre 1. Nouveautés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1Nouveautés relatives à l'installation et la configuration de Planning Analytics dans la version 2.0.0 . . . . . . 1

WebSphere Liberty Profile est le serveur d'applications par défaut . . . . . . . . . . . . . . . . 1Modifications apportées aux composants sélectionnables dans l'assistant d'installation du serveur TM1 . . . . 1

Chapitre 2. Planification de l'installation de Planning Analytics . . . . . . . . . . . . 3Programmes d'installation disponibles . . . . . . . . . . . . . . . . . . . . . . . . . . . 3Composants disponibles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Composants de l'installation du niveau de données TM1 . . . . . . . . . . . . . . . . . . . 5Composants de l'installation du niveau Web TM1 . . . . . . . . . . . . . . . . . . . . . . 6Composants de l'installation du niveau riche TM1 . . . . . . . . . . . . . . . . . . . . . . 8Composant pour l'installation de la documentation traduite . . . . . . . . . . . . . . . . . . 10Autres composants d'installation non répertoriés . . . . . . . . . . . . . . . . . . . . . . 10

Différenciation de client TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Clients pour utilisateur final . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Clients d'administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

Configuration logicielle requise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Valeurs d'installation par défaut . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Présentation de la configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Cognos Configuration et Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . 17Fichiers de configuration et paramètres de Cognos TM1 . . . . . . . . . . . . . . . . . . . 18

Comptes utilisateur pour l'exécution des services Cognos TM1 sous Windows . . . . . . . . . . . . . 18Installation de TM1 sur des réseaux sans domaine . . . . . . . . . . . . . . . . . . . . . . 19

Syntaxe de la machine locale . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Chapitre 3. Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21Architecture de Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Présentation de Cognos TM1 Admin Server . . . . . . . . . . . . . . . . . . . . . . . 22Présentation de Cognos TM1 Server . . . . . . . . . . . . . . . . . . . . . . . . . . 23Présentation des fichiers de Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . 24Présentation du répertoire de données . . . . . . . . . . . . . . . . . . . . . . . . . 25

Architecture de Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Accès à plusieurs serveurs Cognos TM1 depuis Cognos TM1 Web . . . . . . . . . . . . . . . . 28Limitation de l'accès à un serveur Cognos TM1 unique à partir de Cognos TM1 Web. . . . . . . . . . 28

Architecture de Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . . 29Cognos TM1 Applications - Niveau 1 : Clients Web . . . . . . . . . . . . . . . . . . . . . 30Cognos TM1 Applications - Niveau 2 : Serveur Web . . . . . . . . . . . . . . . . . . . . 31Cognos TM1 Applications - Niveau 3 : Données . . . . . . . . . . . . . . . . . . . . . . 32

Chapitre 4. Déploiement . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Déploiement de Cognos TM1 sur un seul ordinateur Windows . . . . . . . . . . . . . . . . . . 33Déploiement de Cognos TM1 Admin Server et de TM1 Server . . . . . . . . . . . . . . . . . . 34Déploiement de Cognos TM1 Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Déploiement de Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . . . 35

Considérations relatives à la sécurité lors de l'utilisation de Cognos TM1 Applications . . . . . . . . . 36Déploiement de tous les composants Cognos TM1 Applications sur un seul ordinateur . . . . . . . . . 37Déploiement des composants d'IBM Cognos TM1 Applications sur des ordinateurs distincts . . . . . . . 38

Déploiement des applications client Cognos TM1. . . . . . . . . . . . . . . . . . . . . . . 39

© Copyright IBM Corp. 2007, 2017 iii

Chapitre 5. Mise à niveau. . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Planification de la mise à niveau . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Mise à niveau depuis Planning Analytics version 2.0.0 . . . . . . . . . . . . . . . . . . . . . 44Mise à niveau de Planning Analytics for Microsoft Excel . . . . . . . . . . . . . . . . . . . . 44Mise à niveau à partir de Cognos TM1 version 10.2.x . . . . . . . . . . . . . . . . . . . . . 45Mise à niveau de Cognos TM1 version 10.1.x . . . . . . . . . . . . . . . . . . . . . . . . 46Mise à niveau à partir de Cognos TM1 version 9.x . . . . . . . . . . . . . . . . . . . . . . 47

Arrêt des services Cognos TM1 9.x avant la mise à niveau . . . . . . . . . . . . . . . . . . 47Sauvegarde des données d'une version antérieure de Cognos TM1 9.x . . . . . . . . . . . . . . . 48Désinstallation d'une version précédente d'IBM Cognos TM1 9.x . . . . . . . . . . . . . . . . 49Mise à niveau d'une installation monoposte de Cognos TM1 . . . . . . . . . . . . . . . . . . 50Mise à niveau de Cognos TM1 Server sous UNIX ou Linux . . . . . . . . . . . . . . . . . . 50Mise à niveau de Cognos TM1 Server sous Windows . . . . . . . . . . . . . . . . . . . . 50Mise à niveau des clients Cognos TM1 Architect et Perspectives . . . . . . . . . . . . . . . . . 50Mise à niveau de Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . . . . . 51Mise à niveau de Cognos TM1 Contributor vers Cognos TM1 Applications . . . . . . . . . . . . . 51Restauration des données et des fichiers de configuration de Cognos TM1 version 9.x dans la nouvelle version 54

Feuilles de calcul .xls Microsoft Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Enregistrement des droits de sécurité lors de l'importation ou de la restauration d'une application Cognos TM1. . 56

Chapitre 6. Intégration de Planning Analytics aux logiciels IBM Cognos . . . . . . . 57Sécurité Planning Analytics et Cognos Analytics . . . . . . . . . . . . . . . . . . . . . . . 58Importation de données Cognos Analytics dans Cognos TM1 à l'aide de Cognos TM1 Package Connector . . . . 58

Installation de Cognos TM1 Package Connector . . . . . . . . . . . . . . . . . . . . . . 59Cognos TM1 en tant que source de données avec Cognos Analytics . . . . . . . . . . . . . . . . 63

Activation de la génération de rapports Cognos Analytics à partir de sources de données Cognos TM1. . . . 63iWidgets Cognos TM1 et Cognos Workspace . . . . . . . . . . . . . . . . . . . . . . . . 64Intégration de Cognos TM1 Applications à Cognos Analytics et au portail Cognos Connection . . . . . . . 65

Chapitre 7. Installation monoposte de Planning Analytics . . . . . . . . . . . . . . 67Installation des logiciels prérequis . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Installation des composants Cognos TM1 de base. . . . . . . . . . . . . . . . . . . . . . . 68Utilisation de Cognos Configuration en vue du démarrage des composants Cognos TM1 . . . . . . . . . 69Exécution de Cognos TM1 Perspectives . . . . . . . . . . . . . . . . . . . . . . . . . . 70Exécution de Cognos TM1 Architect . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Exécution de Cognos TM1 Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Exécution de Cognos TM1 Application Web . . . . . . . . . . . . . . . . . . . . . . . . 71Exécution de Cognos TM1 Performance Modeler . . . . . . . . . . . . . . . . . . . . . . . 72Exécution de Cognos Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Utilisation de Cognos TM1 Application Web . . . . . . . . . . . . . . . . . . . . . . . . 73Autres composants Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Configuration des postes client en vue de l'exportation des données Cognos TM1 au format PDF . . . . . . 75

Chapitre 8. Installation de Cognos TM1 Server . . . . . . . . . . . . . . . . . . 77Installation de Cognos TM1 Server sous Windows . . . . . . . . . . . . . . . . . . . . . . 77

Installation des composants de Cognos TM1 Server sous Windows . . . . . . . . . . . . . . . . 77Utilisation de Cognos Configuration pour démarrer les serveurs Cognos TM1 sous Windows . . . . . . . 78Modification des services Cognos TM1 en vue de leur fonctionnement sous un compte utilisateur spécifiquesous Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Installation de Cognos TM1 Server sous UNIX ou Linux . . . . . . . . . . . . . . . . . . . . 80Installation des composants Cognos TM1 Server sous UNIX ou Linux . . . . . . . . . . . . . . . 80Exécution de Cognos TM1 sous IBM AIX . . . . . . . . . . . . . . . . . . . . . . . . 83Noms d'objet TM1 et codage des caractères pour les serveurs TM1 sous UNIX et Windows . . . . . . . 85

Configuration de la langue de Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . 86Codes de langue Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Configuration de la langue du serveur Cognos TM1 . . . . . . . . . . . . . . . . . . . . . 88Configuration de la langue des clients Cognos TM1 sous Windows. . . . . . . . . . . . . . . . 88Configuration de la langue du navigateur Web pour Cognos TM1 Web . . . . . . . . . . . . . . 89

Création d'un nouveau serveur Cognos TM1 vide dans Cognos Configuration . . . . . . . . . . . . . 89Ajout d'un serveur Cognos TM1 existant dans Cognos Configuration . . . . . . . . . . . . . . . . 91

iv IBM Planning Analytics Version 2.0.0 - Installation et configuration

Définition de l'emplacement de l'hôte Admin de Cognos TM1 . . . . . . . . . . . . . . . . . . 91Définition de plusieurs hôtes Admin pour Cognos TM1 . . . . . . . . . . . . . . . . . . . . 92Configuration avancée de Cognos TM1 Admin Server et de Cognos TM1 Server . . . . . . . . . . . . 92

Modification des ports par défaut pour Cognos TM1 Admin Server . . . . . . . . . . . . . . . 92Configuration de Cognos TM1 en vue de l'utilisation d'IPv6 . . . . . . . . . . . . . . . . . . 93

Surveillance de l'utilisation des licences de serveur TM1 . . . . . . . . . . . . . . . . . . . . 95

Chapitre 9. Installation de Cognos TM1 Operations Console. . . . . . . . . . . . . 97Installation de Cognos TM1 Operations Console à l'aide du logiciel de serveur Web WebSphere Liberty fourni . . 97Déploiement de Cognos TM1 Operations Console à l'aide de Cognos Configuration . . . . . . . . . . . 98Installation avancée de Cognos TM1 Operations Console . . . . . . . . . . . . . . . . . . . . 98

Installation de Cognos TM1 Operations Console sur une machine distincte . . . . . . . . . . . . . 98Installation de Cognos TM1 Operations Console avec votre propre installation de serveur d'applications WebApache Tomcat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Installation de Cognos TM1 Operations Console sur IBM WebSphere . . . . . . . . . . . . . . . 101

Configuration de Cognos TM1 Operations Console . . . . . . . . . . . . . . . . . . . . . . 104Démarrage de Cognos TM1 Operations Console et connexion . . . . . . . . . . . . . . . . . . 105

Chapitre 10. Installation de Cognos TM1 Web . . . . . . . . . . . . . . . . . . 107Installation de TM1 Web avec le serveur d'applications WebSphere Liberty fourni . . . . . . . . . . . 107

Installation et configuration de Cognos TM1 Web sous Microsoft Windows. . . . . . . . . . . . . 108Installation et configuration de Cognos TM1 Web sous UNIX . . . . . . . . . . . . . . . . . 109

Installation de TM1 Web avec IBM WebSphere . . . . . . . . . . . . . . . . . . . . . . . 110Déploiement de TM1 Web sur IBM WebSphere Application Server. . . . . . . . . . . . . . . . 111Importation de certificats SSL pour TM1 Web. . . . . . . . . . . . . . . . . . . . . . . 112

Modification des paramètres de configuration de Cognos TM1 Web . . . . . . . . . . . . . . . . 113Paramètres de configuration de Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . 113Edition du fichier de configuration de Cognos TM1 Web . . . . . . . . . . . . . . . . . . . 119Configuration de la page de connexion Cognos TM1 Web à l'aide des paramètres AdminHostName etTM1ServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120Configuration d'une page d'accueil personnalisée pour IBM Cognos TM1 Web . . . . . . . . . . . 121Configuration des paramètres de démarrage et d'apparence d'IBM Cognos TM1 Web . . . . . . . . . 126Modification de la taille des pages de Cube Viewer . . . . . . . . . . . . . . . . . . . . 129Réglage du nombre maximum de feuilles à exporter depuis un Cube Viewer . . . . . . . . . . . . 129Retour à la ligne des valeurs chaîne dans les vues de cube . . . . . . . . . . . . . . . . . . 129

Définition du délai d'expiration de la session de TM1 Web . . . . . . . . . . . . . . . . . . . 130Configuration du navigateur Web pour Cognos TM1 Web . . . . . . . . . . . . . . . . . . . 131

Configuration de la langue du navigateur Web pour Cognos TM1 Web . . . . . . . . . . . . . . 131Affichage et saisie de nombres dans Cognos TM1 Web en fonction des paramètres régionaux . . . . . . 131Configuration d'Internet Explorer pour Cognos TM1 Web . . . . . . . . . . . . . . . . . . 132Exécution de Cognos TM1 Web sur un serveur WAN et exportation des fichiers Excel et PDF . . . . . . 132

Chapitre 11. Installation de Cognos TM1 Application Server . . . . . . . . . . . . 135Installation de Cognos TM1 Application Server avec le profil WebSphere Liberty fourni . . . . . . . . . 136

Installation des composants de Cognos TM1 Web Tier . . . . . . . . . . . . . . . . . . . . 136Déploiement de Cognos TM1 Application Server avec le serveur d'applications WebSphere Liberty Profilefourni . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137Configuration de la sécurité authentifiée de Cognos TM1 Application Web . . . . . . . . . . . . . 137Configuration des environnements client et serveur de Cognos TM1 Application Web . . . . . . . . . 138Paramètres Cognos TM1 Application Server dans Cognos Configuration . . . . . . . . . . . . . 140

Identification du lien de démarrage de l'URL pour Cognos TM1 Application Web . . . . . . . . . . . 141Configuration d'un serveur Cognos TM1 en vue de son utilisation avec Cognos TM1 Application Web . . . . 142Configuration d'IBM Cognos TM1Application Web . . . . . . . . . . . . . . . . . . . . . . 143Journalisation du serveur Cognos TM1 Application. . . . . . . . . . . . . . . . . . . . . . 144Installation et configuration avancées de Cognos TM1 Application Server . . . . . . . . . . . . . . 146

Installation de Cognos TM1 Application Server avec votre propre serveur d'applications Web Apache Tomcat 146Installation de Cognos TM1 Application Server avec votre propre installation d'IBM Websphere. . . . . . 149Configuration de Cognos TM1 Application Web en vue de l'utilisation de plusieurs serveurs Cognos TM1 . . 155Utilisation d'un proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156Configuration de la sécurité des fonctions TurboIntegrator de Cognos TM1 dans Insight . . . . . . . . 160

Table des matières v

Chapitre 12. Planning Analytics Workspace installation . . . . . . . . . . . . . . 163Planning Analytics Workspace architecture . . . . . . . . . . . . . . . . . . . . . . . . 163Planning Analytics Workspace installation overview . . . . . . . . . . . . . . . . . . . . . 164

Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164Installing Docker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165Installing Planning Analytics Workspace . . . . . . . . . . . . . . . . . . . . . . . . 165Connecting Planning Analytics Workspace to Cognos TM1 and authentication servers . . . . . . . . . 166Checking the status of the services . . . . . . . . . . . . . . . . . . . . . . . . . . 167Planning Analytics Workspace and Cognos TM1 installed on one computer . . . . . . . . . . . . 168Configuring SSL for Planning Analytics Workspace. . . . . . . . . . . . . . . . . . . . . 168Configuration du protocole SSL entre Planning Analytics Workspace et d'autres serveurs . . . . . . . . 169Configuring a Linux virtual machine to start automatically . . . . . . . . . . . . . . . . . . 170

Chapitre 13. Administer Planning Analytics Workspace . . . . . . . . . . . . . . 171Viewing logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Accessing the Outil d'administration Planning Analytics Workspace remotely . . . . . . . . . . . . . 171Users in Planning Analytics Workspace. . . . . . . . . . . . . . . . . . . . . . . . . . 172Backing up or restoring Planning Analytics Workspace . . . . . . . . . . . . . . . . . . . . 172Upgrading Planning Analytics Workspace . . . . . . . . . . . . . . . . . . . . . . . . . 173Uninstalling Planning Analytics Workspace . . . . . . . . . . . . . . . . . . . . . . . . 173

Chapitre 14. Installation du niveau riche TM1. . . . . . . . . . . . . . . . . . . 175Installation de Cognos TM1 Perspectives . . . . . . . . . . . . . . . . . . . . . . . . . 175Installation de Cognos TM1 Architect . . . . . . . . . . . . . . . . . . . . . . . . . . 177Installation de Cognos TM1 Performance Modeler . . . . . . . . . . . . . . . . . . . . . . 178

Installation de Cognos TM1 Performance Modeler à l'aide du programme d'installation . . . . . . . . 179Installation de Cognos TM1 Performance Modeler depuis le portail Cognos TM1 Applications . . . . . . 180Installation multiposte distante de Cognos TM1 Performance Modeler . . . . . . . . . . . . . . 180Configuration de la journalisation de Cognos TM1 Performance Modeler . . . . . . . . . . . . . 183

Installation de Cognos Insight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183Installation de Cognos Insight à l'aide du programme d'installation . . . . . . . . . . . . . . . 184Installation de Cognos Insight à partir du portail Cognos TM1 Applications . . . . . . . . . . . . 184Installation multiposte distante de Cognos Insight . . . . . . . . . . . . . . . . . . . . . 185Configuration de la journalisation de Cognos Insight . . . . . . . . . . . . . . . . . . . . 188

Installation des API de Cognos TM1. . . . . . . . . . . . . . . . . . . . . . . . . . . 188Configuration des postes client en vue de l'exportation des données Cognos TM1 au format PDF . . . . . . 189

Chapitre 15. Installation et configuration d'IBM Planning Analytics for Microsoft Excel 191Nouveautés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Nouveautés de la version 2.0.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Nouveautés de la version 10.3.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Nouveautés de la version 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . 191Nouveautés de la version 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

Présentation de l'installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Conditions préalables à l'installation de Planning Analytics for Microsoft Excel . . . . . . . . . . . . 194

Installation de Microsoft .NET Framework . . . . . . . . . . . . . . . . . . . . . . . 194Assemblages d'interopérabilité de base (PIA) pour Microsoft Excel . . . . . . . . . . . . . . . 194Désinstallation des versions précédentes d'IBM Cognos for Microsoft Excel. . . . . . . . . . . . . 196Connexion à IBM Planning Analytics Workspace Local . . . . . . . . . . . . . . . . . . . 196Configuration de connexions pour les API REST TM1 . . . . . . . . . . . . . . . . . . . . 197Configuration du logiciel antivirus . . . . . . . . . . . . . . . . . . . . . . . . . . 197Assurez-vous de bien utiliser un ID IBM . . . . . . . . . . . . . . . . . . . . . . . . 197

Tâches d'installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Installation d'IBM Planning Analytics for Microsoft Excel. . . . . . . . . . . . . . . . . . . 198Test d'IBM Planning Analytics for Microsoft Excel . . . . . . . . . . . . . . . . . . . . . 198Désinstallation d'IBM Planning Analytics for Microsoft Excel . . . . . . . . . . . . . . . . . 199Enregistrement de la macro complémentaire IBM Cognos Office Reporting TM1 à l'aide d'un script . . . . 200

Traitement des incidents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Problèmes de configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200Problèmes de traitement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

vi IBM Planning Analytics Version 2.0.0 - Installation et configuration

Problèmes de sécurité . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204Messages d'erreur numérotés de Cognos Office . . . . . . . . . . . . . . . . . . . . . . 205Messages d'erreur IBM Planning Analytics for Microsoft Excel numérotés . . . . . . . . . . . . . 207

Chapitre 16. Installation des bases de données d'exemple de Cognos TM1 . . . . . . 211Utilisation des bases de données d'exemple installées par défaut . . . . . . . . . . . . . . . . . 212Utilisation des bases de données d'exemple GO_Contributor et Outdoors Company . . . . . . . . . . . 213

Utilisation des exemples de serveur Ventes Vacances et Aventure avec la base de données d'exemple . . . . 214

Chapitre 17. Installation des outils Cognos TM1 . . . . . . . . . . . . . . . . . 223

Chapitre 18. Configuration de la sécurité . . . . . . . . . . . . . . . . . . . . 225Sécurité authentifiée . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225

Présentation de l'authentification . . . . . . . . . . . . . . . . . . . . . . . . . . . 226Utilitaire ETLDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229Connexion intégrée . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239Authentification LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251Utilisation de la sécurité Cognos avec Cognos TM1. . . . . . . . . . . . . . . . . . . . . 257

Utilisation de SSL pour la sécurisation de la transmission de données . . . . . . . . . . . . . . . 272Présentation de l'utilisation de SSL pour la sécurisation de la transmission de données . . . . . . . . . 272Certificats générés . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273Configuration du serveur Admin de Cognos TM1 pour SSL . . . . . . . . . . . . . . . . . . 274Configuration du serveur Cognos TM1 pour SSL . . . . . . . . . . . . . . . . . . . . . 276Configuration des clients Cognos TM1 pour utiliser SSL . . . . . . . . . . . . . . . . . . . 281Configuration de SSL dans Cognos TM1 Web . . . . . . . . . . . . . . . . . . . . . . 282Configuration de Cognos TM1 Applications pour l'utilisation de SSL . . . . . . . . . . . . . . . 284Configuration de l'API TM1 C pour SSL . . . . . . . . . . . . . . . . . . . . . . . . 288Configuration de l'API Java de Cognos TM1 pour SSL . . . . . . . . . . . . . . . . . . . 288Configuration de l'utilitaire Cognos TM1 ETLDAP pour SSL . . . . . . . . . . . . . . . . . 289Utilisation de certificats indépendants avec SSL et Planning Analytics . . . . . . . . . . . . . . 289

Chapitre 19. Maintenance de l'installation Cognos TM1 . . . . . . . . . . . . . . 297Sauvegarde des données et des fichiers de configuration de Cognos TM1 . . . . . . . . . . . . . . 297Modification des composants Cognos TM1 installés . . . . . . . . . . . . . . . . . . . . . 298Désinstallation d'IBM Planning Analytics . . . . . . . . . . . . . . . . . . . . . . . . . 299Désinstallation et déploiement de Cognos TM1 Applications . . . . . . . . . . . . . . . . . . 301

Sauvegarde des données Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . 301Exportation d'applications depuis Cognos TM1 Applications . . . . . . . . . . . . . . . . . 302Arrêt des services associés dans Cognos TM1 . . . . . . . . . . . . . . . . . . . . . . 302Désinstallation de Cognos TM1 Applications . . . . . . . . . . . . . . . . . . . . . . . 303Annulation du déploiement de Cognos TM1 Applications dans Apache Tomcat . . . . . . . . . . . 304Annulation du déploiement de Cognos TM1 Applications dans WebSphere . . . . . . . . . . . . 304

Restauration des fichiers de données et de configuration dans IBM Planning Analytics version 2.0.0 . . . . . 305Restauration des fichiers de configuration et d'application dans Cognos TM1 Applications . . . . . . . . 307Importation d'une définition d'application dans Cognos TM1 Applications . . . . . . . . . . . . . . 307

Chapitre 20. Fonctions d'accessibilité . . . . . . . . . . . . . . . . . . . . . . 309Raccourcis clavier de l'assistant d'installation . . . . . . . . . . . . . . . . . . . . . . . . 309Raccourcis clavier pour Cognos Configuration . . . . . . . . . . . . . . . . . . . . . . . 310

Annexe A. Fichier de configuration du serveur tm1s.cfg . . . . . . . . . . . . . . 311Emplacement du fichier tm1s.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311Exemple de fichier tm1s.cfg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311Paramètres du fichier tm1s.cfg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312

AdminHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313AllowReadOnlyChoreReschedule . . . . . . . . . . . . . . . . . . . . . . . . . . . 313AllowSeparateNandCRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313AllRuleCalcStargateOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . 314ApplyMaximumViewSizeToEntireTransaction. . . . . . . . . . . . . . . . . . . . . . . 315

Table des matières vii

AuditLogMaxFileSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315AuditLogMaxQueryMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315AuditLogOn. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316AuditLogUpdateInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316AutomaticallyAddCubeDependencies . . . . . . . . . . . . . . . . . . . . . . . . . 316CacheFriendlyMalloc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317CalculationThresholdForStorage . . . . . . . . . . . . . . . . . . . . . . . . . . . 317CAMPortalVariableFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317CAMUseSSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318CheckFeedersMaximumCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318ClientCAMURI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318ClientExportSSLSvrCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319ClientExportSSLSvrKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319ClientPingCAMPassport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319ClientMessagePortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319ClientPropertiesSyncInterval . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320ClientVersionMaximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 320ClientVersionMinimum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321ClientVersionPrecision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321CognosMDX.AggregateByAncestorRef . . . . . . . . . . . . . . . . . . . . . . . . . 322CognosMDX.CellCacheEnable . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323CognosMDX.PrefilterWithPXJ . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323CognosMDX.SimpleCellsUseOPTSDK . . . . . . . . . . . . . . . . . . . . . . . . . 323CognosMDX.UseProviderCrossJoinThreshold . . . . . . . . . . . . . . . . . . . . . . . 324CognosTM1InterfacePath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324CreateNewCAMClients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324DataBaseDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325DefaultMeasuresDimension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325DisableMemoryCache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325DisableSandboxing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326Display_Info_DBType_R8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326DistributedPlanningOutputDir . . . . . . . . . . . . . . . . . . . . . . . . . . . 327DownTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327EnableNewHierarchyCreation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328EnableTIDebugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328ExcelWebPublishEnabled . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328FileRetry.Count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329FileRetry.Delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329FileRetry.FileSpec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329FIPSOperationMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330ForceReevaluationOfFeedersForFedCellsOnDataChange . . . . . . . . . . . . . . . . . . . 330HTTPPortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331HTTPSessionTimeoutMinutes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332IdleConnectionTimeOutSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . . 332IndexStoreDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332IntegratedSecurityMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332IPAddressV4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334IPAddressV6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334IPVersion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335JavaClassPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336JavaJVMArgs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336JavaJVMPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336JobQueuing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 336JobQueueMaxWaitTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337JobQueueThreadPoolSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337JobQueueThreadSleepTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338keyfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338keylabel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338keystashfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338Language. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339LDAPHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

viii IBM Planning Analytics Version 2.0.0 - Installation et configuration

LDAPPasswordFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340LDAPPasswordKeyFile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340LDAPPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340LDAPSearchBase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340LDAPSearchField . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340LDAPSkipSSLCertVerification . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341LDAPSkipSSLCRLVerification . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341LDAPUseServerAccount. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341LDAPVerifyCertServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341LDAPVerifyServerSSLCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342LDAPWellKnownUserName . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343LoadPrivateSubsetsOnStartup . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343LockPagesInMemory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 343LoggingDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344LogReleaseLineCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344MagnitudeDifferenceToBeZero. . . . . . . . . . . . . . . . . . . . . . . . . . . . 344MaskUserNameInServerTools . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345MaximumCubeLoadThreads . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345MaximumLoginAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346MaximumMemoryForSubsetUndo . . . . . . . . . . . . . . . . . . . . . . . . . . 346MTFeeders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347MTFeeders.AtStartup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347MTFeeders.AtomicWeight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 347MaximumSynchAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348MaximumTILockObjects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 348MaximumUserSandboxSize. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349MaximumViewSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 349MDXSelectCalculatedMemberInputs . . . . . . . . . . . . . . . . . . . . . . . . . . 349MessageCompression. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351MTCubeLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351MTCubeLoad.MinFileSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352MTCubeLoad.UseBookmarkFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . 352MTCubeLoad.Weight . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352MTQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353MTQ.CTreeRedundancyReducer . . . . . . . . . . . . . . . . . . . . . . . . . . . 353MTQ.OperationProgressCheckSkipLoopSize . . . . . . . . . . . . . . . . . . . . . . . 354MTQ.SingleCellConsolidation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354NetRecvBlockingWaitLimitSeconds . . . . . . . . . . . . . . . . . . . . . . . . . . 354NetRecvMaxClientIOWaitWithinAPIsSeconds. . . . . . . . . . . . . . . . . . . . . . . 355NIST_SP800_131A_MODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355ODBCLibraryPath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355OracleErrorForceRowStatus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355PasswordMinimumLength . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356PasswordSource . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356PerfMonIsActive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356PerformanceMonitorOn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357PersistentFeeders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357PortNumber . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357PreallocatedMemory.BeforeLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . 358PreallocatedMemory.Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358PreallocatedMemory.ThreadNumber . . . . . . . . . . . . . . . . . . . . . . . . . . 358PrivilegeGenerationOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . 358ProgressMessage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359ProportionSpreadToZeroCells . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359PullInvalidationSubset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360RawStoreDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361ReceiveProgressResponseTimeoutSecs . . . . . . . . . . . . . . . . . . . . . . . . . 361RulesOverwriteCellsOnLoad . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362RunningInBackground . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362SaveTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363SecurityPackageName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

Table des matières ix

ServerCAMURI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363ServerCAMURIRetryAttempts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364ServerLogging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 364ServerName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365ServicePrincipalName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365SkipLoadingAliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365SkipSSLCAMHostCheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366SpreadingPrecision . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366SpreadErrorInTIDiscardsAllChanges. . . . . . . . . . . . . . . . . . . . . . . . . . 367SSLCertAuthority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367SSLCertificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367SSLCertificateID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368StartupChores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368SubsetElementBreatherCount . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368SupportPreTLSv12Clients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369SvrSSLExportKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369SyncUnitSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369tlsCipherList. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370TM1ConnectorforSAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370UnicodeUpperLowerCase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370UseExcelSerialDate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371UseLocalCopiesforPublicDynamicSubsets . . . . . . . . . . . . . . . . . . . . . . . . 372UseNewConnectorforSAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372UserDefinedCalculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372UseSQLFetch UseSQLFetchScroll UseSQLExtendedFetch . . . . . . . . . . . . . . . . . . . 373UseSSL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373UseStargateForRules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374ViewConsolidationOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . 374ViewConsolidationOptimizationMethod . . . . . . . . . . . . . . . . . . . . . . . . 375ZeroWeightOptimization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

Annexe B. Fichier de configuration du client Tm1p.ini . . . . . . . . . . . . . . . 377Emplacement du fichier Tm1p.ini . . . . . . . . . . . . . . . . . . . . . . . . . . . 377Paramètres du fichier Tm1p.ini . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

AdminHost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378AdminSvrSSLCertAuthority . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378AdminSvrSSLCertID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379AdminSvrSSLCertRevList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379AdminSvrSSLExportKeyID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379AdvancedRulesEditor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379AllowImportCamClients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379BrowseDisplayReadsRightToLeft . . . . . . . . . . . . . . . . . . . . . . . . . . . 380ClassicSliceMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380CognosGatewayURI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380ConnectLocalAtStartup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380DataBaseDirectory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380DimensionDownloadMaxSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380DisableAdminHostEntry. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381DisableWritebackOnDisconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . 381DisableWritebackOnTM1Formulas . . . . . . . . . . . . . . . . . . . . . . . . . . 382DisplayApplications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382DisplayChores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382DisplayControlCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382DisplayCubes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382DisplayDimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382DisplayExplorerPropertiesWindow . . . . . . . . . . . . . . . . . . . . . . . . . . 382DisplayProcesses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383DisplayReplications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383ExpandRowHeaderWidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383ExportAdminSvrSSLCert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383InSpreadsheetBrowser . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383

x IBM Planning Analytics Version 2.0.0 - Installation et configuration

IntegratedLogin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Language. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384LocalServernetworkProtocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385MainWindowLayoutInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385PreviousAdminHosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385PreviousDataDirectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385SecurityAssignmentWindowLayoutInfo. . . . . . . . . . . . . . . . . . . . . . . . . 385SentMsgsToServerCountWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 385ShowAdminHostChangeWarning. . . . . . . . . . . . . . . . . . . . . . . . . . . 385ShowAliasAttributeWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385ShowChoresSchedulingWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 386ShowCubeReplicationWarning. . . . . . . . . . . . . . . . . . . . . . . . . . . . 386ShowDimDeleteElementWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 386ShowDimensionAccessWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 386ShowDynamicSubsetWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386ShowPickOperationWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386ShowProcessUNASCIIWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 386ShowProcessUNODBCWarning . . . . . . . . . . . . . . . . . . . . . . . . . . . 387SliceNewWorkbook . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387SubsetWindowLayoutInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387TM1RebuildDefault . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387

Annexe C. Définitions d'installations et de configurations sans surveillance . . . . . 389Installations sans surveillance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389

Définition d'une installation sans surveillance . . . . . . . . . . . . . . . . . . . . . . 389Définition d'une configuration sans surveillance . . . . . . . . . . . . . . . . . . . . . . . 390Définition d'une désinstallation sans surveillance . . . . . . . . . . . . . . . . . . . . . . 391

Annexe D. Traitement des incidents. . . . . . . . . . . . . . . . . . . . . . . 393IBM Knowledge Center . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393Support Portal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Collecte des informations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Demandes de service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Support Assistant Lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Fix Central . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Communauté IBM Planning Analytics . . . . . . . . . . . . . . . . . . . . . . . . . . 395Flux RSS du support logiciel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395Recherche et navigation dans les produits IBM . . . . . . . . . . . . . . . . . . . . . . . 395

Remarques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

Table des matières xi

xii IBM Planning Analytics Version 2.0.0 - Installation et configuration

Avis aux lecteurs canadiens

Le présent document a été traduit en France. Voici les principales différences etparticularités dont vous devez tenir compte.

Illustrations

Les illustrations sont fournies à titre d'exemple. Certaines peuvent contenir desdonnées propres à la France.

Terminologie

La terminologie des titres IBM peut différer d'un pays à l'autre. Reportez-vous autableau ci-dessous, au besoin.

IBM France IBM Canada

ingénieur commercial représentant

agence commerciale succursale

ingénieur technico-commercial informaticien

inspecteur technicien du matériel

Claviers

Les lettres sont disposées différemment : le clavier français est de type AZERTY, etle clavier français-canadien de type QWERTY.

OS/2 et Windows - Paramètres canadiens

Au Canada, on utilise :v les pages de codes 850 (multilingue) et 863 (français-canadien),v le code pays 002,v le code clavier CF.

Nomenclature

Les touches présentées dans le tableau d'équivalence suivant sont libelléesdifféremment selon qu'il s'agit du clavier de la France, du clavier du Canada ou duclavier des États-Unis. Reportez-vous à ce tableau pour faire correspondre lestouches françaises figurant dans le présent document aux touches de votre clavier.

© Copyright IBM Corp. 2007, 2017 xiii

Brevets

Il est possible qu'IBM détienne des brevets ou qu'elle ait déposé des demandes debrevets portant sur certains sujets abordés dans ce document. Le fait qu'IBM vousfournisse le présent document ne signifie pas qu'elle vous accorde un permisd'utilisation de ces brevets. Vous pouvez envoyer, par écrit, vos demandes derenseignements relatives aux permis d'utilisation au directeur général des relationscommerciales d'IBM, 3600 Steeles Avenue East, Markham, Ontario, L3R 9Z7.

Assistance téléphonique

Si vous avez besoin d'assistance ou si vous voulez commander du matériel, deslogiciels et des publications IBM, contactez IBM direct au 1 800 465-1234.

xiv IBM Planning Analytics Version 2.0.0 - Installation et configuration

Introduction

Ce document explique comment installer, mettre à niveau et configurer lescomposants logiciels d'IBM® Planning Analytics Local sur les systèmesd'exploitation Microsoft Windows et UNIX.

A qui s'adresse ce manuel ?

IBM Planning Analytics Local intègre la planification commerciale, la mesure desperformances et les données opérationnelles pour permettre aux sociétésd'optimiser leur efficacité commerciale et leur interaction avec le client, quelle quesoit la géographie ou la structure impliquée. Planning Analytics offre la visibilitéimmédiate sur les données, la responsabilité dans un processus collaboratif et unevue cohérente des informations, ce qui permet aux cadres de stabiliser rapidementles fluctuations opérationnelles et de profiter des nouvelles opportunités.

Pour utiliser ce document, vous devez disposer de bonnes connaissances sur :v les concepts d'installationv les problèmes liés à la sécuritév l'administration de base de Windows ou d'UNIXv l'environnement serveur existant et l'infrastructure de sécurité de votre sociétév les impératifs de votre système Planning Analytics et du réseau

Rechercher des informations

Pour rechercher la documentation produit sur le Web, y compris toute ladocumentation traduite, accédez à IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter).

Remarques relatives à la sécurité

Pour les remarques relatives à la sécurité d'IBM Planning Analytics, voir«Considérations relatives à la sécurité lors de l'utilisation de Cognos TM1Applications», à la page 36. Des informations relatives à la gestion del'authentification de groupe et d'utilisateur sont disponibles au chapitre Gestion desutilisateurs et des groupes du manuel TM1 - Guide des opérations.

Fonctions d'accessibilité

Les fonctions d'accessibilité aident les utilisateurs qui souffrent d'un handicapphysique, tel qu'une mobilité limitée ou une vision faible, à utiliser les logiciels.L'assistant d'installation est doté de fonctions d'accessibilité. Pour en savoirdavantage sur ces fonctionnalités ; reportez-vous à la section qui traite del'accessibilité dans ce document.

La documentation IBM au format HTML comporte des fonctions d'accessibilité. Lesdocuments au format PDF sont considérés comme des documents d'appoint et, entant que tel, n'en sont pas dotés.

© Copyright IBM Corp. 2007, 2017 xv

http://www.ibm.com/support/knowledgecenter/

Instructions prospectives

La présente documentation décrit les fonctionnalités actuelles du produit. Elle peutcontenir des références à des éléments qui ne sont pas disponibles actuellement.Cela n'implique aucune disponibilité ultérieure de ces éléments. De tellesréférences ne constituent en aucun cas un engagement, une promesse ou uneobligation légale de fournir un élément, un code ou une fonctionnalité. Ledéveloppement, la disponibilité et le calendrier de mise à disposition des fonctionsdemeurent à la seule discrétion d'IBM.

Clause de décharge relative aux exemples

La société Vacances et Aventure, Ventes VA, et toutes les variantes du nomVacances et Aventure, ainsi que Planning, décrivent des opérations métier fictives.Celles-ci contiennent des données qui servent d'exemple à IBM et à ses clients pourdévelopper des applications d'exemple. Ces données fictives comprennent desexemples de données pour des transactions de vente, la distribution de produits,des données financières et les ressources humaines. Toute ressemblance avec desnoms de personnes, de sociétés ou des données réelles serait purement fortuite.D'autres fichiers d'exemple peuvent contenir des données fictives généréesmanuellement ou par une machine, des données factuelles compilées à partir desources académiques ou publiques, ou des données utilisées avec l'autorisation dudétenteur des droits d'auteur, à utiliser comme échantillon de données pourdévelopper des exemples d'application. Les noms de produit référencés peuventêtre les marques de leurs propriétaires respectifs. Toute reproduction sansautorisation est interdite.

xvi IBM Planning Analytics Version 2.0.0 - Installation et configuration

Chapitre 1. Nouveautés

Cette section répertorie les fonctions qui ont été ajoutées, modifiées ou suppriméespour cette édition.

Pour consulter l'intégralité de la documentation IBM Planning Analyticsactuellement disponible, accédez à l'IBM Knowledge Center (https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0).

Nouveautés relatives à l'installation et la configuration de PlanningAnalytics dans la version 2.0.0

La liste ci-après identifie les fonctions d'installation et de configuration nouvelles etmodifiées d'IBM Planning Analytics version 2.0.0.

WebSphere Liberty Profile est le serveur d'applications pardéfaut

IBM Planning Analytics installe un serveur WebSphere® Liberty Profile commeserveur d'applications par défaut. Apache Tomcat n'est plus installé en tant queserveur d'applications par défaut, comme c'était le cas pour IBM Cognos TM1.

Remarque : dans IBM Planning Analytics 2.0.0, Performance Manager Hub ne peutêtre déployé que sur un autre serveur WebSphere Liberty Profile ; les autresversions de WebSphere ne sont pas prises en charge.

WebSphere Liberty Profile utilise les mêmes numéros de port par défaut que leserveur Apache Tomcat. Par exemple, le numéro de port par défaut 9300 estégalement utilisé pour WebSphere Liberty Profile.

Modifications apportées aux composants sélectionnablesdans l'assistant d'installation du serveur TM1

Dans l'assistant d'installation du serveur TM1, les groupes de serveursd'applications contenant les composants sélectionnables ont été renommés.v Groupe de serveurs d'applications TM1 a été renommé Niveau de données TM1.v Groupe de serveurs d'applications Web a été renommé Niveau Web TM1.v Niveau client TM1 et Groupe de serveurs développeur ont été fusionnés en

Niveau riche TM1.v Le composant Exemples a été déplacé sous Niveau de données TM1.

© Copyright IBM Corp. 2007, 2017 1

http://www.ibm.com/support/knowledgecenter/SSD29G/welcome

2 IBM Planning Analytics Version 2.0.0 - Installation et configuration

Chapitre 2. Planification de l'installation de Planning Analytics

La clé d'une installation réussie est la planification. Ce chapitre décrit les choix quivont faciliter le processus d'implémentation.

Lors de l'implémentation d'IBM Planning Analytics, déterminez la manière dontvous souhaitez l'installer et le configurer afin d'optimiser au maximum sesperformances. Les choix d'installation et de configuration effectués dépendent devos besoins, de vos ressources et de vos préférences.

Programmes d'installation disponiblesIBM Planning Analytics Local fournit un ensemble de programmes d'installationpour l'installation et la configuration des composants Planning Analytics sur dessystèmes d'exploitation différents et avec différents scénarios de déploiement.

Vous pouvez télécharger tous les programmes d'installation de Planning AnalyticsLocal à partir d'IBM Passport Advantage. Pour les instructions de téléchargement,voir Planning Analytics Local 2.0 (http://www.ibm.com/support/docview.wss?uid=swg24042732).

Les programmes d'installation et les composants installables sont organisés parsystème d'exploitation et par niveau dans l'architecture, pour permettre ledéploiement dans des environnements monopostes et multipostes.

Les programmes d'installation disponibles de Planning Analytics Local 2.0.0 sontdécrits ci-après.

Planning Analytics Local for Windows 32 bits

Comprend une collection de tous les composants Planning Analytics 32bits disponibles pour Microsoft Windows.

Utilisez ce programme d'installation pour installer tous les composants surun seul système Windows 32 bits, ou pour installer de façon sélective descomposants individuels, tels que Cognos TM1 Admin Server et CognosTM1 Server, sur des systèmes distincts Windows 32 bits.

Par défaut, ce programme installe automatiquement l'utilitaire IBM CognosConfiguration pour la gestion de Cognos TM1 Admin Server, de CognosTM1 Server et de Cognos TM1 Applications.

Planning Analytics Local for Windows 64 bits

Contient des composants 32 bits et 64 bits pour l'installation sur unsystème Microsoft Windows 64 bits.

Ce programme d'installation ne fonctionne que sur un système Windows64 bits.

Utilisez ce programme d'installation pour installer tous les composants surun seul système Windows 64 bits, ou pour installer de façon sélective descomposants individuels, tels que Cognos TM1 Admin Server et CognosTM1 Server, sur des systèmes distincts Windows 64 bits.


http://www.ibm.com/software/howtobuy/passportadvantage/paocustomer/sdma/SDMA?PO=DOWNLOAD_FIND_BY_PART_NUMBER

http://www.ibm.com/support/docview.wss?uid=swg24042732

Par défaut, ce programme installe automatiquement l'utilitaire IBM CognosConfiguration pour la gestion de Cognos TM1 Admin Server, de CognosTM1 Server et de Cognos TM1 Applications.

Planning Analytics Local Client-only

Contient uniquement les clients/interfaces utilisateur Cognos TM1standards et les fichiers de support d'API TM1 associés. Ces composants nesont disponibles qu'en version 32 bits.v Cognos TM1 Architectv Cognos TM1 Perspectivesv API Cognos TM1v Cognos TM1 Performance Modelerv Cognos Insight

Utilisez ce programme d'installation pour distribuer et installer les clientsCognos TM1 sur les ordinateurs des utilisateurs dans votre environnement.

Remarque : Vous pouvez aussi utiliser le programme d'installation duclient TM1 pour activer la génération de rapports IBM Cognos Analytics àpartir des sources de données Cognos TM1. L'utilisation du programmed'installation du client TM1 à cette fin installe les fichiers d'API CognosTM1 requis sur les serveurs Cognos Analytics qui exécutent des services degénération de rapports sous Microsoft Windows. Pour plus ded'informations, voir «Activation de la génération de rapports CognosAnalytics à partir de sources de données Cognos TM1», à la page 63.

Planning Analytics Workspace

Utilisez ce programme d'installation pour installer IBM Planning AnalyticsWorkspace dans le cadre de votre installation sur site d'IBM PlanningAnalytics Local. Planning Analytics Workspace est l'interface Web d'IBMPlanning Analytics.

Pour pouvoir installer IBM Planning Analytics Workspace, IBM PlanningAnalytics Local 2.0.0 ou une version ultérieure doit déjà être installé.

Pour des informations sur l'installation de Planning Analytics Workspace,voir Chapitre 12, «Planning Analytics Workspace installation», à la page163.

Planning Analytics for Microsoft Excel

Utilisez ce programme d'installation pour distribuer et installer PlanningAnalytics for Microsoft Excel.

Planning Analytics inclut des exemples que vous pouvez utiliser avec IBMPlanning Analytics for Microsoft Excel.

Planning Analytics for UNIX and Linux

Comprend uniquement les versions UNIX et Linux des composantsCognos TM1 suivants.v Cognos TM1 Admin Serverv Cognos TM1 Serverv Serveurs d'applications Cognos TM1 Web (Cognos TM1 Web, Cognos

TM1 Applications, Cognos TM1 Operations Console)


Utilisez le programme d'installation Cognos TM1 UNIX pour installer cescomposants sur les systèmes d'exploitation UNIX ou Linux pris en charge.Un programme d'installation distinct est disponible pour chacun de cessystèmes d'exploitation.

Par défaut, ce programme installe automatiquement l'utilitaire IBM CognosConfiguration pour la gestion de Cognos TM1 Admin Server et de CognosTM1 Server.

TM1 Package Connector for Business Intelligence

Programme d'installation facultatif.

Installe les composants qui permettent la connectivité d'IBM PlanningAnalytics aux packs IBM Cognos Analytics avec les sources de donnéesSAP Business Warehouse et autres sources de données relationnelles etODBC.

Composants disponiblesIBM Cognos TM1 inclut un ensemble de composants serveur et client destinés àl'administration, à la supervision, à la modélisation, à l'analyse et aux interactionsavec les données Cognos TM1.

Le programme d'installation organise les différents composants Cognos TM1 engroupes basés sur les niveaux de l'architecture. Vous pouvez installer différentescombinaisons de composants sur un ou plusieurs postes, selon vos besoinsspécifiques, votre système d'exploitation et votre environnement. Chaquecomposant requiert un système d'exploitation et un environnement logicielspécifique. Reportez-vous aux sections suivantes pour obtenir des informations surles composants d'installation.

Par défaut, IBM Planning Analytics utilise un serveur WebSphere ApplicationServer Liberty Profile comme serveur d'applications. Vous pouvez configurerPlanning Analytics pour qu'il fonctionne sur les autres serveurs d'applications prisen charge que vous utilisez actuellement dans votre environnement.

Composants de l'installation du niveau de données TM1Le niveau de données du programme d'installation d'IBM Cognos TM1 contient lescomposants fondamentaux tels que Cognos TM1 Admin et le serveur Cognos TM1.

Le tableau suivant contient la description et le système d'exploitationcorrespondant à chaque composant Cognos TM1 du niveau de données.

Chapitre 2. Planification de l'installation de Planning Analytics 5

Tableau 1. Configuration système requise pour les composants du niveau de données deCognos TM1

ComposantSystèmed'exploitation Description

TM1 Server Windows 32 bits

Windows 64 bits

UNIX 64 bits

Le serveur Cognos TM1 gère les demandesdes clients Cognos TM1. Il charge dans lamémoire le nom de tous les objetspermanents disponibles, tels que les cubes etles dimensions. Il répond aux demandes desclients en réalisant les calculs, lesconsolidations et les mises à jour requises.

Le serveur Cognos TM1 gère aussi lasécurité : il accorde ou refuse l'accès auxobjets de serveur et gère un journal desmodifications de la base de données.

Voir Chapitre 8, «Installation de CognosTM1 Server», à la page 77.

TM Admin Server Windows 32 bits

Windows 64 bits

UNIX 64 bits

Processus qui effectue le suivi de tous lesserveurs Cognos TM1 exécutés sur le réseau.Un serveur Admin fonctionne sur unserveur hôte Admin.

Au démarrage, le serveur Cognos TM1s'enregistre sur un serveur Admin exécutésur un hôte Admin spécifié.

Les clients Cognos TM1 consultent leserveur Admin pour déterminer quels sontles serveurs Cognos TM1 disponibles sur leréseau.

Voir Chapitre 8, «Installation de CognosTM1 Server», à la page 77.

Outils TM1 Les systèmesd'exploitation prisen charge varient enfonction des outils.

Contient les outils et les utilitaires suivants,destinés aux administrateurs, auxdéveloppeurs et aux modélisateurs CognosTM1 :

TIRunTI

TM1xfer

Voir Chapitre 17, «Installation des outilsCognos TM1», à la page 223.

Exemples Windows 32 bits

Windows 64 bits

UNIX 64 bits

Installe les bases de données d'exemples deCognos TM1 :

Chapitre 16, «Installation des bases dedonnées d'exemple de Cognos TM1», à lapage 211.

Composants de l'installation du niveau Web TM1Les composants d'installation du niveau Web TM1 ont besoin d'un serveurd'applications Web sur lequel s'exécuter. Par défaut, ils sont configurés pourfonctionner avec le serveur d'applications Web Java qui est fourni.


Le tableau suivant contient la description et le système d'exploitationcorrespondant à chaque composant Cognos TM1 du niveau Web TM1.

Tableau 2. Composants du niveau Web TM1


Cognos TM1Application Gateway

Windows 32 bits

Windows 64 bits

Composant Web Java qui fournit ladistribution des composants Cognos TM1Performance Modeler et Cognos Insight auxutilisateurs distants.

Ce composant est installé avec le composantCognos TM1 Application Server.

Voir Chapitre 11, «Installation de CognosTM1 Application Server», à la page 135.

TM1 ApplicationServer

Windows 32 bits

Windows 64 bits

Application Web Java constituant le supportprincipal d'IBM Cognos TM1 Applications.

Cognos TM1 Applications est utilisé pourconcevoir, déployer et exécuter desapplications gérées de planification etcontributives pour les données Cognos TM1.Ce composant interagit également avec lescomposants Cognos TM1 PerformanceModeler et Cognos Insight.

Ce composant nécessite un serveurd'applications Web Java et Java™ RuntimeEnvironment (JRE).

Vous pouvez utiliser le serveurd'applications WebSphere Liberty installépar défaut ou votre propre instance d'unserveur d'applications tel qu'IBM WebSphereApplication Server.

Un environnement JRE IBM estautomatiquement installé avec Cognos TM1Applications. Si vous utilisez un serveurd'applications, utilisez également lemodule JRE installé avec celui-ci.

Voir Chapitre 11, «Installation de CognosTM1 Application Server», à la page 135.

TM1 Web Windows 32 bits

Windows 64 bits

Composants serveur et client Web exécutéssur le serveur d'applications Web Javafourni.

Cognos TM1 Web permet aux utilisateurs dese connecter aux serveurs Cognos TM1 etd'interagir avec les données à l'aide de l'undes navigateurs Web pris en charge.

Voir Chapitre 10, «Installation de CognosTM1 Web», à la page 107.


Tableau 2. Composants du niveau Web TM1 (suite)


TM1 OperationsConsole

Windows 32 bits

Windows 64 bits

Application Web Java qui fournit auxadministrateurs de TM1 un outil Web leurpermettant de superviser l'activité duserveur Cognos TM1 et de réagir.

IBM Cognos TM1 Operations Console offreun moyen simple et efficace de comprendrecomment les serveurs Cognos TM1 et lescharges utilisateur fonctionnent.

Vous pouvez utiliser ce composant avec leserveur d'applications WebSphere Libertyinstallé par défaut ou avec votre propreinstallation d'un serveur d'applications prisen charge.

Un environnement JRE IBM estautomatiquement installé avec Cognos TM1sous Windows. Si vous utilisez un serveurd'applications, utilisez également lemodule JRE installé avec celui-ci.

Voir «Installation de Cognos TM1Operations Console à l'aide du logiciel deserveur Web WebSphere Liberty fourni», à lapage 97.

Composants de l'installation du niveau riche TM1Le niveau riche du programme d'installation d'IBM Cognos TM1 contient desoutils destinés aux utilisateurs, ainsi qu'un ensemble d'API Cognos TM1.

Le tableau suivant contient la description et le système d'exploitationcorrespondant à chaque composant Cognos TM1 du niveau riche.

Tableau 3. Composants du niveau riche


TM1 Architect Windows 32 bits Application de bureau Windows permettantd'administrer, de créer et de gérer desdonnées et des métadonnées sur desserveurs Cognos TM1 locaux et distants.

Voir «Installation de Cognos TM1 Architect», à la page 177.


Tableau 3. Composants du niveau riche (suite)


TM1 PerformanceModeler

Windows 32 bits Interface Eclipse de client enrichi Java,lancée depuis la page du portail CognosTM1 Applications.

Permet aux développeurs de générer desmodèles de planification et d'analyse dansl'environnement Cognos TM1.

Disponible sous forme de composantsélectionnable dans les programmesd'installation Windows Client-only ainsi que32 bits et 64 bits.

Par défaut, ce composant est disponible,mais n'est pas sélectionné dans lesprogrammes d'installation Windows 32 bitset 64 bits.

Voir «Installation de Cognos TM1Performance Modeler», à la page 178.

TM1 Perspectives Windows 32 bits Client complémentaire de Cognos TM1 pourMicrosoft Excel.

Permet d'utiliser les fonctions d'Excel poureffectuer des analyses complexes sur lesdonnées stockées sur un serveur CognosTM1. Il permet également de créer et degérer des objets et des données sur desserveurs Cognos TM1 locaux et à distance.

Voir «Installation de Cognos TM1Perspectives», à la page 175.

Cognos Insight Windows 32 bits Interface Eclipse de client enrichi Java, quipeut être démarrée de façon indépendante,ou depuis la page du portail de CognosTM1 Applications.

Disponible sous forme de composantsélectionnable dans les programmesd'installation Windows Client-only ainsi que32 bits et 64 bits.

Par défaut, ce composant est disponible,mais n'est pas sélectionné dans lesprogrammes d'installation Windows 32 bitset 64 bits.

Voir «Installation de Cognos Insight», à lapage 183.


Tableau 3. Composants du niveau riche (suite)


API TM1 Dépend de chaqueAPI.

Installe les fichiers qui permettent auxdéveloppeurs de travailler avec lesinterfaces de programmation d'applications(API) de Cognos TM1 suivantes.

API TM1 - Permet aux développeurs decréer des applications C, C++ et VBpersonnalisées qui interagissent avec TM1.

API TM1 Java - Permet aux développeursde créer des applications Java personnaliséesqui interagissent avec TM1.

API TM1 .NET - Permet aux développeursde créer des applications Microsoft .NETpersonnalisées qui interagissent avec TM1.

Voir «Installation des API de Cognos TM1»,à la page 188.

Composant pour l'installation de la documentation traduiteCe composant vous permet de sélectionner et d'installer la documentation traduitedes langues autres que l'anglais prises en charge par IBM Cognos TM1.

La documentation en anglais est toujours installée par défaut et ne peut pas êtredésélectionnée. Vous pouvez sélectionner ou désélectionner des languesspécifiques. Notez néanmoins que la durée d'installation augmente avec le nombrede langues sélectionnées.

Pour en savoir plus sur les langues prises en charge, voir «Codes de langueCognos TM1», à la page 87.

Les choix effectués pour la documentation n'affectent pas la langue des messageset de l'interface utilisateur :v Cette option n'affecte pas les messages émis par le logiciel, toujours installés

dans toutes les langues prises en charge.v Elle n'affecte pas la langue utilisée dans l'interface utilisateur de Cognos TM1,

qui est basée sur les paramètres du système d'exploitation de l'utilisateur. Pourobtenir des informations sur la configuration des langues, voir «Configurationde la langue de Cognos TM1», à la page 86.

Autres composants d'installation non répertoriésCertains composants ne sont pas répertoriés ou sélectionnables dans le programmed'installation.

Le tableau suivant contient la description et le système d'exploitationcorrespondant aux composants obligatoires qui ne sont ni listés, ni sélectionnablesdans le programme d'installation, mais qui sont installés par défaut avec d'autrescomposants sélectionnables.


Tableau 4. Autres composants Cognos TM1 non répertoriés dans l'assistant d'installation


Application defournisseur de basede données OLE TM1

Windows 32 bits

Windows 64 bits

Permet à un logiciel tiers d'extraire lesdonnées de cube du serveur Cognos TM1 àl'aide de requêtes MDX.

Différenciation de client TM1IBM Cognos TM1 fournit des clients multiples pour les développeurs, lesadministrateurs et les utilisateurs. La compréhension de ces clients et de leursdifférences peut vous aider à déterminer celui qui correspond le mieux à vosbesoins.

Tous les clients sont décrits en détails dans la documentation IBM Cognos TM1.v La documentation Planning Analytics for Microsoft Excel décrit la manière de

générer des rapports utilisant les sources de données d'IBM Cognos TM1 oud'IBM Cognos Analytics.

v La documentation TM1 Performance Modeler décrit les fonctions dedéveloppement et d'administration de Cognos TM1 Performance Modeler.

v La documentation TM1 Developer décrit les fonctions de développement etd'administration de Cognos TM1 Architect et Cognos TM1 Perspectives.

v La documentation TM1 Operation décrit le fonctionnement du serveur TM1 etl'utilisation de TM1 Operations pour surveiller des serveurs.

v La documentation TM1 Perspectives, TM1 Architect, and TM1 Web décrit lesfonctionnalités d'analyse accessibles à l'utilisateur de Cognos TM1 Architect,Cognos TM1 Perspectives et Cognos TM1 Web.

v La documentation TM1 Applications décrit les fonctionnalités d'analyseaccessibles à l'utilisateur de Cognos TM1 Application Web.

v La documentation Cognos Insight décrit les fonctionnalités d'analyse accessiblesà l'utilisateur de Cognos Insight.

Clients pour utilisateur finalVous pouvez utiliser plusieurs clients pour interagir avec les données IBM CognosTM1.

IBM Planning Analytics Workspace

IBM Planning Analytics Workspace est une interface Web pour IBM PlanningAnalytics. Elle vous permet de vous connecter aux données TM1, avecd'intéressants moyens de planifier, créer et analyser votre contenu.

Pour des informations sur l'installation de Planning Analytics Workspace, voirChapitre 12, «Planning Analytics Workspace installation», à la page 163.

IBM Planning Analytics for Microsoft Excel

IBM Planning Analytics for Microsoft Excel est destiné aux utilisateurs quitravaillent dans des environnements mondiaux en réseau. C'est le meilleur clientpour l'utilisateur qui utilise principalement Microsoft Excel pour analyser lesinformations TM1 et pour générer ses propres mises en page à l'aide des fonctionsMicrosoft Excel. Planning Analytics for Microsoft Excel est également utile pour les


utilisateurs qui doivent accéder à la fois aux données de Cognos TM1 et de CognosAnalytics depuis la même interface client Excel.

Planning Analytics for Microsoft Excel offre les avantages suivants :v Est optimisé pour réseau longue distance.v Fournit un environnement de feuille de calcul familier qui ne requiert pas un

niveau de connaissance d'Excel d'un utilisateur chevronné pour analyser etcontribuer aux données Cognos TM1.

v Associe les capacités de Microsoft Excel à une approche de glisser-déposer pouranalyser les cubes Cognos TM1.

v Fournit un mode flexible "basé sur les plages" dans le but d'ajouter des formatset des calculs d'utilisateur directement sur une feuille de calcul.

v Fournit un accès aux objets de données TM1, tels que les cubes, les vues, lessous-ensembles de dimension, les alias et les bacs à sable.

v Associe TM1 Planning basé sur Microsoft Excel en lecture/écriture à desanalyses en lecture seule par rapport à des sources de données Cognos Analyticsdans la même interface de feuille de calcul.

Pour plus d'informations, voir la documentation Planning Analytics for MicrosoftExcel.

IBM Cognos TM1 Application Web

IBM Cognos TM1 Application Web est un client Web sans déploiement qui permetd'ouvrir Cognos TM1 Applications à l'aide de n'importe quel navigateur Web prisen charge. A partir de la page de flux de travail Cognos TM1 Application Web,vous pouvez ouvrir un noeud, prendre possession, entrer des données etcontribuer à un plan. Cognos TM1 Application Web est utile lorsqu'une règled'entreprise interdit l'installation d'un client local ou en cas d'utilisation d'unsystème d'exploitation différent de Microsoft Windows.

IBM Cognos TM1 Web

IBM Cognos TM1 Web est un client Web sans déploiement que vous pouvezutiliser pour analyser et modifier des données Cognos TM1 via n'importe quelnavigateur Web pris en charge. Cognos TM1 Web ne permet pas d'accéder àla page de flux de travaux Cognos TM1 Application Web. Vous ne pouvez doncpas interagir dans Cognos TM1 Applications avec TM1 Web.

IBM Cognos Insight

IBM Cognos Insight est un client pour TM1 Application Web et un outil d'analysepersonnel qui permet d'analyser pratiquement tous les ensembles de données.Dans le cadre de Cognos TM1 Application Web, Cognos Insight est une applicationcliente, mise à disposition en local ou par téléchargement à distance. Lorsqu'elle estutilisée comme client pour Cognos TM1 Application Web, vous pouvez utiliser lemode Connecté et le mode Déconnecté de Cognos Insight.

Mode connecté

Le mode connecté permet de créer une connexion opérationnelle etbidirectionnelle avec le serveur Cognos TM1. Les données mises à jour surle serveur TM1 le sont alors également dans le client Insight lorsque vousprocédez à un recalcul dans Insight. Cela permet de s'assurer que lesdonnées du client Insight sont toujours à jour en cas d'analyse ou de


contribution à un plan. La connexion opérationnelle au serveur TM1implique toutefois un trafic plus important sur le réseau local et unecharge plus lourde sur le serveur TM1 qu'en mode Déconnecté.

Le mode Connecté est destiné aux utilisateurs qui disposent d'uneconnexion rapide au serveur TM1 et n'ont pas de problèmes de tempsd'attente de réseau.

Mode déconnecté

Le mode Déconnecté est disponible uniquement avec des noeuds deniveau enfant. Ce mode télécharge et crée une copie locale de la tranche deserveur Cognos TM1 (partie modèle et données TM1) avec laquelle voustravaillez. Cette approche répartit la charge de travail que le serveur TM1doit gérer dans n'importe quel autre mode de connexion. En effet, letraitement est réparti entre le client et le serveur TM1.

Le mode Déconnecté est destiné aux utilisateurs qui rencontrent desproblèmes de temps d'attente de réseau importants ou qui sontgéographiquement éloignés du serveur TM1. Lorsqu'un utilisateur ouvreCognos Insight en mode Déconnecté, la tranche modèle TM1 esttéléchargée et mise en cache. Toutes les interactions avec les données seproduisent au niveau du cache local, ce qui améliore les temps de réponse.

Clients d'administrationVous pouvez utiliser les clients d'administration d'IBM Cognos TM1 pouradministrer vos données et modèles Cognos TM1.

IBM Cognos TM1 Performance Modeler

IBM Cognos TM1 Performance Modeler est l'outil de modélisation Cognos TM1 leplus récent, qui permet de créer ou de générer des dimensions, des cubes, desrègles, des processus et d'autres objets. Performance Modeler simplifie le processusde modélisation en générant automatiquement les règles et les feeders requis pourvos applications. Performance Modeler introduit également l'importation guidée,processus simplifié pour l'importation des données et des métadonnées dans unserveur TM1. Il doit être utilisé en tant que principal outil de développement et demaintenance pour tous les modèles Cognos TM1 nouveaux et existants.

IBM Cognos TM1 Architect

IBM Cognos TM1 Architect est un outil de modélisation Cognos TM1 plus ancien,qui prend en charge la création et la maintenance de tous les objets TM1. TM1Architect ne prend pas en charge la génération automatique de feeders et derègles ; il ne dispose pas non plus de fonctions d'importation guidée. Il estconseillé aux utilisateurs d'Architect d'utiliser Cognos TM1 Performance Modeleren tant qu'environnement de développement principal pour tous les modèles TM1.

IBM Cognos TM1 Perspectives

IBM Cognos TM1 Perspectives constitue l'extension Excel TM1. Cognos TM1Perspectives peut être utilisé pour le développement de modèles Cognos TM1 etl'analyse de données avec les fonctionnalités Microsoft Excel. Tout comme CognosTM1 Architect, Perspectives prend en charge la création et la maintenance de tousles objets TM1, mais n'offre pas les fonctionnalités avancées de PerformanceModeler. Les utilisateurs qui ont besoin d'une interface d'extension Excel et desfonctions Microsoft Excel, telles que la représentation graphique des données de


TM1, peuvent utiliser Perspectives. Dans tous les autres cas, il est conseillé auxadministrateurs d'utiliser Performance Modeler en tant qu'environnement dedéveloppement principal pour tous les modèles TM1.

IBM Cognos TM1 Operations Console

IBM Cognos TM1 Operations Console est un outil Web conçu pour faciliter lasurveillance, la prise en charge et la gestion des serveurs Cognos TM1 auquotidien. Cognos TM1 Operations Console vous permet de surveiller les unitésd'exécution exécutées simultanément sur plusieurs serveurs TM1, de manièredynamique. Vous pouvez ainsi trier et filtrer l'activité des unités d'exécution etplanifier la consignation de l'activité des serveurs. Operations Console disposeégalement d'une fonction de diagnostic d'intégrité qui détermine l'état en cours dechaque serveur TM1 surveillé. Operations Console doit être l'interface de référencepour les administrateurs Cognos TM1 qui gèrent un environnement TM1d'entreprise.

Configuration logicielle requiseAvant d'installer les composants IBM Cognos TM1 serveur ou client, passez enrevue la configuration système requise et configurez les ressources de votreenvironnement, afin que les composants puissent fonctionner.

Passez en revue la liste à jour des environnements pris en charge par PlanningAnalytics, ainsi que les informations sur les systèmes d'exploitation, les correctifs,les serveurs Web et les navigateurs Web, à la page Software Environments for IBMPlanning Analytics 2.0 (http://www.ibm.com/support/docview.wss?uid=swg27049052).

Logiciels prérequis

Pour pouvoir être installé et utilisé, Cognos TM1 nécessite l'installation préalablede composants logiciels spécifiques.

Tableau 5. Composants tiers requis

Composant prérequis Description

Microsoft Excel Requis pour Cognos TM1 Perspectives.

Microsoft Visual C++ 2010Redistributable Package

Requis pour les installations Cognos TM1 sous MicrosoftWindows.

Microsoft .NET Framework Requis pour Cognos TM1 Perspectives et Cognos TM1Architect.

Téléchargez et installez ces composants sur le système cible avant d'installer lescomposants de Cognos TM1associés.

Valeurs d'installation par défautCette rubrique décrit l'ensemble des valeurs par défaut utilisées par l'installationIBM Cognos TM1.




L'installation Cognos TM1 utilise les valeurs de configuration par défautsuivantes :

Tableau 6. Valeurs par défaut de l'installation Cognos TM1

Elément Description et valeur par défaut

Répertoire d'installationpar défaut

Sur un système Microsoft Windows 32 bits :

C:\Program Files\IBM\Cognos\TM1

Sur un système Microsoft Windows 64 bits :

C:\Program Files\IBM\cognos\tm1_64

Numéro de port duserveur Admin

Numéro du port TCP/IP sur lequel le serveur Admin écoute lesdemandes de clients.

La valeur par défaut est 5495 (port non sécurisé).

Cette valeur est définie dans IBM Cognos Configuration.

Numéro de port SSL duserveur Admin

Numéro de port TCP/IP sur lequel tous les composants CognosTM1 communiquent avec Cognos TM1 Admin Server enutilisant SSL (Secure Socket Layer).

La valeur par défaut est 5498 (port sécurisé).

Cette valeur est définie dans IBM Cognos Configuration.

Numéro de port duserveur Cognos TM1

Port sur lequel s'exécute le serveur Cognos TM1. Ce paramètresert à distinguer les divers serveurs Cognos TM1 s'exécutant surle même ordinateur. Les valeurs de port acceptables vont de5000 à 49151.

La valeur par défaut est 12345.

Cette valeur est définie par le paramètre PortNumber du fichierde configuration du serveur Tm1s.cfg.

Numéro de port desmessages de clientCognos TM1

Ce numéro de port établit un port secondaire pour les messagesde progression du client utilisés quand une opération complexeattend d'être annulée.

Cette valeur est définie par le paramètreClientMessagePortNumber du fichier de configuration du serveurTm1s.cfg.

Par défaut, cette zone reste vide.

Par défaut, le numéro de port est affecté automatiquement etdynamiquement lorsque le serveur Cognos TM1 démarre. Iln'est pas nécessaire de définir un numéro spécifique pourClientMessagePortNumber, à moins que le pare-feu ou un autreélément du réseau n'exige que le numéro port d'écoute soitconnu à l'avance.

ATTENTION :Si vous choisissez d'affecter une valeur spécifique auparamètre ClientMessagePortNumber, au lieu de conserver sonaffectation dynamique, vous devez affecter des numérosuniques à tous les ports des messages client et serveur deCognos TM1 que vous utilisez. Si deux serveurs utilisant lemême numéro de port sont exécutés sur le même ordinateur,l'activité de messages peut entraîner un conflit ou un blocagedu système.


Tableau 6. Valeurs par défaut de l'installation Cognos TM1 (suite)


Nom d'hôte du serveurAdmin

Nom d'ordinateur ou adresse IP de l'hôte d'administration surlequel est exécutée une instance de Cognos TM1 Admin Server.

Par défaut, cette zone reste vide et la valeur utilisée estlocalhost, qui représente l'ordinateur sur lequel s'effectuel'installation.

Cette valeur est définie par le paramètre AdminHost dans lesfichiers de configuration Tm1s.cfg et Tm1p.cfg.

Nom des serveursd'exemple de CognosTM1

Exemple Planning Analytics

PlanSamp

SData

GO_New_Stores

PData

Proven_Techniques

GO_scorecards

24Retail

Données d'identification :

Nom d'utilisateur : admin

Mot de passe : apple

Numéros de port pardéfaut des exemples deserveur

PlanSamp - Port 12354

SData - Port 8010

GO_New_Stores - Port 5010

PData - Port 8011

Proven_Techniques - Port 5011

GO_scorecards - Port 44312

24Retail - Port 8004

Vous pouvez modifier le numéro de port d'un serveur en éditantla valeur HTTPPortNumber dans le fichier tm1s.cfg. Pour plusd'informations, voir «HTTPPortNumber», à la page 331.

Répertoire de donnéespar défaut des serveursd'exemple Cognos TM1

C:\Program Files\IBM\cognos\tm1\samples\tm1\PlanSamp

C:\Program Files\IBM\cognos\tm1\samples\tm1\SData

C:\Program Files\IBM\cognos\tm1\samples\tm1\GO_New_Stores

C:\Program Files\IBM\cognos\tm1\samples\tm1\PData

C:\Program Files\IBM\cognos\tm1\samples\tm1\Proven_Techniques

C:\Program Files\IBM\cognos\tm1\samples\tm1\GO_scorecards

C:\Program Files\IBM\cognos\tm1\samples\tm1\24Retail


Tableau 6. Valeurs par défaut de l'installation Cognos TM1 (suite)


Mode de sécurité Une installation standard utilise l'authentification Cognos TM1.Dans ce mode, le serveur Cognos TM1 réclame aux utilisateursun nom et un mot de passe lorsqu'ils se connectent auxcomposants Cognos TM1.

Présentation de la configurationAprès avoir installé IBM Cognos TM1, servez-vous de l'outil Cognos Configurationet les paramètres du fichier de configuration de Cognos TM1 pour optimiser lesperformances du programme.

Cognos Configuration et Cognos TM1L'outil IBM Cognos Configuration sert à démarrer, arrêter, configurer et enregistrerle paramétrage des serveurs IBM Cognos TM1.

Utilisez Cognos Configuration pour gérer les tâches et les composants suivants :

Tableau 7. Tâches de Cognos Configuration

Composant/tâche Résultat

Cognos TM1 Admin Server Démarrer et arrêter le serveur.

Cognos TM1 Server Démarrer, arrêter et ajouter des serveurs Cognos TM1.

Cognos TM1 ApplicationServer

Démarrer et arrêter le serveur d'applications Web WebSphereLiberty fourni qui prend en charge les composants suivants :

v IBM Cognos TM1 Web

v IBM Cognos TM1 Applications

v IBM Cognos TM1 Operations Console

Si vous utilisez votre propre installation de Tomcat ou unautre serveur d'applications Web, configurez et exécutezCognos TM1 Application Server hors de CognosConfiguration.

Enregistrement des donnéesde configuration

Lorsque vous sauvegardez les paramètres de configurationdans l'outil Cognos Configuration, celui-ci :

v Vérifie la configuration

v Crée des informations cryptographiques

v Vérifie l'intégrité des données chiffrées

v Enregistre la configuration des serveurs Cognos TM1

v Sauvegarde les fichiers de configuration

v Enregistre les paramètres de configuration

v Met à jour le fichier de configuration de Tomcat

Création de fichiers WARpour le déploiement

Si vous souhaitez déployer Cognos TM1 Application Serveravec votre propre serveur d'applications Web, utilisezCognos Configuration pour créer le fichier d'application Webrequis (WAR).

Dans Cognos Configuration, cliquez sur Actions > Générerdes fichiers d'application.


Fichiers de configuration et paramètres de Cognos TM1IBM Cognos TM1 utilise un ensemble de fichiers et de paramètres de configurationpour commander le comportement des composants client et serveur.

Tableau 8. Récapitulatif des options de configuration de différents composants Cognos TM1

Configuration Description

Fichier Tm1s.cfg Configuration du serveur Cognos TM1

Voir Annexe A, «Fichier de configuration du serveur tm1s.cfg», à la page 311.

Fichier Tm1p.ini Configuration des clients Cognos TM1 Architect et CognosTM1 Perspectives

Voir Annexe B, «Fichier de configuration du client Tm1p.ini»,à la page 377.

Cognos TM1 Web

Fichier tm1web_config.xml

Configuration et paramètres de Cognos TM1 Web

Voir «Modification des paramètres de configuration de CognosTM1 Web», à la page 113.

Cognos TM1 Applications

pmpsvc_config.xml

fpmsvc_config.xml

Fichiers de configuration de Cognos TM1 Applications

Les paramètres du client sont stockés dans le fichierpmpsvc_config.xml.

Les paramètres du serveur sont stockés dans le fichierfpmsvc_config.xml.

Voir Chapitre 11, «Installation de Cognos TM1 ApplicationServer», à la page 135 et «Sauvegarde des données CognosTM1 Applications», à la page 301.

Cognos TM1 OperationsConsole

Configuration de Cognos TM1 Operations Console

Voir «Installation de Cognos TM1 Operations Console à l'aidedu logiciel de serveur Web WebSphere Liberty fourni», à lapage 97.

Comptes utilisateur pour l'exécution des services Cognos TM1 sousWindows

Lorsque vous utilisez IBM Cognos Configuration pour lancer Cognos TM1 AdminServer et Cognos TM1 Server, ceux-ci sont enregistrés pour s'exécuter en tant queservices Windows sous le compte système local prédéfini de Microsoft Windows.Vous devez modifier manuellement ces services pour qu'ils s'exécutent sous uncompte utilisateur spécifique.

Remarque : Si Cognos TM1 Server requiert un accès à des sources de donnéesexternes via ODBC ou ODBO, vous devez le modifier manuellement pour qu'il soitexécuté sous un compte utilisateur ayant accès à ces sources de données.

Exécution des services Cognos TM1 sous un compte utilisateurWindows spécifique

Par défaut, Cognos Configuration enregistre les services Cognos TM1 suivantspour qu'ils s'exécutent sous le compte système local de Microsoft Windows :v Cognos TM1 Admin Server


v Cognos TM1 Server

Important : Modifiez ces services Cognos TM1 pour qu'ils s'exécutent sous uncompte utilisateur spécifique sous Microsoft Windows.

Pour obtenir des informations sur la manière de modifier le compte utilisé par uncomposant Cognos TM1 s'exécutant en tant que service Windows, voir«Modification des services Cognos TM1 en vue de leur fonctionnement sous uncompte utilisateur spécifique sous Windows», à la page 79.

Après avoir effectué ces modifications, vous serez toujours en mesure d'utiliserCognos Configuration pour démarrer et arrêter ces services.

Privilèges requis pour un compte utilisateur Windows spécifique

Le compte utilisateur destiné à exécuter les services Cognos TM1 sous Windowsdoit être inclus dans le groupe des propriétaires de la base de données pouraccéder aux vues et aux tables SQL.

Il doit par ailleurs détenir les privilèges suivants sur l'ordinateur local :

Remarque : Toutes ces propriétés ne sont pas disponibles dans l'ensemble desversions de Windows, par exemple Windows Server 2008 R2 et les versionssuivantes. Reportez-vous à la documentation Microsoft Windows pour connaîtreles propriétés actuellement disponibles.v Agir comme partie intégrante du système d'exploitationv Outrepasser le contrôle de parcoursv Augmenter les quotas (Ajuster les quotas de mémoire d'un processus)v Remplacer un jeton de processusv Ouvrir une session en tant que servicev Posséder les droits en lecture et en écriture sur l'élément du registre Windows

Utilisez les fonctions Paramètres de sécurité et Stratégie de groupe de MicrosoftWindows pour configurer ces privilèges de sécurité. Par exemple, dans MicrosoftWindows 7, cliquez sur Outils d'administration > Stratégie de sécurité locale,puis cliquez pour développer Paramètres de sécurité > Stratégies locales >Attribution des droits utilisateur.

Pour définir les droits en lecture et en écriture pour le registre Windows, utilisezl'Éditeur du registre Windows.

Installation de TM1 sur des réseaux sans domaineSi vous installez IBM Cognos TM1 sur un réseau qui n'utilise pas de contrôleur dedomaine, vous pouvez configurer vos services Cognos TM1 pour qu'ils utilisentdes comptes locaux.

Pour en savoir plus sur la configuration des services Cognos TM1, voir«Modification des services Cognos TM1 en vue de leur fonctionnement sous uncompte utilisateur spécifique sous Windows», à la page 79.

Si vous utilisez un ou plusieurs comptes locaux pour vos services Cognos TM1,veillez à ce que ces comptes aient les privilèges suivants sur leurs ordinateurslocaux :


v Agir comme partie intégrante du système d'exploitationv Outrepasser le contrôle de parcoursv Augmenter les quotasv Remplacer un jeton de processusv Ouvrir une session en tant que service

Si vous définissez des partages de fichiers dans votre réseau Windows pour lesutiliser avec les composants Cognos TM1, veillez à ce que chaque compte local quevous définissez pour l'exécution d'un service Cognos TM1 ait accès à ces partages.

Remarque : Si vous réalisez l'installation sur un ordinateur ne participant pas à undomaine Microsoft Windows, vous ne pouvez pas utiliser la connexion intégrée.

Syntaxe de la machine localeN'utilisez pas le point (.) comme abréviation pour représenter le domaine del'ordinateur local lorsque vous spécifiez les paramètres de connexion.

Vous devez entrer le nom de l'ordinateur explicitement. En effet, dans certainesconfigurations, l'utilisation de la syntaxe ".\username" peut entraîner desproblèmes graves.


Chapitre 3. Architecture

Pour comprendre l'architecture des principaux composants d'IBM Cognos TM1,vous devez être familiarisé avec l'infrastructure informatique et les besoins métierdes personnes de votre entreprise qui vont utiliser IBM Cognos TM1.

Pour plus de détails sur l'authentification à la connexion et la sécurité descommunications Cognos TM1, voir «Sécurité authentifiée», à la page 225.

Architecture de Cognos TM1IBM Cognos TM1 utilise une architecture client-serveur répartie constituée duserveur IBM Cognos TM1 auquel différents clients peuvent se connecter.

Cognos TM1 est doté des interfaces et des clients suivants :v Cognos TM1 Perspectivesv Cognos TM1 Architectv Client Cognos TM1 Webv Portail et flux de travaux de Cognos TM1 Application (avec Cognos TM1

Application Server)v Cognos TM1 Performance Modelerv Cognos Insight

Dans cet environnement, les données d'entreprise résident sur des serveursdistants, accessibles aux clients disposant des droits appropriés. Selon laconfiguration du système, les clients peuvent accéder à un ou plusieurs serveursTM1 distants pour obtenir différents types de données. Les clients Cognos TM1sont décrits en détail dans IBM Cognos TM1 Perspectives, TM1 Architect, and TM1Web.

Figure 1. Représentation de haut niveau de l'architecture client-serveur de Cognos TM1 dansson ensemble


Clients de bureau Windows

TM1 Perspectives et TM1 Architect peuvent se connecter à un serveur IBM CognosTM1 local, qui sert de référentiel pour les données TM1 privées. Si vous disposezdes droits d'accès corrects, vous pouvez copier des données d'un serveur distantsur votre serveur local en les répliquant, et ensuite synchroniser vos mises à jouravec le serveur distant.

TM1 Perspectives, TM1 Architect, TM1 Client sont les clients TM1 standard. Dansun environnement LAN ou WAN normal, ces clients communiquent tous avec unserveur distant à l'aide du protocole réseau TCP/IP.

Présentation de Cognos TM1 Admin ServerLe serveur Admin d'IBM Cognos TM1 est un processus qui effectue le suivi detous les serveurs Cognos TM1 exécutés sur un réseau. Un serveur Admin tournesur un ordinateur appelé hôte Admin.

Au démarrage, le serveur Cognos TM1 s'enregistre sur un serveur Admin exécutésur un hôte Admin spécifié. Les clients TM1 consultent le serveur Admin pourdéterminer quels sont les serveurs Cognos TM1 disponibles sur le réseau.

Le serveur Admin gère les informations suivantes pour chaque serveur CognosTM1 disponible :v Nom du serveurv Adresse IPv Protocolev Numéro de port

Toutes ces informations sont fournies par le serveur Cognos TM1 quand ils'enregistre sur le serveur Admin.

Un serveur Cognos TM1 ne peut démarrer que si un serveur Admin est en cours.Si vous avez spécifié un hôte Admin dans le fichier Tm1s.cfg ou sur la ligne decommande du serveur, le serveur Cognos TM1 tentera de se connecter à unserveur Admin sur cet hôte. Le serveur Cognos TM1 ne sera pas lancé si, pourquelque raison que ce soit, il ne peut pas se connecter au serveur Admin.

Si vous n'avez pas spécifié d'hôte Admin, le serveur Cognos TM1 tentera de seconnecter à un serveur Admin sur la machine locale. Si aucun serveur Admin n'esten cours d'exécution sur la machine locale, le serveur Cognos TM1 démarrera unnouveau serveur Admin et s'y connectera.

Le serveur Admin détecte les serveurs Cognos TM1 du réseau en se mettant àl'écoute des notifications envoyées par les serveurs. En général, le serveur CognosTM1 notifie sa présence à un intervalle régulier qui est, par défaut, de 60 secondes.Lorsque le serveur Admin détecte le serveur Cognos TM1, ce dernier est enregistréet devient disponible pour les clients du réseau. Toutefois, si le serveur Admin nedétecte pas la présence d'un serveur Cognos TM1 enregistré dans un délai égal àtrois fois l'intervalle de notification de présence, ce serveur Cognos TM1 estsupprimé de la liste des serveurs disponibles sur le réseau. Par conséquent, leserveur Cognos TM1 cesse d'être disponible pour les clients du réseau.

Par défaut, le serveur Admin utilise le port 5495. Si ce port est déjà utilisé, unnouveau numéro de port peut être affecté en créant un nouveau service appelé


Tm1admsrv. Toutes les applications Cognos TM1 cherchent un service appeléTm1admsrv et, le cas échéant, utilisent le numéro de port qui lui est affecté. Si ceservice n'existe pas, les applications Cognos TM1 utilisent le port 5495.

Présentation de Cognos TM1 ServerIBM Cognos TM1 Server gère l'accès au répertoire de données de Cognos TM1pour les clients Cognos TM1.

La figure ci-dessous illustre les opérations d'un serveur Cognos TM1 distant. Cesopérations sont décrites dans le texte qui suit.

v Au démarrage, le serveur distant charge les dimensions et cubes du répertoirede données dans la mémoire RAM de l'ordinateur serveur. En même temps, leserveur ouvre un nouveau journal des transactions nommé Tm1s.log dans lerépertoire de données. Une fois les cubes chargés, le serveur distant estdisponible.

v Le serveur Cognos TM1 distant s'enregistre sur un ou plusieurs serveurs Adminpour permettre aux clients de se connecter au serveur Cognos TM1 distant.

v Les applications client contactent les serveurs Admin pour repérer les serveursCognos TM1 disponibles. Les clients se connectent ensuite aux serveurs CognosTM1 dont ils veulent utiliser les données.

v Les clients modifient les données de cube et renvoient les valeurs au serveurCognos TM1.

v A mesure que les nouvelles valeurs sont reçues des clients, le serveur CognosTM1 écrit les enregistrements dans le fichier journal Tm1s.log, en opérant unsuivi de chaque modification, avec la date et l'heure associées, et l'ID du clientayant apporté la modification.

v A mesure que le serveur calcule de nouvelles valeurs en réponse à desdemandes des clients, il les stocke en mémoire, ce qui augmente la quantité demémoire utilisée par le serveur.

v Quand le serveur s'arrête, tous les enregistrements du fichier Tm1s.log sontenregistrés sur disque et le fichier journal des transactions est renommé. Lenouveau nom est généré à l'aide de la date et de l'heure courantes. Le fichier

Figure 2. Fonctionnement d'un serveur distant

Chapitre 3. Architecture 23

Tm1s.log est enregistré dans le répertoire de données du serveur poursauvegarder les transactions de données. Pour plus de détails, voir la rubrique"Restauration des enregistrements du journal des transactions" dans IBM CognosTM1 Operations.Si le serveur est arrêté intentionnellement sans enregistrer les modifications, lefichier journal est enregistré avec l'heure/date et l'extension est changée à .rej.Vous pouvez traiter le fichier Tm1saaaammjjhhmmss.rej à l'aide deTurboIntegrator pour récupérer les transactions.

v Pour enregistrer tous les changements de données sur un serveur Cognos TM1sans arrêter le serveur, cliquez avec le bouton droit de la souris dansl'explorateur de serveur et cliquez sur Enregistrer les données. Tous lesenregistrements du fichier Tm1s.log sont écrits sur disque immédiatement, lefichier des transactions est renommé avec l'ajout de la date et de l'heurecourantes et un nouveau fichier Tm1s.log est créé pour accepter lesmodifications futures des valeurs de cubes.Les modifications apportées aux métadonnées, telles que définitions dedimensions et de cubes, sont enregistrées immédiatement sur disque. Lesmodifications apportées aux métadonnées ne sont pas écrites dans le fichierjournal des transactions.

Présentation des fichiers de Cognos TM1IBM Cognos TM1 requiert de nombreux fichiers objet et système, la plupart étantstockés dans le répertoire de données du serveur Cognos TM1.

Certains sont installés avec le produit, d'autres sont générés pour chaquedimension et cube que vous créez. D'autres fichiers sont générés par Cognos TM1pour stocker des métadonnées, par exemple les informations de sécurité.

Le tableau suivant contient une liste des fichiers qui définissent les cubes, lesdimensions et d'autres objets Cognos TM1. Ces fichiers se trouvent dans lerépertoire de données, décrit plus loin dans cette section.

Tableau 9. Fichiers définissant des cubes, des dimensions et d'autres objets

Extension de fichier Description

.blb Fichier de formatage de cube

.cho Fichier de définition de tâche

.cub Fichier de base de données de cube

.dim Dimension compilée

.dit Fichier source de dimension en format ASCII

.pro Fichier de définition de processus TurboIntegrator

.rux Règle compilée

.sub Sous-ensemble de dimension

.tbu Source ASCII pour fichier de vues


Tableau 9. Fichiers définissant des cubes, des dimensions et d'autres objets (suite)

Extension de fichier Description

.tqu Requête enregistrée

.tru Source ASCII pour fichier de règles

.vue Vue enregistrée

.xdi Feuille de dimension Excel.

.xru Feuille de règles Excel

Présentation du répertoire de donnéesLe répertoire de données contient les cubes, dimensions et informations systèmechargés en mémoire lors du démarrage d'un serveur Cognos TM1. Quand vousaccédez à un serveur à partir d'un client Cognos TM1, Cognos TM1 lit les donnéesdu répertoire de données de ce serveur.

Lors de l'exécution de Cognos TM1, les modifications de valeurs de cube sontstockées immédiatement en mémoire et dans le journal de transactions (Tm1s.log).Cognos TM1 réenregistre ensuite les données dans le répertoire de données quandl'un des événements suivants se produit :v Le serveur Cognos TM1 est arrêté.v Un administrateur clique à l'aide du bouton droit sur une icône de serveur dans

l'explorateur de serveur et choisit Enregistrer les données dans le menucontextuel. Cognos TM1 enregistre alors les modifications sur le serveursélectionné.

v Un administrateur choisit l'option Fichier, Enregistrer toutes les données dansl'explorateur de serveur. Cognos TM1 enregistre alors les modifications sur tousles serveurs connectés, si vous disposez des droits d'accès appropriés.

v Un utilisateur enregistre les mises à jour par lots.

Choisissez le chemin de votre répertoire de données lors de l'installation deCognos TM1.

Tableau 10. Chemins par défaut des répertoires de données

Répertoire de données Chemin par défaut

Serveur local Cognos TM1 répertoire d'installation\custom\tm1data\pdata

Serveur Windows Cognos TM1 distant pourles données d'exemple

répertoire d'installation\custom\tm1data\sdata

Serveur UNIX CognosTM1 répertoire d'installation/custom/tm1data/sdata

Accès réseau requisLa capacité d'un client à enregistrer des données est déterminée par le système desécurité IBM Cognos TM1.


Pour plus d'informations, voir IBM Cognos TM1 Developer.

Important : Faites en sorte que ce répertoire ne soit visible qu'aux administrateurset au nom de connexion utilisé par le serveur lui-même.

Plusieurs répertoires de donnéesVous pouvez définir l'utilisation de plusieurs répertoires de données dans IBMCognos TM1 en séparant les noms de répertoire par un point-virgule. Lorsquevous spécifiez plusieurs répertoires de données, Cognos TM1 opère comme suit.v Accède aux cubes et aux dimensions de chaque répertoire spécifié. Si un objet

est en double, Cognos TM1 y accède depuis le premier répertoire spécifié.v Ecrit les modifications dans le répertoire où se trouve l'objet. Lorsqu'un nouvel

objet est créé, Cognos TM1 écrit dans le premier répertoire que vous avezspécifié.

Par exemple, supposons que vous veuillez stocker des dimensions dans lerépertoire tm1dims et des cubes dans le répertoire tm1cubes. Vous spécifiez alorsce qui suit dans le fichier Tm1s.cfg :DatabaseDirectory="c:\tm1dims;c:\tm1cubes"

En concaténant les deux répertoires, vous pouvez accéder à ces objets à l'aide del'explorateur de serveur comme s'ils se trouvaient à un seul emplacement.

Remarque : Vous ne pouvez pas stocker les fichiers .cub et .rux dans desrépertoires de données distincts. Chaque fichier .rux doit être placé dans le mêmerépertoire que le fichier .cub auquel il est associé. Dans le cas contraire, les règlesne sont pas chargées correctement.

Emplacement du répertoire de donnéesVous spécifiez l'emplacement du répertoire de données en fonction du type deserveur, local ou distant.v Pour un serveur local, vous spécifiez l'emplacement du répertoire de données en

nommant ce répertoire à l'aide du paramètre DataBaseDirectory du fichierTm1p.ini.Vous pouvez modifier le fichier .ini à l'aide du menu Options d'IBM CognosTM1 dans l'explorateur de serveur.Pour plus d'informations, voir Annexe B, «Fichier de configuration du clientTm1p.ini», à la page 377.

v Pour un serveur distant, vous spécifiez l'emplacement du répertoire de donnéesà l'aide du paramètre DatabaseDirectory dans le fichier Tm1s.cfg ou duparamètre de ligne de commande -d quand vous démarrez le serveur.

Pour des informations sur les paramètres de serveur, voir Annexe A, «Fichier deconfiguration du serveur tm1s.cfg», à la page 311.

Un serveur distant doit pouvoir reconnaître l'unité sur laquelle réside le répertoirede données. Si ce dernier se trouve sur une unité distante, vous devez le mapperavec une lettre correspondant à une unité locale.

Conseil : Il n'est pas nécessaire, lorsque vous accédez à un serveur distant, de lemapper avec l'unité sur laquelle réside le répertoire de données du serveur.

Si vous ne spécifiez pas l'emplacement du répertoire de données, le serveurCognos TM1 ne peut pas démarrer et le message d'erreur suivant est affiché.


Data Directory not specified. Aborting server startup.

Architecture de Cognos TM1 WebIBM Cognos TM1 Web utilise une architecture multiniveau qui permet auxutilisateurs d'accéder aux données Cognos TM1 et d'interagir avec elles à partir den'importe quel navigateur Web compatible.

L'architecture multiniveau IBM Cognos TM1 Web inclut les niveaux client Web,serveur d'applications Web et composant de données.

Niveau 1 : Clients Web

Le groupe de serveurs Web Client permet aux utilisateurs d'accéder aux donnéesCognos TM1 et d'interagir avec elles à partir de n'importe quel navigateur Webcompatible. Les utilisateurs peuvent utiliser des cubes et des feuilles Web CognosTM1.

Pour connaître les navigateurs Web actuellement pris en charge, visitez la pageSoftware Environments for IBM Planning Analytics 2.0 (http://www.ibm.com/support/docview.wss?uid=swg27049052).

Niveau 2 : Serveur d'applications Web

Cognos TM1 Web s'exécute sur un serveur d'applications Web Java.

Ce niveau fournit le support de la conversion et de l'affichage des feuilles de calculMicrosoft Excel en tant que feuilles Web Cognos TM1. Il réexporte aussi les feuillesWeb vers les formats Microsoft Excel et PDF.

Figure 3. Diagramme de vue d'ensemble de l'architecture de Cognos TM1 Web



Niveau 3 : Données

Ce niveau comporte le serveur Admin Cognos TM1 et au moins une instance deCognos TM1 Server.

Serveur IBM Cognos TM1 Admin

Le serveur Admin Cognos TM1 peut être installé sur tout ordinateur devotre réseau local (LAN), mais il doit résider sur le même segment duréseau que le serveur Cognos TM1. Généralement, le serveur Cognos TM1et le serveur Admin Cognos TM1 sont installés sur le même ordinateur.

Serveur IBM Cognos TM1

Le serveur Cognos TM1 peut être installé sur l'ordinateur qui hébergevotre serveur Web, mais il est plus efficace de l'installer sur un ordinateurdistinct.

La version du serveur Cognos TM1 utilisée dans votre environnementCognos TM1 Web doit être identique ou plus récente que la version deCognos TM1 Web qui est exécutée. Si la version de Cognos TM1 Webexécutée est plus récente que la version du serveur Cognos TM1, uneerreur est générée lorsque les utilisateurs tentent de se connecter à CognosTM1 Web.

Accès à plusieurs serveurs Cognos TM1 depuis Cognos TM1Web

IBM Cognos TM1 Web prend en charge plusieurs bases de données, ce qui permetaux utilisateurs d'accéder à plusieurs serveurs Cognos TM1 enregistrés sur lemême serveur Admin Cognos TM1 et sur lequel les utilisateurs ont la mêmecombinaison de nom d'utilisateur et de mot de passe.

Quand vous vous connectez, Cognos TM1 Web affiche la sous-fenêtre denavigation du serveur principal que vous avez sélectionné dans l'écran deconnexion. Cependant, si votre combinaison de nom d'utilisateur et de mot depasse est identique à celle d'autres serveurs Cognos TM1 enregistrés sous le mêmeserveur Admin Cognos TM1, IBM Cognos TM1 Web vous connecteautomatiquement à ces autres serveurs en fonction des besoins. Ce comportementdiffère de celui de Cognos TM1 Architect et de Cognos TM1 Perspectives, où vousdevez vous connecter aux autres serveurs Cognos TM1 manuellement au coursd'une étape distincte.

La prise en charge de plusieurs bases de données concerne particulièrement lesfeuilles Web car elles peuvent contenir plusieurs formules et références CognosTM1 pointant vers d'autres serveurs Cognos TM1. Par exemple, si vous ouvrez unefeuille Web contenant des références Cognos TM1 à un autre serveur enregistrésous le même serveur Admin, Cognos TM1 Web tente de vous connecter à cetautre serveur en utilisant votre nom d'utilisateur et votre mot de passe en cours.

Limitation de l'accès à un serveur Cognos TM1 unique à partirde Cognos TM1 Web

Si vous souhaitez empêcher les utilisateurs d'IBM Cognos TM1 Web d'utiliser lafonction d'accès multibase pour accéder à d'autres serveurs Cognos TM1 sur lemême serveur Admin, vous pouvez enregistrer chaque serveur Cognos TM1 surun serveur Admin distinct.


Par exemple, avec cette configuration, si vous vous connectez à Cognos TM1 Webet si vous tentez d'ouvrir une feuille Web référençant un serveur Cognos TM1enregistré sous un serveur Admin différent, les données ne seront pas affichées,même si vous avez le même nom d'utilisateur et le même mot de passe sur ceserveur.

Conseil : Si vous configurez vos serveurs Cognos TM1 pour qu'ils s'exécutent surdes serveurs Admin distincts, mais si vous souhaitez y accéder à partir de CognosTM1 Web, Cognos TM1 Architect, ou Cognos TM1 Perspectives , vous pouvezutiliser le paramètre AdminHost. Ce paramètre vous permet de spécifier plusieurshôtes Admin, autorisant ainsi les utilisateurs à accéder à tous les serveurs CognosTM1 enregistrés sur les serveurs Admin des hôtes spécifiés.v Pour plus d'informations sur la configuration d'IBM Cognos TM1 Web en vue de

l'accès à plusieurs serveurs Admin, reportez-vous à la rubrique "Configurationde la page de connexion à l'aide des paramètres AdminHostName etTM1ServerName" dans le document IBM Cognos TM1 Operation.

v Pour plus d'informations sur la configuration de Cognos TM1 Architect et deCognos TM1 Perspectives en vue de l'accès à plusieurs serveurs Admin, voir«Définition de plusieurs hôtes Admin pour Cognos TM1», à la page 92.

Architecture de Cognos TM1 ApplicationsIBM Cognos TM1 Applications est doté d'une architecture composée de troisniveaux : clients Web, serveurs d'applications Web, et données.

Le diagramme suivant représente l'architecture multiniveau et les chemins decommunication de base de l'ensemble des composants de Cognos TM1Applications.

Figure 4. Diagramme de vue d'ensemble de l'architecture de Cognos TM1 Applications


Les lignes du diagramme de l'architecture de Cognos TM1 Applicationsreprésentent les chemins de communication généralement requis pour les tâchesgérées par le serveur d'applications Cognos TM1, telles que le suivi des états desflux de travaux.

Outre ces chemins de communication, Cognos TM1 Performance Modeler etCognos Insight nécessitent également une connexion directe et permanente auserveur Cognos TM1 sous-jacent. L'utilisation de Cognos Insight en mode réparticonstitue une exception et ne nécessite pas de connexion permanente à CognosTM1 Server.

Cognos TM1 Applications - Niveau 1 : Clients WebLe groupe de serveurs Web Client contient toutes les interfaces utilisateur d'IBMCognos TM1 Applications. Ces interfaces sont employées par les utilisateurs, lesadministrateurs et les développeurs d'applications de planification.


Le principal client de Cognos TM1 Applications est une interface Web basée sur unnavigateur et prise en charge par un serveur d'applications Web Java, tel quel'installation fournie de WebSphere Liberty. Les interfaces utilisateur de CognosTM1 Applications sont organisées en deux pages secondaires et trois clients decontribution de données.

Page Cognos TM1 Applications

La page Cognos TM1 Applications (portail) constitue le point de départprincipal de l'administrateur et des autres utilisateurs. Elle fournit la listedes applications disponibles, filtrées en fonction de l'utilisateur en cours. Sivous cliquez sur une application dans cette page, la page des flux detravaux s'ouvre.

Les administrateurs et les développeurs d'applications peuvent égalementouvrir Cognos TM1 Performance Modeler et Cognos Insight à partir de labarre d'outils de Cognos TM1 Applications.

Page Cognos TM1 Application

La page Cognos TM1 Application (page de flux de travaux) vous permetde gérer des tâches au sein d'une seule application. Ce client affiche tousles noeuds pour lesquels un utilisateur est chargé des contributions et/oudes approbations dans un plan spécifique. Selon la façon dont vous avezconfiguré l'application, l'utilisateur peut ouvrir le client Cognos Insightclient ou Cognos TM1 Application Web pour chacun des noeudsaccessibles dans ce client.

Clients de contribution de données

Le tableau suivant récapitule les clients de contribution de données deCognos TM1 Applications qui permettent aux utilisateurs d'utiliser lesdonnées dans des formats de grille et des formats graphiques.

Tableau 11. Cognos TM1 Applications - Clients de contribution de données

Client Description

IBM Cognos TM1Application Web

Client par défaut. Le traitement des données se fait en tempsréel avec le serveur. Permet aux utilisateurs d'afficher et d'éditerles données d'application dans un format de grille en utilisantles vues de cube Cognos TM1 ou les feuilles Web TM1 ens'appuyant sur l'infrastructure de Cognos TM1 Web.


Tableau 11. Cognos TM1 Applications - Clients de contribution de données (suite)

Client Description

IBM Cognos Insight -Connected

Client IBM Cognos Insight. Le traitement des données se fait entemps réel avec le serveur. Permet aux utilisateurs d'afficher etd'éditer les données d'application dans le format d'un tableaude bord ou d'un espace de travail.

Ce client peut être distribué et installé depuis Cognos TM1Application Gateway, ou installé à distance par unadministrateur système à l'aide d'une ligne de commandeWindows Installer ou d'un autre outil de gestion de logiciel.

IBM Cognos Insight -Distributed

Client IBM Cognos Insight avec traitement local des données.Les données ne sont mises à jour sur le serveur que lors desactions de validation des données.

Options de distribution de logiciels et d'installation identiques àcelles du client Cognos Insight - Connecté.

Cognos TM1 Performance Modeler

Le client Cognos TM1 Performance Modeler fournit l'interface utilisateurpermettant aux administrateurs et aux développeurs de créer et de déployer desapplications.

Cette interface utilisateur doit être installée localement sur l'ordinateur del'utilisateur. Les utilisateurs peuvent recevoir et installer ce client à partir deCognos TM1 Application Gateway la première fois qu'ils ouvrent le client. Lesadministrateurs système peuvent aussi diffuser et installer le programme à distancepar à l'aide de Windows Installer ou d'un autre outil de gestion de logiciel. Pourplus d'informations, voir «Installation de Cognos TM1 Performance Modeler», à lapage 178.

Cognos Insight

Cognos Insight peut être exécuté indépendamment de Cognos TM1 Applicationspour permettre aux utilisateurs de créer des espaces de travail utilisables dans uneapplication.

Cette interface utilisateur doit être installée localement sur l'ordinateur del'utilisateur. Elle peut être reçue à partir de Cognos TM1 Application Gateway, etinstallée par les utilisateurs la première fois qu'ils ouvrent le client. Lesadministrateurs système peuvent aussi diffuser et installer le programme à distancepar à l'aide d'une ligne de commande Windows Installer ou d'un autre outil degestion de logiciel. Pour plus d'informations, voir «Installation de Cognos Insight»,à la page 183.

Cognos TM1 Applications - Niveau 2 : Serveur WebLe niveau des serveurs Web contient le serveur d'applications Web Java requis.

Serveur d'applications Web Java

Les composants suivants nécessitent un serveur d'applications Web Java. Vouspouvez utiliser la version de WebSphere Liberty fournie avec l'installation, ou votrepropre installation de l'un des serveurs d'applications Web Java pris en charge.


Cognos TM1 Application ServerApplication Web Java constituant le support principal d'IBM Cognos TM1Applications.

Cognos TM1 Application GatewayComposant Web Java qui fournit la distribution des composants CognosTM1 Performance Modeler et Cognos Insight aux utilisateurs distants.

Client Cognos TM1 Application WebInterface utilisateur facultative basée sur la technologie Cognos TM1 Webpour l'affichage et l'édition des données d'application. Les fichiers de priseen charge de cette option s'exécutent sur le même serveur d'applicationsWeb.

Utilisation de la sécurité et du serveur Web fourni par CognosAnalytics

Si vous utilisez Cognos TM1 Applications avec une instance de Cognos TM1Server qui met en oeuvre la sécurité IBM Cognos, vous pouvez déployer CognosTM1 Application Server avec le serveur Web WebSphere Liberty fourni avec IBMCognos. Pour plus d'informations, voir «Utilisation de Cognos TM1 Applicationsavec la sécurité Cognos», à la page 266.

Cognos TM1 Applications - Niveau 3 : DonnéesLe niveau données d'IBM Cognos TM1 Applications contient le serveur AdminIBM Cognos TM1 et un ou plusieurs serveurs IBM Cognos TM1 exécutés sur unsystème Microsoft Windows ou UNIX. Cognos TM1 Application Server et lesinterfaces client associées communiquent avec les composants de la couchedonnées pour accéder aux données Cognos TM1.

Cognos TM1 Admin Server

Le serveur Admin TM1 est un processus qui contrôle tous les serveurs TM1exécutés sur un réseau. Cognos TM1 Application Server communique avec leserveur Admin Cognos TM1 pour déterminer quels serveurs Cognos TM1 sontdisponibles sur le réseau.

Cognos TM1 Server

Cognos TM1 Server contient les données des applications que vous générez etdéployez à l'aide de Cognos TM1 Applications.


Chapitre 4. Déploiement

Cette section décrit quelques-uns des scénarios d'installation et de déploiementclassiques des composants IBM Cognos TM1 disponibles. Utilisez-la lors de laplanification et de la configuration de Cognos TM1 dans des environnementsinformatiques différents et pour optimiser ses performances.

Vous pouvez installer et déployer des composants sur un ordinateur individuel, ousur plusieurs ordinateurs dans un environnement en réseau.

Pour chaque composant que vous souhaitez installer sur un ordinateur différent,exécutez l'assistant d'installation Cognos TM1 sur cet ordinateur.

Composants serveur

Vous pouvez installer les composants serveur suivants sur des ordinateurs dédiésdistinct :v Cognos TM1 Admin Server et Cognos TM1 Serverv Cognos TM1 Webv Cognos TM1 Application Server

Composants client

Vous pouvez installer les composants client suivants sur plusieurs ordinateurs :v Cognos TM1 Perspectivesv Cognos TM1 Architectv Cognos TM1 Performance Modelerv Cognos Insight

Déploiement de Cognos TM1 sur un seul ordinateur WindowsL'installation des composants IBM Cognos TM1 sur un ordinateur MicrosoftWindows est particulièrement adaptée aux activités de preuve de concept, de test,de démonstration, de développement et aux environnements de formation.

Vous pouvez utiliser le programme d'installation de Cognos TM1 pour Windows32 bits ou 64 bits.

L'installation monoposte sous Windows est principalement conçue pour unutilisateur unique sur l'un des systèmes d'exploitation Windows 32 bits ou 64 bitspris en charge. Par exemple, Microsoft Windows XP, Windows Vista ou Windows7. Toutefois, ces systèmes d'exploitation ne sont pas de la classe serveur, et ne sontpas destinés à un environnement de production. Ce type de déploiement doit êtreréservé aux utilisations individuelles, et évité dans les environnements deproduction avec plusieurs utilisateurs.

Installation monoposte standard

Une installation monoposte standard de Cognos TM1 sous Windows comprend lescomposants suivants :


Niveau de données TM1

v Cognos TM1 Serverv Cognos TM1 Admin Serverv Outils Cognos TM1v Echantillons TM1

Niveau Web TM1

v TM1 Application Gatewayv TM1 Application Serverv TM1 Webv Cognos Access Manager

Niveau riche TM1

v TM1 Architectv Performance Modelerv TM1 Perspectivesv Cognos Insightv API TM1

Vous pouvez choisir les composants à installer en fonction de vos besoinsspécifiques.

Différences entre le déploiement des installations 64 bits et 32bits

Les composants TM1 ne sont pas tous disponibles pour les systèmes 64 bits. Si lecomposant est disponible en version 64 bits, son répertoire d'installation par défautest différent de celui d'une installation 32 bits.

Déploiement de Cognos TM1 Admin Server et de TM1 ServerVous pouvez installer les composants IBM Cognos TM1 Admin Server et CognosTM1 Server sur des ordinateurs Microsoft Windows et UNIX distincts dans votreréseau.

Pour chaque composant que vous souhaitez installer sur un ordinateur différent,exécutez l'assistant d'installation Cognos TM1 sur cet ordinateur.

Vous pouvez installer Cognos TM1 Admin Server sur le même ordinateur queCognos TM1 Server, ou sur un autre ordinateur de votre réseau.

Lorsque le serveur Cognos TM1 est exécuté, il s'inscrit sur le serveurd'administration indiqué. Les clients Cognos TM1 se connectent au serveur Adminpour obtenir des renseignements sur les serveurs Cognos TM1 disponibles sur leréseau.

Si vous répartissez les composants serveur sur l'ensemble de votre réseau, vousdevez être en possession de certaines informations sur les machines sur lesquellesles composants seront installés et la configuration de ces composants. La listesuivante donne des informations sur ce que vous devez savoir pour installerchaque composant.


Tableau 12. Installation des composants serveur de Cognos TM1

Composant Description

Cognos TM1 Server Pour installer et configurer le serveur Cognos TM1, vous devezconnaître le nom de l'ordinateur sur lequel le serveurd'administration de Cognos TM1 est exécuté.

Cognos TM1 AdminServer

Celui-ci peut être installé sans connaissance de la topologie duréseau.

Remarques importantes sur les installations réparties

Les services Cognos TM1 doivent être exécutés sur des ordinateurs ayant lesmêmes paramètres régionaux. Vous ne pouvez pas, par exemple, installer certainsservices sur un ordinateur dont le paramètre de langue est l'anglais, et d'autres surun ordinateur dont le paramètre de langue est l'allemand. Définissez ce paramètreen sélectionnant l'option Normes et Formats dans le menu Démarrer, Paramètresrégionaux de Microsoft Windows.

Déploiement de Cognos TM1 WebEn fonction de vos besoins, vous pouvez déployer IBM Cognos TM1 Web dedifférentes manières.

Le mode de déploiement de Cognos TM1 Web dépend de la façon dont vousprévoyez d'utiliser le composant. Les scénarios de déploiement classiques sont lessuivants :v En tant qu'interface Web principale permettant aux utilisateurs d'accéder aux

données Cognos TM1 à partir d'un navigateur Web.Pour plus d'informations, voir Chapitre 10, «Installation de Cognos TM1 Web», àla page 107.

v En vue de la prise en charge du client IBM Cognos TM1 Application Web dansIBM Cognos TM1 Applications.Le client Cognos TM1 Application Web s'appuie sur l'infrastructure de CognosTM1 Web. Pour plus d'informations, voir «Architecture de Cognos TM1Applications», à la page 29 et Chapitre 11, «Installation de Cognos TM1Application Server», à la page 135.

v Pour la prise en charge de l'intégration avec les composants IBM CognosAnalytics, tels que les portlets de visualisation et les iWidgets Cognos TM1.Pour plus d'informations, voir «iWidgets Cognos TM1 et Cognos Workspace», àla page 64.

Déploiement de Cognos TM1 ApplicationsSelon votre environnement réseau et vos besoins métier, vous pouvez installer IBMCognos TM1 Applications sur un seul ordinateur ou répartir les composants surdifférents ordinateurs d'un réseau.

Chapitre 4. Déploiement 35

Considérations relatives à la sécurité lors de l'utilisation deCognos TM1 Applications

Vous pouvez choisir l'authentification de sécurité standard d'IBM Cognos TM1 oula sécurité IBM Cognos pour les serveurs Cognos TM1 utilisés avec Cognos TM1Applications.

N'utilisez pas des modes d'authentification de sécurité différents pour une mêmeinstallation de Cognos TM1 Applications.

Déterminez le mode de sécurité avant de configurer l'utilisation d'un serveurCognos TM1 dans Cognos TM1 Applications, et d'utiliser le même mode desécurité pour les serveurs que vous ajoutez.

Pour plus d'informations sur l'utilisation de la sécurité Cognos, reportez-vous à lasection «Utilisation de Cognos TM1 Applications avec la sécurité Cognos», à lapage 266.

Utilisation du paramètre IntegratedSecurityMode avec CognosTM1 Applications

Pour définir le mode d'authentification de sécurité de Cognos TM1, utilisez leparamètre IntegratedSecurityMode dans le fichier Tm1s.cfg de chaque serveurCognos TM1 à utiliser.

Important : Le composant Cognos TM1 Applications est compatible uniquementavec les modes d'authentification de sécurité 1 et 5 de Cognos TM1.

Par exemple, pour utiliser l'authentification de sécurité standard de Cognos TM1,affectez la valeur 1 au paramètre IntegratedSecurityMode pour chaque serveur.

IntegratedSecurityMode=1

Pour utiliser la sécurité IBM Cognos, affectez la valeur 5 au paramètreIntegratedSecurityMode.


Pour plus d'informations sur le paramètre IntegratedSecurityMode, reportez-vous àla section relative à la configuration du système TM1 dans le document IBMCognos TM1 Operations.

Si le paramètre IntegratedSecurityMode=5 est utilisé pour IBM Cognos TM1Server et IBM Cognos TM1 Applications, il est impossible d'affecter des droits auxgroupes TM1 natifs dans la boîte de dialogue Gérer les droits. Seuls les groupesCognos importés dans le serveur TM1 sont disponibles. Cela signifie qu'il estimpossible d'utiliser des groupes TM1 et Cognos en parallèle car SecMode restreintles groupes utilisables.

Configuration de la sécurité de Cognos TM1 Applications en vuede l'utilisation de plusieurs serveurs Cognos TM1

Si vous souhaitez exécuter plusieurs serveurs Cognos TM1 avec Cognos TM1Applications, ceux-ci doivent tous être configurés avec le même moded'authentification de sécurité (soit l'authentification standard de Cognos TM1, soit


la sécurité Cognos). Ils doivent en outre avoir le même nom d'utilisateur et lemême mot de passe de connexion de l'administrateur.

Pour plus de détails, voir «Configuration de Cognos TM1 Application Web en vuede l'utilisation de plusieurs serveurs Cognos TM1», à la page 155.

Déploiement de tous les composants Cognos TM1Applications sur un seul ordinateur

Il est possible, à des fins de développement, de test ou de démonstration,d'installer tous les composants nécessaires à IBM Cognos TM1 Applications sur unmême ordinateur sous Microsoft Windows.

Programme d'installation

Le déploiement de Cognos TM1 Applications sur un seul ordinateur est laméthode la plus rapide pour faire fonctionner le programme.

Vous pouvez utiliser la version 32 bits ou 64 bits pour Windows du programmed'installation de Cognos TM1 pour installer Cognos TM1 Applications sur unordinateur Windows unique.

Composants Cognos TM1 requis

Les composants suivants sont nécessaires pour déployer et exécuter Cognos TM1Applications sur un ordinateur Windows unique.v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos TM1 Application Serverv Cognos TM1 Application Gatewayv Cognos TM1 Webv Bases de données Samples (facultatives) de Cognos TM1 - Permettent d'exécuter

facilement un modèle de serveur Cognos TM1 à des fins de test.

Par défaut, l'outil Cognos Configuration est nécessaire et installé automatiquementavec cette configuration. Une fois l'installation terminée, vous utilisez CognosConfiguration pour déployer et démarrer le serveur d'applications Cognos TM1 etgérer les serveurs Cognos TM1.

Une version du serveur d'applications Web WebSphere Liberty est égalementautomatiquement installée en vue de son utilisation avec Cognos TM1Applications.

Cognos TM1 Web doit être installé si vous prévoyez d'utiliser le client Web deCognos TM1 Applications.

Serveurs d'applications Web obligatoires

Cognos TM1 Applications fait appel à un serveur d'applications Web Java.

Vous choisir l'une des solutions suivantes pour déployer Cognos TM1 Applicationssur un serveur d'applications Web Java :v Utiliser la version d'IBM WebSphere Liberty fournie avec l'installation.v Utiliser votre propre instance d'Apache Tomcat


v Utiliser votre propre instance d'IBM Websphere Liberty

Déploiement des composants d'IBM Cognos TM1 Applicationssur des ordinateurs distincts

Le déploiement de l'ensemble ou d'une partie des composants IBM Cognos TM1Applications sur des ordinateurs dédiés séparés peut améliorer leurs performances,leur disponibilité et leur capacité.

Selon votre environnement réseau et vos besoins métier, vous pouvez distribuer leniveau Web TM1 et le niveau de données TM1 sur plusieurs ordinateurs et demanières différentes.

Déploiement du niveau Web TM1 et du niveau de données TM1sur des ordinateurs distincts

Selon cette configuration, les serveurs d'applications Web Java de Cognos TM1Applications et d'IBM Cognos TM1 Web sont installés sur un même ordinateur,mais le niveau de données TM1 (serveur Cognos TM1) se trouve sur un ordinateurdifférent.

Déploiement des serveurs d'applications Web sur desordinateurs distincts

Dans cette configuration, le serveur d'application Web Java de Cognos TM1Applications et de Cognos TM1 Web sont sur des ordinateurs séparés. Le niveaude données TM1 peut également être installé sur l'un de ces ordinateurs, ou sur unordinateur dédié.

Déploiement de tous les composants sur des ordinateursdistincts

Dans cette configuration, les serveurs d'application Web Java de Cognos TM1Applications et de Cognos TM1 Web, ainsi que les serveurs Cognos TM1 Admin etCognos TM1 sont tous installés sur des ordinateurs distincts.

Liste de contrôle pour le déploiement de Cognos TM1Applications

Aidez-vous de la liste de vérification suivante pour installer les composants deIBM Cognos TM1 Application Server et les composants associés sur desordinateurs distincts.

Tableau 13. Scénarios d'installation pour le déploiement d'IBM Cognos TM1 Applications

Scénario d'installation Etapes de l'installation

Exécution groupée de toutes lesapplications Web Java sur despostes distincts

Utilisez le programme d'installation de Cognos TM1 pourinstaller Cognos TM1 Application Server, Cognos TM1Application Gateway et Cognos TM1 Web sur la machinequi exécute le serveur d'applications Web Java.

Exécution de Cognos TM1 Websur un ordinateur distinct

Utilisez la programme d'installation de Cognos TM1 pourinstaller Cognos TM1 Web sur un ordinateur distinct.

L'assistant installe les fichiers requis pour le client CognosTM1 Application Web - l'une des interfaces client pourl'affichage et l'édition des données d'application.


Tableau 13. Scénarios d'installation pour le déploiement d'IBM Cognos TM1Applications (suite)

Scénario d'installation Etapes de l'installation

Exécution du niveau dedonnées TM1 sur un ordinateurdistinct

Utilisez le programme d'installation de TM1 pour installerles composants de TM1 Admin Server et de TM1 Serversur cet ordinateur.

Pour en savoir davantage, voir «Déploiement de CognosTM1 Admin Server et de TM1 Server», à la page 34

Déploiement des applications client Cognos TM1Cette section explique comment déployer les différents clients (interfacesutilisateur) IBM Cognos TM1 de votre environnement réseau.

Les clients Cognos TM1 sont les suivants :v Cognos TM1 Perspectivesv Cognos TM1 Architectv Cognos TM1 Performance Modelerv Cognos TM1 Web (par une URL ou un lien Web)v Cognos TM1 Applications (par une URL ou un lien Web)v Cognos Insight


Chapitre 5. Mise à niveau

La mise à niveau d'une version antérieure d'IBM Cognos TM1 vers la dernièreversion doit être considérée comme un processus à effectuer étape par étape.

Considérez la mise à niveau comme un projet informatique nécessitant uneplanification soigneuse, un délai adéquat et des ressources.

Mise à niveau depuis Planning Analytics version 2.0.0

La mise à niveau depuis Planning Analytics version 2.0.0 vers la version 2.0.x nerequiert pas de désinstallation. Vous pouvez installer la version 2.0.x directementsur la version 2.0.0.

Pour plus d'informations, voir «Mise à niveau depuis Planning Analytics version2.0.0», à la page 44.

Mise à niveau de Planning Analytics for Microsoft Excel

La mise à niveau d'IBM Planning Analytics for Microsoft Excel requiert unedésinstallation manuelle complète, puis une installation complète de la nouvelleversion.

Pour plus d'informations, voir «Mise à niveau de Planning Analytics for MicrosoftExcel», à la page 44.

Mise à niveau depuis TM1 10.2.x

La mise à niveau depuis Cognos TM1 version 10.2.x requiert une désinstallationmanuelle complète, puis une installation complète de la nouvelle version.

Pour plus d'informations, voir «Mise à niveau à partir de Cognos TM1 version10.2.x», à la page 45.

Mise à niveau depuis TM1 10.1.x

La mise à niveau depuis Cognos TM1 version 10.1 ou 10.1.1 requiert unedésinstallation manuelle complète, puis une installation complète de la nouvelleversion.

Une des différences principales entre les versions 10.1.x et 10.2.x est la nécessité dedisposer d'un serveur d'applications Web pour Cognos TM1 Web. A partir de laversion 10.2.0, Cognos TM1 Web n'utilise plus Microsoft Internet InformationServices (IIS), mais un serveur d'applications Web Java tel que la version fourniede WebSphere Liberty.

Pour plus d'informations, voir «Mise à niveau de Cognos TM1 version 10.1.x», à lapage 46.


Mise à niveau depuis TM1 9.x

La mise à niveau depuis Cognos TM1 version 9.0.x, 9.1.x ou 9.5.x requiert unedésinstallation manuelle complète, puis une installation complète de la nouvelleversion.

Remarque : les bases de données TM1 9.0.x et 9.1.x sont automatiquementconverties au format Unicode lorsqu'elles sont ouvertes (démarrées) avec unserveur TM1 de version 9.4 ou supérieure. Une ancienne base de données TM1convertie au format Unicode ne peut plus être ouverte dans les versionsantérieures de TM1.

Pour plus d'informations, voir «Mise à niveau à partir de Cognos TM1 version 9.x», à la page 47.

Processus de la mise à niveau

Lorsque vous réalisez une mise à niveau, vous effectuez plusieurs actionsdistinctes :1. L'arrêt de tous les services associés.2. La sauvegarde des données existantes et des applications.3. La suppression de la version antérieure du produit.4. L'installation de la dernière version du produit.5. La restauration des données, des paramètres de configuration et des

applications avec la dernière version du produit.

Planification de la mise à niveauLa procédure de mise à niveau d'une installation IBM Planning Analytics existantedépend des composants Cognos TM1 que vous utilisez et que vous avez déployés.

Des étapes supplémentaires sont requises si vous mettez également à niveau uneversion précédente de Cognos TM1 Contributor vers Cognos TM1 Applications.

Avant la mise à niveau

Prenez connaissance des informations suivantes avant d'effectuer la mise à niveau.

Cognos TM1 Admin ServerA partir d'IBM Cognos TM1 version 10.1.0, le fichier de configuration duserveur Admin TM1, Tm1admsrv.ini, n'est plus utilisé ni pris en charge parCognos TM1. Vous devez utiliser Cognos Configuration pour configurerCognos TM1 Admin Server.

Cognos TM1 Server

v Les bases de données TM1 9.0.x et 9.1.x sont automatiquementconverties au format Unicode lorsqu'elles sont ouvertes (démarrées) avecun serveur Cognos TM1 de version 9.4 ou supérieure. Une ancienne basede données TM1 convertie au format Unicode ne peut plus être ouvertedans les versions antérieures de TM1.

v Dans IBM Cognos TM1 version 10.1.0, vous pouvez utiliser CognosConfiguration pour démarrer, arrêter et gérer vos serveurs Cognos TM1.

Cognos TM1 WebA partir de la version 10.2.0 d'IBM Cognos TM1, Cognos TM1 Webs'exécute sur un serveur d'applications Web Java, tel que la version de


WebSphere Liberty fournie. Cognos TM1 Web versions 10.2.0 et suivantesn'utilisent pas Microsoft .NET Framework et n'en ont donc pas besoin.v A partir de la version 10.2.0, le répertoire d'installation par défaut de

Cognos TM1 Web est passé de C:\inetpub\wwwroot\TM1Web à<installation TM1>\tm1web.

v Cognos TM1 Web versions 10.2.0 et suivantes utilisent un nouveaufichier de configuration nommé tm1web_config.xml. Ce fichier remplacele fichier web.config des versions précédentes de Cognos TM1 Web. Lenouveau fichier contient une partie des anciens paramètres, car lesparamètres associés à Microsoft .NET Framework ont été retirés.L'emplacement du nouveau fichier de configuration est :<installation TM1>\webapps\tm1web\web-inf\configuration

Pour réutiliser des paramètres de votre ancien fichier de configurationde Cognos TM1 Web, vous pouvez sélectionner et fusionner lesparamètres de l'ancien fichier Web.config dans le nouveau fichiertm1web_config.xml.

v Certaines étapes de la configuration des différents types ded'authentification et de sécurité de la transmission des données ontchangé dans TM1 Web.


v Avertissement : Vous devrez éditer vos applications en place dansCognos TM1 Performance Modeler s'ils mettent en oeuvre les fonctionssuivantes :– Les sous-ensembles dynamiques ne sont pas utilisables en tant que

hiérarchie d'approbation dans Cognos TM1 Applications.– Les applications ne peuvent pas partager des cubes d'approbation

dans Cognos TM1 Applications.v Une version du serveur d'applications Web WebSphere Liberty est

installée avec la nouvelle version de Cognos TM1. Cette instance deWebSphere Liberty peut être utilisée pour exécuter le logiciel CognosTM1 Applications et le gérer à l'aide de Cognos Configuration.

v Si vous prévoyez d'utiliser Cognos TM1 Applications sans que MicrosoftExcel ne soit installé sur le serveur Web sur lequel vous exécutez CognosTM1 Web, vous devez définir de façon explicite le paramètreExcelWebPublishEnabled avec la valeur True (T) dans le fichier deconfiguration tm1s.cfg des serveurs Cognos TM1. Les versionprécédentes de Cognos TM1 Contributor ne nécessitaient pas ladéfinition de ce paramètre.

Sauvegarde des données existantes

Avant d'effectuer la mise à niveau, assurez-vous d'avoir sauvegardé les donnéesexistantes, les applications et les fichiers de configuration dans un emplacementsécurisé. Selon l'architecture du réseau et le déploiement de Cognos TM1, lesdonnées Cognos TM1 peuvent résider sur des ordinateurs différents. Répertoriezles emplacements des données et créez un plan de sauvegarde.

Les fichiers suivants doivent être sauvegardés :v Fichiers de configuration de Cognos TM1 Admin Serverv Fichiers de base de données et de configuration de Cognos TM1 Serverv Fichiers de configuration du serveur et fichiers personnalisés de Cognos TM1

Web

Chapitre 5. Mise à niveau 43

v Fichiers de configuration du client Cognos TM1 Architectv Fichiers de configuration du client Cognos TM1 Perspectivesv Fichiers de configuration et d'application de Cognos TM1 Contributor

Mise à niveau depuis Planning Analytics version 2.0.0Lorsque vous procédez à la mise à niveau depuis Planning Analytics version 2.0.0Local vers IBM Planning Analytics version 2.0.x Local, il n'est pas nécessaire dedésinstaller la version précédente. Vous pouvez installer IBM Planning Analyticsversion 2.0.x directement sur la version 2.0.0.

Pour plus d'informations sur l'installation de la version actuelle, reportez-vous auxrubriques ci-après, en fonction de votre environnement informatique et descomposants Cognos TM1 à installer.v Chapitre 7, «Installation monoposte de Planning Analytics», à la page 67v Chapitre 8, «Installation de Cognos TM1 Server», à la page 77v Chapitre 10, «Installation de Cognos TM1 Web», à la page 107v Chapitre 11, «Installation de Cognos TM1 Application Server», à la page 135v Chapitre 14, «Installation du niveau riche TM1», à la page 175v «Installation de Cognos TM1 Operations Console à l'aide du logiciel de serveur

Web WebSphere Liberty fourni», à la page 97

Mise à niveau de Planning Analytics for Microsoft ExcelLorsque vous mettez à niveau IBM Planning Analytics for Microsoft Excel, vousdevez désinstaller la version précédente, puis installer la version en cours. Vous nepouvez pas installer Planning Analytics for Microsoft Excel directement sur laversion précédente.

Avant de commencer

Sauvegardez les fichiers de données et de configuration existants avant dedésinstaller la version précédente.

Procédure1. Fermez toutes les fenêtres Microsoft Excel.2. Sauvegardez les fichiers de données et de configuration existants.3. Désinstallez la version précédente de Planning Analytics for Microsoft Excel.

Pour plus de détails, voir «Désinstallation d'IBM Planning Analytics forMicrosoft Excel», à la page 199.

4. Téléchargez et extrayez le programme d'installation.5. Installez la nouvelle version de Planning Analytics for Microsoft Excel. Pour

plus de détails, voir «Installation d'IBM Planning Analytics for Microsoft Excel», à la page 198.


Mise à niveau à partir de Cognos TM1 version 10.2.xPour mettre à niveau IBM Cognos TM1 version 10.2.x vers IBM Planning Analyticsversion 2.0.0, vous devez désinstaller la version précédente, puis installer laversion en cours. Vous ne pouvez pas installer IBM Planning Analytics version2.0.0 directement sur la version 10.2.x. Prévoyez également de sauvegarder lesdonnées et les fichiers de configuration existants avant de désinstaller l'ancienneversion.

Pourquoi et quand exécuter cette tâche

La procédure ci-après contient les instructions de mise à niveau de Cognos TM1 dela version 10.2.x à la version actuelle.

Procédure1. Sauvegardez les données et les fichiers de configuration existants.

Sauvegardez les données et les fichiers de configuration existants dans unemplacement sécurisé pour tous les ordinateurs sur lesquels des composantsCognos TM1 ont été installés. Pour plus de détails, voir les rubriquessuivantes :v «Sauvegarde des données et des fichiers de configuration de Cognos TM1», à

la page 297v «Sauvegarde des données Cognos TM1 Applications», à la page 301

2. Désinstallez tous les composants Cognos TM1 :Si l'ancienne version de Cognos TM1 a été installée dans un environnementréparti, vous devez désinstaller les composants TM1 sur chaque ordinateur.v «Désinstallation d'IBM Planning Analytics», à la page 299v «Désinstallation et déploiement de Cognos TM1 Applications», à la page 301

3. Installez la dernière version d'IBM Cognos TM1 :Reportez-vous aux rubriques suivantes, en fonction de votre environnementinformatique et des composants Cognos TM1 à installer.v Chapitre 7, «Installation monoposte de Planning Analytics», à la page 67v Chapitre 8, «Installation de Cognos TM1 Server», à la page 77v Chapitre 10, «Installation de Cognos TM1 Web», à la page 107v Chapitre 11, «Installation de Cognos TM1 Application Server», à la page 135v Chapitre 14, «Installation du niveau riche TM1», à la page 175v «Installation de Cognos TM1 Operations Console à l'aide du logiciel de

serveur Web WebSphere Liberty fourni», à la page 974. Après l'installation de la nouvelle version de Cognos TM1 Applications, effacez

le cache du navigateur Web. Si vous ne le faites pas, le navigateur risque demélanger des fichiers de l'ancienne et de la nouvelle version de Cognos TM1Applications.

5. Restaurez les données et les fichiers de configuration précédents de CognosTM1 :Selon les composants à installer, mettez à jour les données et les fichiers deconfiguration précédents sur les postes.v «Restauration des fichiers de données et de configuration dans IBM Planning

Analytics version 2.0.0», à la page 305v «Restauration des fichiers de configuration et d'application dans Cognos TM1

Applications», à la page 307


Mise à niveau de Cognos TM1 version 10.1.xPour mettre à niveau IBM Cognos TM1 version 10.1.x vers IBM Planning Analyticsversion 2.0.0, vous devez désinstaller la version précédente, puis installer laversion en cours. Vous ne pouvez pas installer IBM Planning Analytics version2.0.0 directement sur Cognos TM1 version 10.1.x. Prévoyez également desauvegarder les données et les fichiers de configuration existants avant dedésinstaller l'ancienne version.

Avant de commencer

Consultez les informations de la rubrique «Planification de la mise à niveau», à lapage 42.

Une des différences principales entre les versions 10.1.x et 10.2.x est la nécessité dedisposer d'un serveur d'applications Web pour Cognos TM1 Web. Cognos TM1Web version 10.2.x n'utilise plus Microsoft Internet Information Services (IIS), maisun serveur d'applications Web Java tel que la version fournie d'Apache Tomcat.


La procédure ci-après contient les instructions de mise à niveau de Cognos TM1 dela version 10.1.x à la version actuelle.

Procédure1. Sauvegardez les données et les fichiers de configuration existants.

Sauvegardez les données et les fichiers de configuration existants dans unemplacement sécurisé pour tous les ordinateurs sur lesquels des composantsCognos TM1 ont été installés. Pour plus de détails, voir les rubriquessuivantes :v «Sauvegarde des données et des fichiers de configuration de Cognos TM1», à

la page 297v «Sauvegarde des données Cognos TM1 Applications», à la page 301

2. Désinstallez tous les composants Cognos TM1 :Si l'ancienne version de Cognos TM1 a été installée dans un environnementréparti, vous devez désinstaller les composants TM1 sur chaque ordinateur.v «Désinstallation d'IBM Planning Analytics», à la page 299v «Désinstallation et déploiement de Cognos TM1 Applications», à la page 301

3. Installez la dernière version d'IBM Cognos TM1 :Reportez-vous aux rubriques suivantes, en fonction de votre environnementinformatique et des composants Cognos TM1 à installer.v Chapitre 7, «Installation monoposte de Planning Analytics», à la page 67v Chapitre 8, «Installation de Cognos TM1 Server», à la page 77v Chapitre 10, «Installation de Cognos TM1 Web», à la page 107v Chapitre 11, «Installation de Cognos TM1 Application Server», à la page 135v Chapitre 14, «Installation du niveau riche TM1», à la page 175v «Installation de Cognos TM1 Operations Console à l'aide du logiciel de

serveur Web WebSphere Liberty fourni», à la page 974. Après l'installation de la nouvelle version de Cognos TM1 Applications, effacez

le cache du navigateur Web. Si vous ne le faites pas, le navigateur risque demélanger des fichiers de l'ancienne et de la nouvelle version de Cognos TM1Applications.


5. Restaurez les données et les fichiers de configuration précédents de CognosTM1 :Selon les composants à installer, mettez à jour les données et les fichiers deconfiguration précédents sur les postes.v «Restauration des fichiers de données et de configuration dans IBM Planning

Analytics version 2.0.0», à la page 305v «Restauration des fichiers de configuration et d'application dans Cognos TM1

Applications», à la page 307

Mise à niveau à partir de Cognos TM1 version 9.xLa mise à niveau d'IBM Cognos TM1 de la version 9.x à la version 2.0.0 d'IBMPlanning Analytics version 2.0.0 nécessite une désinstallation et une installationcomplètes.

Avant de commencer

Prenez connaissance des différences en la version 9.x de Cognos TM1 et la versionactuelle. Un certain nombre d'étapes de configuration et de répertoires ont étémodifiés entre les versions 9.x et 10.x. Pour plus d'informations, voir «Planificationde la mise à niveau», à la page 42.


La procédure ci-après contient les instructions de mise à niveau de Cognos TM1 dela version 9.x à la version actuelle.

Procédure1. Arrêtez les services des composants Cognos TM1 9.x.2. Sauvegardez les données et les fichiers de configuration.3. Désinstallez Cognos TM1 version 9.x.4. Installez la nouvelle version.5. Restaurez les données et les fichiers de configuration.

Arrêt des services Cognos TM1 9.x avant la mise à niveauTous les services d'IBM Cognos TM1 version 9.x doivent être arrêtés avant la miseà niveau vers la nouvelle version.

Procédure1. Utilisez les Services Windows pour arrêter tous les services Cognos TM1 9.x.

Ceci concerne :v Cognos TM1 Admin Serverv Cognos TM1 Excel Servicev Cognos TM1 Server Services

2. Si vous utilisiez Cognos TM1 Contributor, arrêtez l'application pmpsvc deCognos TM1 Contributor.Pour ce faire, utilisez les outils de gestion du serveur d'applications Web surlequel est exécuté Cognos TM1 Contributor.

3. Si vous utilisez la sécurité IBM Cognos Analytics avec Cognos TM1Applications, arrêtez le service IBM Cognos Analytics.


Que faire ensuite

Sauvegardez les données et les applications existantes. Pour plus d'informations,voir «Sauvegarde des données d'une version antérieure de Cognos TM1 9.x».

Sauvegarde des données d'une version antérieure de CognosTM1 9.x

Cette rubrique contient les instructions pour la sauvegarde des données et desfichiers de configuration de l'ensemble des composants IBM Cognos TM1 9.x.

Avant de commencer

Arrêtez tous les services associés. Pour plus d'informations, voir «Arrêt desservices Cognos TM1 9.x avant la mise à niveau», à la page 47.


Si vous utilisez actuellement une ancienne version 9.x de Cognos TM1, vous devezsauvegarder le répertoire de données et les fichiers de configuration de CognosTM1 avant d'installer la nouvelle version 1..x de Cognos TM1.

Si vous utilisez Cognos TM1 Web 9.x ou Cognos TM1 Contributor 9.5.x, vousdevez également sauvegarder les données associées et les fichiers de configurationde ces composants.

Procédure1. Sauvegardez les fichiers de configuration du serveur Admin de Cognos TM1

que vous voulez conserver - par exemple, le fichier tm1admsrv.ini du répertoire<installation TM1>\bin\.

2. Sauvegardez dans un emplacement sécurisé les données et les fichiers deconfiguration de Cognos TM1 Server, situés dans le répertoire de données<installation TM1>\Custom\TM1Data et dans ses sous-répertoires.

Conseil : L'emplacement par défaut des données dans Cognos TM1 9.5 était :C:\Program Files\Cognos\TM1\Custom\TM1Data.

3. Sauvegardez les fichiers de configuration de Cognos TM1 Architect et deCognos TM1 Perspectives :a. Sauvegardez le fichier Tm1p.ini par défaut du système qui se trouve à

l'emplacement suivant :%ALLUSERSPROFILE%\Application Data\Applix\TM1\Tm1p.ini

Par exemple : C:\Documents and Settings\All Users\ApplicationData\Applix\TM1\Tm1p.ini

b. Sauvegardez le fichier Tm1p.ini de l'utilisateur qui se trouve àl'emplacement suivant :%APPDATA%\Applix\TM1\Tm1p.ini

Par exemple : C:\Documents and Settings\nom de l'utilisateur\ApplicationData\Applix\TM1\Tm1p.ini

4. Sauvegardez dans un emplacement sécurisé les fichiers de configuration et lesfichiers personnalisés de Cognos TM1 Web. L'emplacement par défaut deCognos TM1 Web 9.x était C:\inetpub\wwwroot\TM1Web.a. Sauvegardez une copie du fichier web.config.


Conseil : Vous réutiliserez peut-être certains paramètres de ce fichier dansla nouvelle installation de Cognos TM1 Web.

b. Sauvegardez les pages de serveur Web personnalisées que vous avez créées.5. Sauvegardez dans un emplacement sécurisé le dossier applications et le fichier

de configuration pmpsvc_config.xml de Cognos TM1 Contributor 9.5.x.a. Sauvegardez le dossier \webapps\pmpsvc\WEB-INF\applications.b. Sauvegardez le fichier de configuration \webapps\pmpsvc\WEB-INF\

configuration\pmpsvc_config.xml.Si vous avez réalisé le déploiement avec votre propre installation d'ApacheTomcat, accédez à : Program Files\Apache Software Foundation\Tomcat 6.0.Si vous avez réalisé le déploiement avec le serveur WebSphere Liberty fourniavec IBM Cognos Analytics, accédez à : Program Files\cognos\c8.

Que faire ensuite

Supprimez la version antérieure du produit. Pour plus d'informations, voir«Désinstallation d'une version précédente d'IBM Cognos TM1 9.x».

Désinstallation d'une version précédente d'IBM Cognos TM19.x

Tous les composants d'une version précédente d'IBM Cognos TM1 doivent êtresupprimés et désinstallés.

Avant de commencer

Assurez-vous d'avoir sauvegardé l'ensemble de vos données et de vos fichiers deconfiguration. Pour plus d'informations, voir «Sauvegarde des données d'uneversion antérieure de Cognos TM1 9.x», à la page 48.


Réalisez cette procédure sur chaque ordinateur à mettre à niveau.

Procédure1. Pour désinstaller une version précédente de Cognos TM1 Server, Cognos TM1

Architect, Cognos TM1 Perspectives et Cognos TM1 Web :a. Dans le Panneau de configuration de Windows, cliquez sur

Ajout/Suppression de programmes.b. Dans la liste des programmes installés, sélectionnez IBM Cognos TM1.c. Cliquez sur Supprimer et suivez les instructions pour terminer le processus.

2. Pour désinstaller Cognos TM1 Contributor :v Annulez le déploiement de Cognos TM1 Contributor sur le serveur

d'applications Web que vous utilisez.v Désinstallez l'outil d'administration de Cognos TM1 Contributor 9.5.x et IBM

Cognos Rich Client Framework.Pour plus d'informations, voir «Mise à niveau de Cognos TM1 Contributor versCognos TM1 Applications», à la page 51.

Que faire ensuite

Installez la nouvelle version du produit.


Mise à niveau d'une installation monoposte de Cognos TM1Cette rubrique décrit la manière de mettre à niveau IBM Cognos TM1 sur un posteunique fonctionnant sous Microsoft Windows.

Commencez par supprimer la version antérieure du produit. L'installation peutalors être réalisée.

Lorsque ces opérations sont effectuées, restaurez les données, les paramètres deconfiguration et les applications pour terminer la mise à niveau.Concepts associés:Chapitre 7, «Installation monoposte de Planning Analytics», à la page 67Ce type d'installation de Planning Analytics s'effectue sur un poste uniquefonctionnant sous Microsoft Windows et utilisant les paramètres par défaut.Utilisez ce type d'installation pour une installation et un démarrage rapide dePlanning Analytics ou pour installer un environnement de test ou d'évaluation.

Mise à niveau de Cognos TM1 Server sous UNIX ou LinuxVous pouvez mettre à niveau les composants serveur Cognos TM1 sur unordinateur 64 bits fonctionnant avec un système d'exploitation UNIX ou Linux.


Lorsque ces opérations sont effectuées, restaurez les données, les paramètres deconfiguration et les applications pour terminer la mise à niveau.Concepts associés:«Installation de Cognos TM1 Server sous UNIX ou Linux», à la page 80Vous pouvez installer les composants serveur Cognos TM1 Sever sur un ordinateur64 bits fonctionnant avec un système d'exploitation UNIX ou Linux. Utilisez cetype d'installation pour installer et exécuter le serveur Cognos TM1 sur unordinateur dédié accessible aux utilisateurs distants.

Mise à niveau de Cognos TM1 Server sous WindowsVous pouvez mettre à jour les composants serveur Cognos TM1 sur desordinateurs Microsoft Windows 32 bits ou 64 bits.


Lorsque ces opérations sont effectuées, restaurez les données, les paramètres deconfiguration et les applications pour terminer la mise à niveau.Concepts associés:«Installation de Cognos TM1 Server sous Windows», à la page 77Vous pouvez installer les composants serveur Cognos TM1 sur des ordinateursMicrosoft Windows 32 bits ou 64 bits. Utilisez ce type d'installation pour installeret exécuter le serveur Cognos TM1 sur un ordinateur dédié accessible auxutilisateurs distants.

Mise à niveau des clients Cognos TM1 Architect etPerspectives

Vous pouvez mettre à niveau les composants client d'IBM Cognos TM1 à l'aide duprogramme d'installation du serveur Cognos TM1 ou des clients Cognos TM1.



Lorsque ces opérations sont effectuées, restaurez les données, les paramètres deconfiguration et les applications pour terminer la mise à niveau.Concepts associés:Chapitre 14, «Installation du niveau riche TM1», à la page 175Vous pouvez installer les composants du niveau riche TM1 à l'aide du programmed'installation du serveur TM1 ou du programme d'installation du client TM1.

Mise à niveau de Cognos TM1 WebSi IBM Cognos TM1 Web est installé sur un ordinateur distinct de celui sur lequelest installé le serveur Cognos TM1, procédez de la façon suivante pour mettre àniveau le serveur Web.


Lorsque ces opérations sont effectuées, restaurez les données, les paramètres deconfiguration et les applications pour terminer la mise à niveau.Concepts associés:Chapitre 10, «Installation de Cognos TM1 Web», à la page 107Vous pouvez installer IBM Cognos TM1 Web sur un ordinateur distinct de celuisur lequel sont installés le serveur et les autres composants Cognos TM1.

Mise à niveau de Cognos TM1 Contributor vers Cognos TM1Applications

La mise à niveau de Cognos TM1 Contributor vers Cognos TM1 Applicationsnécessite plusieurs étapes. Ces étapes comprennent un processus consistant àdéplacer vos anciens fichiers d'application files dans Cognos TM1 Applications.

Avant de commencer

Prenez connaissance des informations suivantes avant de mettre à niveau vosfichiers d'application de Cognos TM1 Contributor vers Cognos TM1 Applications.

Avertissement : Vos anciennes applications devront peut-être être modifiées pourêtre compatibles avec la nouvelle version.v Les sous-ensembles dynamiques ne sont pas utilisables en tant que hiérarchie

d'approbation dans Cognos TM1 Applications.v Les applications ne peuvent pas partager des cubes d'approbation dans Cognos

TM1 Applications.

Lorsque la mise à niveau d'une application n'est pas possible, un message s'affichependant le processus de mise à niveau, et l'application est associée à l'état nondéployé. Les applications non déployées n'apparaissent pas dans le portail deCognos TM1 Applications, mais dans l'onglet de conception de l'applicationCognos TM1 Performance Modeler. Vous pouvez utiliser Cognos TM1 PerformanceModeler pour modifier et corriger l'application avant de la valider et de ladéployer.

Procédure1. Arrêtez les services associés.


Voir «Arrêt des services Cognos TM1 9.x avant la mise à niveau», à la page47.

2. Sauvegardez dans un emplacement sécurisé le dossier applications et lefichier de configuration pmpsvc_config.xml de Cognos TM1 Contributor 9.5.x.a. Sauvegardez le dossier \webapps\pmpsvc\WEB-INF\applications.b. Sauvegardez le fichier de configuration \webapps\pmpsvc\WEB-INF\

configuration\pmpsvc_config.xml.Si vous avez réalisé le déploiement avec votre propre installation d'ApacheTomcat, vérifiez ici : Program Files\Apache Software Foundation\Tomcat 6.0.Si vous avez réalisé le déploiement avec le serveur WebSphere Liberty fourniavec IBM Cognos Analytics, accédez à : Program Files\cognos\c8.

3. Désinstallez IBM Cognos TM1 9.5.x.Pour plus d'informations, voir «Désinstallation d'une version précédented'IBM Cognos TM1 9.x», à la page 49.

4. Désinstallez l'outil d'administration de Cognos TM1 Contributor 9.5.x et IBMCognos Rich Client Framework :

Conseil : Vous devrez répéter ces étapes pour chaque ordinateur sur lequell'outil d'administration de Cognos TM1 Contributor 9.5.x a été installé.a. Dans Microsoft Windows, ouvrez Ajout/Suppression de programmes.

Avertissement : Selon la manière dont l'outil d'administration a étéinstallé, il est possible qu'une seule entrée apparaisse.

b. Si l'entrée existe, commencez par supprimer IBM Cognos TM1Contributor Administration.

c. Supprimez IBM Cognos Rich Client Framework.5. Annulez le déploiement de l'application Web pmpsvc de TM1 Contributor :v Si vous avez réalisé le déploiement avec votre propre installation d'Apache

Tomcat ou d'IBM Websphere, utilisez leur outil de gestion respectif pourannuler le déploiement de l'application Web pmpsvc.

v Si vous avez réalisé le déploiement avec IBM Cognos Analytics, les fichiersprogramme se trouvent dans les répertoires suivants :– C:\Program Files\cognos\c8\webapps\pmpsvc

– C:\Program Files\cognos\c8\tomcat4.1.27\work\Standalone\localhost\pmpsvc

6. Installez Cognos TM1 Applications.Pour plus d'informations, voir Chapitre 11, «Installation de Cognos TM1Application Server», à la page 135.

7. Restaurez les fichiers de données pour chaque serveur Cognos TM1 que vousprévoyez d'utiliser avec Cognos TM1 Applications.Pour plus d'informations, voir «Restauration des données et des fichiers deconfiguration de Cognos TM1 version 9.x dans la nouvelle version», à la page54.

8. Editez le fichier de configuration tm1s.cfg pour chaque serveur Cognos TM1que vous voulez utiliser avec Cognos TM1 Applications :a. Configurez le paramètre ExcelWebPublishEnabled.

Important : Dans les versions antérieures de Cognos TM1 Contributor, ceparamètre était toujours considéré comme ayant la valeur True, quelle quesoit sa valeur réelle dans le fichier tm1s.cfg du serveur Cognos TM1. A


partir de Cognos TM1 10.1, Cognos TM1 Applications utilise ce paramètres'il est configuré explicitement dans le fichier tm1s.cfg.Pour plus de détails, voir «ExcelWebPublishEnabled», à la page 328.

b. Configurez les paramètres AllowSeparateNandCRules etDistributedPlanningOutputDir.Pour plus de détails, voir «Configuration d'un serveur Cognos TM1 en vuede son utilisation avec Cognos TM1 Application Web», à la page 142.

9. Pour continuer à utiliser vos anciens paramètres de configuration, copiez-lesmanuellement depuis l'ancien fichier dans les nouveaux fichiers deconfiguration de Cognos TM1 Applications.Avertissement : Dans Cognos TM1 Applications, le contenu de l'ancienfichier de configuration pmpsvc_config.xml a été réorganisé dans deux fichiersdistincts : pmpsvc_config.xml et fpmsvc_config.xml.a. Copiez les paramètres client de l'ancien fichier pmpsvc_config.xml dans le

nouveau fichier pmpsvc_config.xml.b. Copiez les paramètres serveur de l'ancien fichier pmpsvc_config.xml dans le

nouveau fichier fpmsvc_config.xml.10. Copiez l'ancien dossier applications de Cognos TM1 Contributor 9.5.x dans

le nouvel emplacement de Cognos TM1 Applications :Par exemple, C:\Program Files\IBM\cognos\tm1\webapps\pmpsvc\WEB-INF\applications

11. Lancez les services Cognos TM1 associés à l'aide d'IBM Cognos Configuration.a. TM1 Admin Server

b. TM1 Application Server

c. Démarrez tous les serveurs Cognos TM1 que vous utilisez à l'aide deCognos TM1 Applications.

12. Connectez-vous au portail de Cognos TM1 Applications en tantqu'administrateur pour mettre à niveau vos applications.Pendant le processus de connexion, les fichiers d'application dans le dossierwebapps/pmpsvc/WEB-INF/application sont mis à niveau de Cognos TM1Contributor 9.5.2 vers Cognos TM1 Applications.

Remarque : La durée du processus de mise à niveau dépend de la quantité dedroits à appliquer aux applications, et peut être relativement longue. Pourplus d'informations, voir «Enregistrement des droits de sécurité lors del'importation ou de la restauration d'une application Cognos TM1», à la page56.

13. Si vous recevez un message relatif aux sous-ensembles dynamiques pendant leprocessus de mise à niveau, modifiez l'application pour la rendre compatible.a. Ouvrez Cognos TM1 Performance Modeler.b. Faites passer le sous-ensemble de dynamique à statique, ou sélectionnez

un nouveau sous-ensemble statique.c. Redéployez l'application et vérifiez sa sécurité. Certains paramètres de

sécurité ont pu être modifiés, et vous devrez peut-être recréer lesaffectations de sécurité à l'aide des options de gestion des droits.Pour plus de détails, reportez-vous à la documentation TM1 PerformanceModeler.

14. Si vous recevez un message relatif aux vues partagées pendant le processus demise à niveau, modifiez l'application pour la rendre compatible.a. Ouvrez Cognos TM1 Performance Modeler.


b. Pour résoudre le problème, vous devrez réorganiser les données TM1 pourque les cubes d'approbation ne soient pas partagés par les applications.

c. Enregistrez et déployez l'application.Pour plus de détails, reportez-vous à la documentation TM1 PerformanceModeler.

Restauration des données et des fichiers de configuration deCognos TM1 version 9.x dans la nouvelle version

Après l'installation de la nouvelle version d'IBM Cognos TM1, procédez commesuit pour restaurer les anciens fichiers de configuration et de base de données de laversion 9.x du produit.

Avant de commencer


Procédure1. Restaurez les fichiers de configuration de Cognos TM1 Admin Server :

Avertissement : A partir d'IBM Cognos TM1 version 10.1.0, le fichier deconfiguration du serveur Admin TM1, Tm1admsrv.ini, n'est plus utilisé ni prisen charge par Cognos TM1. Les paramètres de configuration de Cognos TM1Admin Server sont maintenant exclusivement configurées et stockées dansl'outil IBM Cognos Configuration. Vous devez utiliser Cognos Configurationpour configurer Cognos TM1 Admin Server.a. Ouvrez IBM Cognos Configuration.b. Dans la sous-fenêtre Explorateur de Cognos Configuration, développez

Configuration locale > Environnement et cliquez sur TM1 Admin Server.Les paramètres du serveur admin s'affichent dans la sous-fenêtre Propriétés.

c. Ouvrez l'ancien fichier Tm1admsrv.ini.d. Copiez la valeur de chaque paramètre que vous souhaitez utiliser pour la

nouvelle installation, du fichier Tm1admsrv.ini, vers le paramètrecorrespondant de Cognos Configuration. Par exemple, si vous utilisiez desparamètres SSL personnalisés dans l'ancienne installation, copiez leur valeurdans Cognos Configuration.

e. Dans Cognos Configuration, cliquez sur Fichier > Enregistrer.2. Restaurez les fichiers de données et de configuration de Cognos TM1

Server :

Conseil : A partir de la version 10.1.0 d'IBM Cognos TM1, vous pouvez utiliserCognos Configuration pour démarrer, arrêter et gérer vos serveurs CognosTM1.a. Copiez le répertoire et les sous-répertoires de données de chaque serveur

Cognos TM1 à restaurer dans le nouvel emplacement réservé aux données :<installation TM1>\samples\tm1.

b. Ajoutez chaque serveur CognosTM1 dans Cognos Configuration, où vouspourrez le démarrer, l'arrêter et le gérer. Pour plus d'informations, voir«Ajout d'un serveur Cognos TM1 existant dans Cognos Configuration», à lapage 91.

3. Restaurez les fichiers de configuration de Cognos TM1 Architect et deCognos TM1 Perspectives :

Pour restaurer des paramètres de votre ancienne installation Cognos TM1 ouCognos TM1 Perspectives, copiez les valeurs de l'ancien fichier Tm1p.ini dansle nouveau fichier Tm1p.ini.


Avertissement : Si vous conservez à la même place les anciens fichiersTm1p.ini, vous devrez peut-être y modifier le chemin du répertoire défini pourle paramètre AdminSvrSSLCertAuthority. Par exemple, si vous utilisez lecertificat SSL par défaut de Cognos TM1, remplacez manuellement la valeur dece paramètre par le nouveau chemin d'installation C:\ProgramFiles\IBM\cognos\tm1\bin\ssl\applixca.pem.a. Mettez à jour le fichier Tm1p.ini par défaut du système qui se trouve à



b. Mettez à jour le nouveau fichier Tm1p.ini de l'utilisateur qui se trouve àl'emplacement suivant :%APPDATA%\Applix\TM1\Tm1p.ini


4. Restaurez les fichiers de Cognos TM1 Web :

Si vous utilisez la nouvelle version de Cognos TM1 Web, vous pouvez restaurercertains paramètres de configuration que vous voulez utiliser.Ouvrez votre ancien fichier Web.config et sélectionnez les lignes et lesparamètres que vous voulez utiliser dans le nouveau fichier tm1web_config.xmlsitué dans <installation TM1>\webapps\tm1web\web-inf\configuration.

Remarque : Cognos TM1 Web version 10.2.0 utilise un nouveau fichier deconfiguration nommé tm1web_config.xml. Ce fichier remplace le fichierweb.config des versions précédentes de Cognos TM1 Web. Pour plusd'informations, voir «Modification des paramètres de configuration de CognosTM1 Web», à la page 113.

5. Restaurez les fichiers de configuration et d'application dans Cognos TM1Applications :

Pour restaurer les fichiers d'application et de configuration de Cognos TM1Contributor 9.5.x dans la nouvelle version de Cognos TM1 Applications, voir«Mise à niveau de Cognos TM1 Contributor vers Cognos TM1 Applications», àla page 51.

Feuilles de calcul .xls Microsoft ExcelIBM Cognos TM1 Web versions 10.2.0 et suivantes utilise les formats de fichierOpen XML pour les feuilles de calcul Microsoft Excel créées à l'aide d'Excel 2007ou version ultérieure.

Si vous utilisez des fichiers Microsoft Excel existants à l'ancien format .xls,employez l'outil de conversion de Cognos TM1 pour les convertir. Si votre fichierd'origine contient des macros, l'outil de conversion de Cognos TM1 convertit lefichier d'origine en un fichier .xlsm activé pour les macros. Sinon, ce fichier estconverti en un fichier .xslx standard.

L'option Convertir des fichiers Excel au format OpenXML Excel de l'explorateurde serveur Cognos TM1 Architect Server peut convertir une feuille de calcul .xls outoutes les feuilles de calcul d'un dossier. Seuls les administrateurs disposent decette option. La conversion renomme les fichiers pour préserver autant de liensqu'il est possible de maintenir après la conversion. Certains liens et boutons


d'action doivent être mis à jour en fonction des droits qui ont changé du fait dupassage à la sécurité basée sur les cellules de la version 10.2.0.

Dans certains cas, les plages nommées du fichier d'origine sont renommées dans lefichier converti au cours du processus de conversion.

Par défaut, une sauvegarde des feuilles de calcul avant la conversion est effectuée.Par défaut, un fichier journal est généré.

Enregistrement des droits de sécurité lors de l'importation ou de larestauration d'une application Cognos TM1

Dans IBM Cognos TM1 Applications 10.2, la première opération d'enregistrementdes droits de sécurité dans une application Cognos TM1 peut être significativementplus lente que dans les versions précédentes. Vous pouvez remarquer cette lenteurlorsque vous effectuez une mise à jour et que vous restaurez des fichiersd'application ou que vous importez une application et les droits des sécuritéassociés.

Il s'agit d'un effet connu d'un nouveau concept de sécurité de TM1 Applications,qui augmente la flexibilité de la conception des applications. Ce concept, introduitdans Cognos TM1 Applications 10.2, consiste à autoriser le partage d'unedimension de hiérarchie d'approbation entre plusieurs applications. Cognos TM1Applications vous permet aussi désormais de déployer plusieurs applications,sécurisées de façon indépendante, pour différents cycles de votre processus métier.Par exemple, pour faire fonctionner en même temps une application debudgétisation et une application de prévision, basées sur le même cube sous-jacent,ce qui permet de comparer un budget en temps réel et les variances de prévision.

Il est important de remarquer que ce retard significatif de performance ne seproduit que lors du premier enregistrement des droits d'une application.L'opération d'enregistrement des droits est aussi effectuée lorsque vous restaurezmanuellement des fichiers d'application, ou lorsqu'une application est importéedans le portail Cognos TM1 Applications et que vous sélectionnez l'optiond'inclusion des droits de sécurité lors du processus d'importation.

Lors de l'enregistrement des droits suivant, une analyse différentielle est effectuée,de sorte que le durée d'enregistrement des droits est proportionnelle à la quantitéde modifications réalisées. Une petite modification est traitée rapidement. Il s'agitd'un élément clé du fonctionnement quotidien d'une application TM1, danslaquelle les droits sont mis à jour régulièrement en fonction des changementsgénérés par votre activité. Lorsqu'une application est en production, il est rare queles modifications soient de grande envergure. Les petites modifications courantesdes droits seront donc traitées rapidement.

Remarque : Précédemment, ces droits devaient être modifiés manuellement dansl'interface utilisateur de Cognos TM1 Performance Modeler ou du portail CognosTM1 Applications. Pour la première fois, l'édition 10.2 de Cognos TM1 vouspermet d'automatiser ces changements depuis la ligne de commande.


Chapitre 6. Intégration de Planning Analytics aux logicielsIBM Cognos

Il existe différentes manières d'intégrer IBM Planning Analytics à IBM CognosAnalytics et aux applications IBM Cognos. Cette rubrique résume les méthodesd'intégration les plus courantes et contient des liens vers la documentationconnexe.

Les principales options d'intégration de Planning Analytics aux logiciels Cognoscomprennent la sécurité authentifiée, la génération de rapports sur les données etl'interaction entre les données et les objets. La configuration de l'intégration entrePlanning Analytics et Cognos Analytics consiste en une combinaison de tâchesd'installation et de configuration sur les ordinateurs hébergeant les composantsserveur et serveur Web. Dans certains cas, des opérations d'installation et deconfiguration sont nécessaires sur les postes individuels des utilisateurs.

Sécurité authentifiée

Figure 5. Présentation de l'intégration de Planning Analytics aux applications IBM Cognos


Vous pouvez configurer le serveur Cognos TM1 pour authentifier lesutilisateurs à l'aide de la sécurité Cognos Analytics. Avec cetteconfiguration, les interfaces utilisateur et les applications personnaliséesCognos TM1 doivent utiliser une combinaison nom d'utilisateur/ mot depasse valide existant sur le serveur Cognos Analytics pour accéder auxdonnées Cognos TM1.

Importation de données Cognos Analytics dans Planning Analytics

IBM Cognos TM1 Package Connector est actuellement pris en charge pourune utilisation avec les packs IBM Cognos Business Intelligence sur lessources de données SAP Business Warehouse et les autres sources dedonnées ODBC. Vous pouvez utiliser Cognos TM1 Package Connectorpour importer des données de ces sources dans Planning Analytics à l'aided'un processus TurboIntegrator de Cognos TM1.

Utilisation de Cognos TM1 en tant que source de données avec les logicielsCognos

Vous pouvez configurer IBM Cognos Analytics pour qu'il accède auxserveurs et aux cubes Cognos TM1 depuis des applications CognosAnalytics telles que Cognos Report Studio et Cognos Query Studio.

Vous pouvez également accéder aux données TM1 dans IBM PlanningAnalytics for Microsoft Excel.

Affichage d'objets de données Cognos TM1 et interaction avec eux

Vous pouvez accéder aux objets de données Cognos TM1, les visualiser etinteragir avec eux dans IBM Cognos Workspace et IBM Cognos Insight :v Vues de cube et graphiques TM1v Feuilles Web TM1v Cubes de diagrammes TM1 de génération de scorecard

Sécurité Planning Analytics et Cognos Analytics

Vous pouvez configurer le serveur Cognos TM1 pour authentifier les utilisateurs àl'aide de la sécurité Cognos Analytics. Avec cette configuration, les interfacesutilisateur et les applications personnalisées Cognos TM1 doivent utiliser unecombinaison nom d'utilisateur/ mot de passe valide existant sur le serveur CognosAnalytics pour accéder aux données Cognos TM1. Vous pouvez égalementconfigurer IBM Cognos TM1 Applications de sorte qu'il utilise la sécurité CognosAnalytics.

Pour plus de détails, voir les rubriques suivantes :v «Utilisation de la sécurité Cognos avec Cognos TM1», à la page 257v «Utilisation de Cognos TM1 Applications avec la sécurité Cognos», à la page 266

Importation de données Cognos Analytics dans Cognos TM1 à l'aidede Cognos TM1 Package Connector

IBM Cognos TM1 Package Connector est actuellement pris en charge pour uneutilisation avec les packs IBM Cognos Analytics sur SAP Business Warehouse et lesautres sources de données relationnelles et ODBC. Vous pouvez utiliser CognosTM1 Package Connector pour importer des données depuis ces sources dansCognos TM1 à l'aide d'un processus TurboIntegrator de Cognos TM1.


IBM Cognos TM1 Package Connector est un composant facultatif, distinct del'installation TM1 principale, et disponible sur son propre CD ou entéléchargement. Il doit être installé à la fois sur le serveur TM1 et sur les systèmesclients administratifs sur lesquels sont créés les processus TurboIntegrator traitantles packs BW.

Pour plus de détails, consultez la documentation suivante :v Voir «Installation de Cognos TM1 Package Connector» pour connaître les

instructions d'installation.v Pour plus d'informations sur l'utilisation de TM1 Package Connector,

reportez-vous au chapitre «Importation de données avec IBM Cognos TM1Package Connector» du document IBM Cognos TM1 TurboIntegrator.

v Voir Cognos Analytics (http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.cbi.doc/welcome.html).

v Pour obtenir des informations spécifiques sur les logiciels pris en charge, voirSoftware Environments for IBM Planning Analytics 2.0 (http://www.ibm.com/support/docview.wss?uid=swg27049052).

v Pour des informations sur la création des packs, voir IBM Cognos FrameworkManager.

v Voir la documentation SAP pour toute question relative à ce produit.

Installation de Cognos TM1 Package ConnectorIBM Cognos TM1 prend en charge la connectivité aux packs IBM Cognos Analyticspour certaines sources de données.

Cognos TM1 Package Connector est un composant facultatif 32 bits proposé sur unCD distinct ou en téléchargement à partir de l'installation principale de PlanningAnalytics. Ce composant doit être installé dans son propre répertoire.

Pour plus d'informations sur les sources de données prises en charge, voirSoftware Environments for IBM Planning Analytics 2.0 (http://www.ibm.com/support/docview.wss?uid=swg27049052).

Pour plus d'informations sur l'utilisation de Cognos TM1 Package Connector,reportez-vous à la section «Importation de données avec IBM Cognos TM1 PackageConnector» du document IBM Cognos TM1 TurboIntegrator.

Configuration requise pour Cognos TM1 Package ConnectorPour plus d'informations sur les plateformes et les versions prises en charge, ainsique sur la configuration requise, reportez-vous aux Knowledge Centers d'IBMCognos Analytics et d'IBM Planning Analytics.

Cognos TM1 Package Connector requiert les composants suivants :v Cognos TM1 version 9.5.1 ou ultérieure.

Pour toutes les sources de données que vous utilisez, Cognos TM1 PackageConnector doit être installé à la fois sur le serveur Cognos TM1 et sur lessystèmes clients administratifs sur lesquels sont créés les processusTurboIntegrator.Pour plus d'informations, voir Software Environments for IBM PlanningAnalytics 2.0 (http://www.ibm.com/support/docview.wss?uid=swg27049052).

v IBM Cognos Analytics Server.

Chapitre 6. Intégration de Planning Analytics aux logiciels IBM Cognos 59

http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.cbi.doc/welcome.html





Pour plus d'informations sur les versions prises en charge, reportez-vous à ladocumentation d'IBM Cognos Analytics 11.0 sur l'IBM Knowledge Center(http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0).

v IBM Cognos Framework Manager pour la création des packs.v Si votre source de données est SAP, SAP Business Warehouse est requis.

Consultez les versions prises en charge dans le Knowledge Center.v Un logiciel client de base de données 32 bits spécifique à la source de données

utilisées est nécessaire sur toutes les plateformes sur lesquelles Cognos TM1Package Connector est installé. Pour SAP BW, l'interface graphique SAP ou lesfichiers de la bibliothèque SAP RFCSDK et les DLL sont nécessaires. Voir«Activation de la connectivité à SAP depuis Planning Analytics».

Installation de Cognos TM1 Package ConnectorProcédez comme suit pour installer IBM Cognos TM1 Package Connector :

Procédure1. Insérez le disque Cognos TM1 Package Connector dans la machine du serveur

Cognos TM1.2. Exécutez le fichier issetup.exe qui se trouve dans le dossier système de votre

système d'exploitation, par exemple win32.Cette opération lance le programme d'installation de Cognos.

3. Répondez aux invites du programme en fonction de votre installation.Installez Cognos TM1 Package Connector dans son propre répertoire. Nel'installez pas dans un répertoire Cognos Analytics existant.

4. Sur l'écran Terminer, cochez la case Démarrer IBM Cognos Configuration pourlancer automatiquement la fenêtre de configuration. Si vous préférez, vouspouvez laisser cette case vide et lancer Cognos Configuration manuellementune fois l'installation terminée.

Installation de Cognos TM1 Package Connector sur Windows 7 ou Vista :

Par défaut, le répertoire temporaire d'IBM Cognos TM1 Package Connector dansCognos Configuration se trouve dans le répertoire Program Files.

Les applications Microsoft Vista ou Windows 7 ne sont pas autorisées à écrire dansProgram Files. Cela peut provoquer une erreur lors de la sélection de Cognos TM1Package Connector depuis Cognos TM1 Perspectives sous Windows 7 et Vista.

Pour éviter ce problème, choisissez Exécuter en tant qu'administrateur lors del'exécution de Microsoft Excel. Ou, dans Cognos Configuration, pour Cognos TM1Package Connector, vous pouvez remplacer le paramètre Temporary fileslocation par un répertoire dans lequel l'utilisateur peut écrire.

Activation de la connectivité à SAP depuis Planning AnalyticsPour établir la connexion avec le serveur SAP, vous devez disposer des versions32 bits des fichiers et DLL de la bibliothèque SAP RFCSDK sur le client IBMCognos TM1 Admin et le serveur IBM Cognos TM1.

Pour obtenir ces fichiers sous Microsoft Windows, installez l'interface SAP GUI.Pour UNIX, voir «Installation de Cognos TM1 Package Connector sous UNIX», à lapage 62.


http://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0

Configuration de Cognos TM1 Package ConnectorAprès avoir installé IBM Cognos Analytics TM1 Package Connector, vous avezaccès à l'outil IBM Configuration.

Si l'outil Cognos Configuration n'a pas démarré automatiquement, utilisez le menuDémarrer > IBM Cognos > IBM Cognos Configuration pour le lancer.

Procédure1. Lancez ou ouvrez Cognos Configuration.2. Sélectionnez le noeud Environnement de la fenêtre Configuration locale de

l'explorateur. Les paramètres actuels de l'URI s'affichent.3. Définissez l'URI de la passerelle de manière qu'elle pointe sur le serveur

Cognos Analytics sur lequel les packs sont déployés.L'URI de la passerelle se présente sous la forme suivante :http[s]://<host IP address>:<port>/<BI_SERVER_virtual_dir>/cgi-bin/cognos.cgi.

Pour plus d'informations sur les URI, reportez-vous à la documentation TM1Operations ou Cognos Analytics.

4. Saisissez l'URI dans la colonne Valeur du noeud Autres paramètres de l'URI.L'URI du répartiteur se présente sous la forme suivante :http[s]://<host IP address>:<port>/p2pd/servlet/dispatch.

5. Une fois l'URI définie, cliquez sur Enregistrer pour enregistrer la configuration.La fenêtre de progression de la configuration suit le statut de vos entrées. Unefois l'opération terminée, cliquez sur Fermer. Si une erreur est détectée, vérifiezvos paramètres et saisissez de nouvelles valeurs.

6. Fermez la fenêtre Cognos Configuration.

Définition de la variable d'environnement :

Sous Microsoft Windows, après avoir installé IBM Cognos TM1 Package Connector,la variable d'environnement utilisateur TM1_PACKAGE_CONNECTOR prend la valeur durépertoire d'installation précisé lors de l'installation, par exemple C:\ProgramFiles\IBM\Cognos\c10\bin.

Si vous le souhaitez, vous pouvez modifier cet emplacement. Il suffit pour cela demodifier la variable ou de créer une variable d'environnement système.

La variable système est créée par l'installation la plus récente de Cognos TM1Package Connector.

L'emplacement par défaut de l'installation Cognos TM1 Package Connector10 dansMicrosoft Windows est C:\Program Files\IBM\cognos\c10.

Définition du paramètre de configuration du serveur Cognos TM1 (facultatif) :

Pour pouvoir exécuter le processus IBM Cognos TM1 TurboIntegrator sur leserveur Cognos TM1, ajoutez le paramètre CognosTM1InterfacePath au fichier deconfiguration (tm1s.cfg) du serveur TM1 sur lequel résident vos données aprèsl'importation depuis le pack Cognos Analytics.

Avertissement : Les informations suivantes s'appliquent uniquement lors del'utilisation d'un système d'exploitation Microsoft Windows.


La valeur de CognosTM1InterfacePath indique à Cognos TM1 Server où trouverCognos TM1 Package Connector. Il est inutile de définir ce paramètre si la variabled'environnement TM1_PACKAGE_CONNECTOR l'est. Ce paramètre, s'il est défini,prévaut sur la variable d'environnement TM1_PACKAGE_CONNECTOR.

Indiquez l'emplacement de Cognos TM1 Package Connector dans le fichiertm1s.cfg du serveur Cognos TM1 sur lequel est installé Cognos TM1 PackageConnector. Par exemple :CognosTM1InterfacePath=C:\Program Files\ibm\cognos\c10\bin

A faire :

La variable CognosTM1InterfacePath n'est requise qu'en cas d'utilisation de CognosTM1 Package Connector sous UNIX (AIX, Solaris, Linux).

TM1_Package_CONNECTOR est une variable d'environnement système quiidentifie l'emplacement de l'installation Cognos TM1 Package Connector sur unsystème d'exploitation Windows.

La variable cognosTM1InterfacePath est utilisée dans le fichier tm1s.cfg du serveurCognos TM1 sous UNIX. Cependant, si cette variable est ajoutée au fichier tm1s.cfgd'un serveur TM1 sous Windows, elle peut remplacer la valeur définie dansTM1_Package_Connector.

Cognos TM1 Package Connector sur l'ordinateur client :

Après l'installation et la configuration de IBM Cognos TM1 Package Connector surle serveur Cognos TM1, installez et configurez une autre copie sur le poste clientAdmin. Utilisez les mêmes paramètres pour les deux installations.

Exécution de TM1 Package ConnectorPour des informations détaillées sur la manière d'exécuter Cognos TM1 PackageConnector, reportez-vous au chapitre «Importation de données avec IBM CognosTM1 Package Connector» dans la documentation TM1 TurboIntegrator.

Installation de Cognos TM1 Package Connector sous UNIXPour installer IBM Cognos TM1 Package Connector sous UNIX, suivez lesinstructions données pour l'installation sous Microsoft Windows, à quelquesexceptions près :

Procédure1. Utilisez Java Standard Edition 6 32 bits (ou Java SE 6 32 bits).2. Définissez la variable d'environnement JAVA_HOME=<répertoire Java> où

<répertoire Java> correspond à l'emplacement d'installation de Java 32 bits.3. Copiez les fichiers de <Package_Connector_install_location>/bin/jre/6.0/

lib/ext* dans JAVA_HOME/jre/lib/ext.4. Démarrez cogconfig.sh depuis <répertoire d'installation de Package

Connector>/bin.5. Placez les fichiers et DLL de la bibliothèque SAP RFCSDK 32 bits sur la

machine UNIX.6. Sélectionnez des paramètres régionaux qui utilisent la page de code UTF-8

pour gérer les données Unicode. (facultatif)7. Configurez le serveur Cognos TM1 en ajoutant le paramètre au fichier

tm1s.cfg :


CognosTM1InterfacePath=/<Package_Connector_install_location>/bin

8. Configurez votre environnement de façon à utiliser les DLL SAP avec CognosTM1 Package Connector :a. Insérez le répertoire de la bibliothèque RFCSDK dans le chemin d'accès

$LD_LIBRARY_PATH ou $LIBPATH.b. Exportez (publiez) ces variables : $LIBPATH et $LD_LIBRARY_PATH.v L'emplacement des bibliothèques varie en fonction des plateformes

UNIX :Solaris et Linux : LD_LIBRARY_PATHHPUX : SHLIB_PATHAIX : LIBPATH

Cognos TM1 en tant que source de données avec Cognos AnalyticsVous pouvez configurer IBM Cognos Analytics pour qu'il accède aux serveurs etaux cubes Cognos TM1 depuis Cognos Report Studio et Cognos Query Studio.

Pour permettre la génération de rapports Cognos Analytics à partir de sources dedonnées Cognos TM1, installez les fichiers d'API Cognos TM1 requis sur tous lesserveurs Cognos Analytics qui exécutent des services de requête et de générationde rapports sous Microsoft Windows. Voir «Activation de la génération de rapportsCognos Analytics à partir de sources de données Cognos TM1».

Pour plus d'informations sur Cognos Analytics, consultez les ressources suivantes :v Documentation IBM Cognos Analytics 11.0 sur l'IBM Knowledge Center

(https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0).v Guide d'administration > «Sources de données et connexions» > «Source de

données TM1»

Activation de la génération de rapports Cognos Analytics àpartir de sources de données Cognos TM1

Pour permettre la génération de rapports Cognos Analytics à partir de sources dedonnées Cognos TM1, utilisez le programme d'installation du client Cognos TM1pour installer les fichiers Cognos TM1 API requis sur tous les serveurs CognosAnalytics qui exécutent des services de requête et de génération de rapports sousMicrosoft Windows.


La procédure ci-dessous s'applique aux nouvelles installations d'IBM PlanningAnalytics 2.0.0 et aux installations existantes d'IBM Planning Analytics 2.0.0 quiinstallent ensuite Cognos Analytics sur des systèmes Microsoft Windows.

Procédure1. Exécutez le programme d'installation du client IBM Cognos TM1 :v Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008, cliquez

avec le bouton droit sur le fichier issetup.exe, puis cliquez sur Exécuter entant qu'administrateur.

v Dans le cas des autres systèmes d'exploitation Windows, cliquez deux foissur le fichier issetup.exe.


https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0

2. Sur la page Emplacement d'installation, sélectionnez un répertoire adjacent surle serveur Cognos Analytics qui exécute les services de requête et de générationde rapports sous Microsoft Windows.

3. Dans la page Sélection des composants, développez Niveau riche TM1 etsélectionnez l'option suivante :API TM1

Laissez toutes les autres cases désélectionnées.4. Suivez la procédure et cliquez sur Terminer pour terminer l'installation.

iWidgets Cognos TM1 et Cognos WorkspaceVous pouvez afficher dans IBM Cognos Workspace les objets de données IBMCognos TM1 Web, tels que les vues de cube, les graphiques et les feuilles Web.

Après avoir installé et lancé Cognos TM1 Web, vous configurez et utilisez lesiWidgets Cognos TM1 dans l'environnement IBM Cognos Business Intelligence etCognos Workspace.

Configuration de l'utilisation des iWidgets Cognos TM1 dansCognos Workspace

Pour utiliser les données IBM Cognos TM1 dans IBM Cognos Workspace, vousdevez modifier les fichiers de configuration suivants dans l'installation IBMCognos Analytics.v tm1_contribution.atom

v tm1_en.properties

Pour plus d'informations, consultez la rubrique Configuration d'IBM CognosWorkspace en vue de l'utilisation des données IBM Cognos TM1(https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/c_cnfgbux4tm1.html) dans ladocumentation IBM Cognos Analytics 11.0, sur l'IBM Knowledge Center(https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0).

Utilisation des données Cognos TM1 dans Cognos Workspace

Vous pouvez accéder en temps réel au objets de données développés dans CognosTM1 depuis Cognos Workspace. L'onglet Contenu de Cognos Workspace vouspermet de naviguer dans le contenu TM1. Par ailleurs, vous pouvez ajouter desrapports TM1 à l'espace de travail aux conditions suivantes :v Cognos TM1 doit être installé et configuré en tant que composant de votre

environnement IBM Cognos Analytics. Si vous décidez d'utiliser SSL dansl'environnement Cognos Analytics, TM1 Web doit l'utiliser aussi.

v Vous devez disposer des droits et des fonctionnalités nécessaires pour interagiravec le contenu Cognos TM1.

Pour plus d'informations sur l'utilisation des données TM1 dans CognosWorkspace, consultez les rubriques suivantes d'IBM Cognos Workspace dans ladocumentation IBM Cognos Analytics 11.0, sur l'IBM Knowledge Center(https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0).v Contenu de Cognos TM1 (https://www.ibm.com/support/knowledgecenter/

SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_buxc.doc/c_ug_buxc_tm1_content.html)


https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/c_cnfgbux4tm1.html

https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.inst_cr_winux.doc/c_cnfgbux4tm1.html



https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_buxc.doc/c_ug_buxc_tm1_content.html

v Ajout de contenu Cognos TM1 à Cognos Workspace (https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_buxc.doc/c_ug_buxc_tm1_content_adding.html)

Intégration de Cognos TM1 Applications à Cognos Analytics et auportail Cognos Connection

Si votre installation TM1 met en oeuvre l'authentification à l'aide de la sécuritéCognos, les utilisateur de Cognos Analytics peuvent utiliser le portail CognosConnection au lieu du portail TM1 Applications pour ouvrir les applications TM1.Cependant, les administrateurs doivent toujours passer par TM1 Applications pourconfigurer et gérer les applications.

Lorsque vous configurez TM1 Applications en vue de l'utilisation de la sécuritéCognos, vous activez également l'affichage, dans le portail Cognos Connection,d'un dossier qui contient des liens vers les applications TM1 disponibles. La listedes applications affichées dépend des droits de l'utilisateur.

Le fichier planning.html contient les informations à partir desquelles CognosAnalytics et le portail Cognos Connection affichent les liens vers les applicationsTM1. Pour plus d'informations, voir «Utilisation de Cognos TM1 Applications avecla sécurité Cognos», à la page 266.

Remarque : La variable d'environnement TM1_PATH doit être définie avantl'établissement d'une connexion à Cognos TM1 dans un environnement UNIX.


https://www.ibm.com/support/knowledgecenter/SSEP7J_11.0.0/com.ibm.swg.ba.cognos.ug_buxc.doc/c_ug_buxc_tm1_content_adding.html

Chapitre 7. Installation monoposte de Planning Analytics

Ce type d'installation de Planning Analytics s'effectue sur un poste uniquefonctionnant sous Microsoft Windows et utilisant les paramètres par défaut.Utilisez ce type d'installation pour une installation et un démarrage rapide dePlanning Analytics ou pour installer un environnement de test ou d'évaluation.

La rubrique relative à l'installation monoposte explique comment installer etexécuter :v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos TM1 Perspectivesv Cognos TM1 Architectv Cognos TM1 Webv Cognos TM1 Application Serverv Cognos TM1 Application Webv Cognos Insightv Cognos TM1 Performance Modeler

Le scénario d'installation suppose que :v Vous utilisez un seul ordinateur 32 bits ou 64 bits doté du système d'exploitation

Microsoft Windows.v Vous utilisez le logiciel de serveur Web WebSphere Liberty installé par

l'installation de Planning Analytics.v Vous utilisez l'authentification standard et par défaut de Cognos TM1.v Vous acceptez la configuration par défaut en langue anglaise.

Tous les composants Cognos TM1 ne sont pas disponibles pour les systèmes 64bits. Si le composant est disponible en version 64 bits, il est installé dans unrépertoire identifié comme tel, et non dans le répertoire d'installation 32 bits pardéfaut. Par exemple, bin64 au lieu de bin.

A faire : Votre navigateur peut utiliser une interface légèrement différente de celledu navigateur utilisé dans les étapes décrites ici.Concepts associés:«Mise à niveau d'une installation monoposte de Cognos TM1», à la page 50Cette rubrique décrit la manière de mettre à niveau IBM Cognos TM1 sur un posteunique fonctionnant sous Microsoft Windows.

Installation des logiciels prérequisCertains logiciels doivent être installés avant l'installation d'IBM Cognos TM1.


Si ces logiciels ne sont pas en place, l'assistant d'installation de Cognos TM1 afficheun message à ce propos. S'il vous manque un des logiciels, vous devez l'installeravant de pouvoir continuer. Il se peut que ces logiciels soient déjà installés.


Procédure

Pour Cognos TM1 Perspectives ou Cognos TM1 Architect, vérifiez que vousdisposez des logiciels suivants, ou installez-les :v Microsoft .NET Frameworkv Microsoft Visual C++ 2010 Redistributable Packagev Microsoft Excel

Passez en revue la liste à jour des environnements pris en charge par PlanningAnalytics, ainsi que les informations sur les systèmes d'exploitation, les correctifs,les serveurs Web et les navigateurs Web, à la page Software Environments for IBMPlanning Analytics 2.0 (http://www.ibm.com/support/docview.wss?uid=swg27049052).

Installation des composants Cognos TM1 de baseUtilisez le programme d'installation pour sélectionner les composants que voussouhaitez installer, ainsi que l'emplacement sur votre ordinateur.

Avant de commencerv Vérifiez que vous disposez des privilèges d'administrateur pour l'ordinateur sur

lequel vous installez le logiciel.v Assurez-vous que l'ordinateur dispose d'une variable système TEMP pointant

vers le répertoire où vous voulez stocker les fichiers temporaires. Au cours del'installation, les fichiers sont copiés temporairement dans ce répertoire.

v Certains serveurs Web Microsoft Windows ne prennent pas en charge lescaractères non ASCII dans les noms de répertoire. Vérifiez que les chemins desrépertoires dans lesquels vous installez les composants IBM Cognos TM1composants contiennent uniquement des caractères ASCII.

v Vérifiez que tous les logiciels prérequis ont été installés.v Plusieurs types de programme d'installation sont disponibles. En fonction de

votre système d'exploitation, accédez au répertoire dans lequel le programme devotre choix est stocké :– TM1 pour Windows 32 bits– TM1 pour Windows 64 bits

Procédure1. Pour démarrer l'installation :v Accédez au répertoire de téléchargement du programme d'installation

Cognos TM1 choisi.v Ou, insérez le CD du produit IBM Cognos TM1.

Si l'assistant d'installation ne s'ouvre pas automatiquement, accédez aurépertoire du système d'exploitation pour localiser la commandeissetup.exe.

2. Selon votre système d'exploitation, cliquez avec le bouton droit ou cliquez deuxfois sur le fichier issetup.exe :v Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008, cliquez


v Pour tous les autres systèmes d'exploitation Windows, cliquez deux fois surissetup.exe.




3. Suivez les instructions fournies par l'assistant d'installation pour sélectionnertous les composants.Les composants dont vous avez besoin pour exécuter le logiciel sontsélectionnés par défaut.Si vous ne voulez installer ni Cognos Insight, ni Cognos TM1 PerformanceModeler, passez à l'étape 5.

4. Pour inclure Cognos Insight dans l'installation, développez le Niveau richeTM1 et sélectionnez Cognos Insight.

5. Pour inclure Cognos TM1 Performance Modeler dans l'installation, sélectionnezTM1 Performance Modeler.

6. Cliquez sur Suivant jusqu'à ce que l'installation commence.L'installation se poursuit jusqu'à ce que tous les composants aient été installés.Cela peut prendre un certain temps.

Conseil : Pour des systèmes d'exploitation Windows plus anciens, vous pouvezcocher Démarrez Cognos Configuration sur le dernier écran de l'installationpour lancer immédiatement l'outil de configuration. Sous Microsoft WindowsVista, Windows 7 ou Windows Server 2008, ne cochez pas cette case maisutilisez à la place le menu Démarrer pour pouvoir choisir Exécuter en tantqu'administrateur lors du lancement de l'outil Cognos Configuration.

7. Cliquez sur Terminer.

Utilisation de Cognos Configuration en vue du démarrage descomposants Cognos TM1

Avant de pouvoir utiliser Cognos TM1, vous devez démarrer IBM Cognos TM1Admin Server, le serveur TM1 Application Server, et au moins un serveurd'exemple de base de données IBM Cognos TM1. Cette action enregistre lesserveurs dans le registre des services Windows. Vous devez ensuite configurer lesservices pour qu'il soient exécutés sous un utilisateur spécifique. Les serveurs quis'exécutent dans un environnement Microsoft Windows sont appelés des«services».

Procédure1. S'il n'est pas encore actif, démarrez l'outil de configuration en cliquant sur

Démarrer > Tous les programmes > IBM Cognos TM1 > IBM CognosConfiguration.

A faire : Cliquez avec le bouton droit et sélectionnez Exécuter en tantqu'administrateur sous Windows Vista, Windows 7 et Windows Server 2008.

2. Dans la sous-fenêtre Explorer de Cognos Configuration, développez LocalConfiguration > Environment.

3. Cliquez avec le bouton droit de la souris sur chaque composant à démarrer,puis sélectionnez Démarrer:a. TM1 Admin Server Il est préférable de commencer par démarrer TM1

Admin Server, car ce serveur doit être actif pour que les bases de donnéesd'exemple puissent s'exécuter.L'outil Cognos Configuration vous invite à enregistrer les modifications quevous avez éventuellement apportées aux paramètres de configuration. Ceprocessus est plus long lors du premier enregistrement d'un paramètre, cardifférents éléments, notamment les réglages cryptographiques, sont alors

Chapitre 7. Installation monoposte de Planning Analytics 69

mis en place. Cliquez sur Oui en réponse au message vous invitant àenregistrer les paramètres. Ce type de message s'affiche aussi lorsque vousfermez Cognos Configuration.

b. TM1 Application Server

4. Développez le noeud Data Access > TM1 Server et cliquez avec le bouton droitsur chaque serveur de base de données d'exemple Cognos TM1 à démarrer,puis sélectionnez Start. Par exemple, démarrez les bases de données qui ont étéfournies comme exemple :a. SData

b. Planning Sample

c. GO_New_Stores

5. Cliquez sur Fichier > Enregistrer.6. Lorsque tous les services sont enregistrés dans le registre des services

Windows, vous pouvez les reconfigurer pour qu'ils utilisent un compteutilisateur spécifique :a. Dans Cognos Configuration, cliquez avec le bouton droit sur chaque service

à modifier, et sélectionnez Stop.b. Ouvrez les Services Windows.c. Cliquez avec le bouton droit de la souris sur chaque service, et sélectionnez

Propriétés.d. Entrez un nom d'utilisateur et un mot de passe valides sur votre système, et

disposant des droits appropriés pour le service. Voir «Comptes utilisateurpour l'exécution des services Cognos TM1 sous Windows», à la page 18.

e. Fermez les services Windows.7. Dans Cognos Configuration, cliquez avec le bouton droit sur chaque serveur et

sélectionnez Start.8. Fermez Cognos Configuration.

Exécution de Cognos TM1 PerspectivesAprès son installation, vous pouvez lancer IBM Cognos TM1 Perspectives.

Procédure1. Dans le menu Démarrer de Windows, cliquez sur IBM Cognos TM1 >

Perspectives. Si le composant ne démarre pas, vérifiez que les serveurs quevous avez lancés avec Cognos Configuration sont toujours en cours d'exécution.

2. Cliquez sur Activer les macros lorsque l'avertissement de sécurité s'affiche.3. Cliquez sur TM1 > Explorateur de serveur, puis développez TM1 pour afficher

les serveurs disponibles.4. Cliquez deux fois sur une instance de Cognos TM1 Server pour vous y

connecter.Pour la connexion à SData, Planning Sample ou GO_New_Stores, utilisez lesdonnées d'identification suivantes :v Nom d'utilisateur : admin

v Mot de passe : apple

Conseil : Pour charger Cognos TM1 Perspectives automatiquement lors dudémarrage de Microsoft Excel, ajoutez répertoire TM1/Tm1p.xla à la liste descompléments de Microsoft Excel, où répertoire TM1 est le répertoire dans lequelCognos TM1 est installé. Une fois cette étape terminée, "TM1" s'affiche dans labarre de menus de Microsoft Excel.


Exécution de Cognos TM1 ArchitectAprès son installation, vous pouvez exécuter la version non-Microsoft Excel d'IBMCognos TM1 appelée IBM Cognos TM1 Architect.

Procédure1. Dans le menu Démarrer de Windows, cliquez sur Tous les programmes > IBM

Cognos TM1 > Architect. Si Cognos TM1 Architect ne démarre pas, vérifiezque les serveurs que vous avez lancés avec Cognos Configuration sont toujoursen cours d'exécution.

2. Développez TM1 pour afficher les serveurs disponibles.3. Cliquez deux fois sur une instance de Cognos TM1 Server pour vous y

connecter.4. Pour la connexion aux bases de données d'exemple SData, Planning Sample ou

GO_New_Stores, utilisez les données d'identification suivantes :v Nom d'utilisateur : admin


Exécution de Cognos TM1 WebL'installation d'IBM Cognos TM1 configure IBM Cognos TM1 Web de sorte qu'ilfonctionne avec la version fournie du serveur d'applications Web WebSphereLiberty.

Procédure1. Dans un navigateur web, entrez l'adresse URL suivante : http://

localhost:9510/tm1web/

Si vous utilisez «localhost», le système considère par défaut que l'emplacementse trouve sur votre ordinateur local. Sinon, vous pouvez entrer explicitementl'adresse IP ou le nom de l'ordinateur sur lequel vous avez installé CognosTM1.

2. En fonction des autres composants que vous avez lancés, les valeurs de la zonede connexion sont pré-remplies automatiquement. Si elles ne le sont pas, vouspouvez les saisir ou les modifier.

3. Cliquez sur Se connecter.

Exécution de Cognos TM1 Application WebIBM Cognos TM1 Application Web est le client Web et le portail utilisés pourexécuter les applications de planification générées à l'aide des données IBMCognos TM1.


Cognos TM1 Application Web est également utilisé pour lancer IBM Cognos TM1Performance Modeler et peut être utilisé pour lancer IBM Cognos Insight.

Procédure1. Dans un navigateur Web, entrez l'adresse URL suivante : http://

localhost:9510/pmpsvc où 9510 est le port généralement utilisé par CognosTM1 Application Server. Si vous avez utilisé un port différent lors del'installation, entrez cette valeur ici.


2. Définissez les paramètres de configuration de l'hôte Admin, du serveur, destypes de client et l'URL de Cognos TM1 Application Web.

3. Cliquez sur OK.4. Entrez admin et apple comme nom d'utilisateur et mot de passe

respectivement pour les serveurs TM1.5. Pour terminer l'installation, ignorez les messages relatifs à l'édition des

paramètres suivants dans le fichier tm1s.cfg.v AllowSeparateNandCRules

v ForceReevaluationOfFeedersForFedCellsOnDataChange

v DistributedPlanningOutputDir

Il n'est pas nécessaire d'éditer ces paramètres tant que vous n'utilisez pas lesclients.Le portail est vide tant que vous n'avez pas généré d'application à l'aide deCognos TM1 Performance Modeler ou importé une application existante.

Exécution de Cognos TM1 Performance ModelerIBM Cognos TM1 Performance Modeler est disponible en tant que composant nonsélectionné de l'installation IBM Cognos TM1. Il se lance depuis le portail d'IBMCognos TM1 Applications.


Lorsque Cognos TM1 Performance Modeler est installé, vous pouvez aussidémarrer le programme à partir de l'icône qui est installée sur le bureau, ou depuisle menu Démarrer de Microsoft Windows. Cliquez sur Démarrer > Tous lesprogrammes > IBM Cognos TM1 Performance Modeler > IBM Cognos TM1Performance Modeler.

Procédure1. Dans le portail de Cognos TM1 Applications, cliquez sur l'icône Ouvrir

Performance Modeler .

A faire : Selon votre navigateur, la procédure d'installation des composantstéléchargés, Cognos TM1 Performance Modeler par exemple, peut varierlégèrement.

2. Dans la boîte de dialogue de provagent.cogrcp_modeler, cliquez sur OK aprèsavoir sélectionné Open with IBM Cognos RCP Application Updater.

3. Cliquez sur OK pour ignorer le message les paramètres de configuration etterminez l'installation.Il n'est pas nécessaire d'éditer ces paramètres tant que vous n'utilisez pas lesclients.

4. Cliquez sur l'onglet Conception de modèle pour voir les cubes de données etla structure GO_New_Stores.

5. Cliquez sur l'onglet Conception d'application pour générer une nouvelleapplication à l'aide de GO_New_Stores.La documentation TM1 Performance Modeler contient des informations détailléessur la création de modèles.


Exécution de Cognos InsightIBM Cognos Insight est disponible en tant que composant non sélectionné del'installation IBM Cognos TM1. Cognos Insight peut être utilisé en tant que clientd'applications contributives, et comme générateur d'espaces de travail dynamiquespour la création d'environnements utilisateur dédiés aux contributions interactives.

Procédure1. Pour démarrer Cognos Insight, effectuez l'une des actions suivantes :v A partir du portail Cognos TM1 Applications, cliquez sur l'icône Cognos

Insight .Sinon,

v Cliquez sur un noeud d'une application qui a été configurée pour utiliserCognos Insight.

v Vous pouvez aussi cliquer sur l'icône Cognos Insight qui est installée sur lebureau.

v Utilisez le menu de démarrage de Microsoft Windows. Cliquez sur Démarrer> Tous les programmes > IBM Cognos Insight > IBM Cognos Insight.

v Cognos Insight peut également être installé comme composant autonome.

A faire : Selon votre navigateur, la procédure d'installation des composantstéléchargés comme Cognos Insight peut varier légèrement.

2. Dans la boîte de dialogue de provagent.cogrcp_insight, cliquez sur OK aprèsavoir sélectionné Open With IBM Cognos RCP Application Updater.

3. En cas d'affichage d'un avertissement relatif à un fichier exécutable, cliquez surOK pour poursuivre l'installation.

Que faire ensuite

Pour plus de détails sur la création d'espaces de travail Cognos Insight et surl'utilisation de Cognos Insight en tant que client pour contribuer aux applications,reportez-vous à la documentation Cognos Insight.

Utilisation de Cognos TM1 Application WebIBM Cognos TM1 Application Web est un client Web utilisé pour la contributionaux applications de planification et l'utilisation des feuilles Web IBM Cognos TM1.

Avant de commencer

Avant de pouvoir utiliser Cognos TM1 Application Web, vous devez disposerd'une application de planification. Le concepteur d'applications identifie les clientsutilisables avec une application particulière.

Conseil : Vous pouvez visualiser les clients que le concepteur a rendu disponiblespour une application cliquant avec le bouton droit sur un noeud de l'applicationlorsqu'elle est affichée dans l'application Web d'IBM Cognos TM1.

Procédure1. Dans Cognos TM1 Application Web, cliquez sur une application de

planification.


2. Cliquez sur Ouvrir Cognos TM1 Application pour lancer le client Cognos TM1Application Web.Pour plus de détails sur la manière de contribuer à une application à l'aide deCognos TM1 Application Web, reportez-vous aux documentations TM1Architect, Perspectives, and TM1 Web et TM1 Applications.

Autres composants Cognos TM1L'installation IBM Cognos TM1 permet d'accéder à de nombreux autrescomposants et peut être personnalisée de nombreuses façons.

Consultez la documentation et les composants suivants pour plus de détails sur lesautres façons d'installer, de déployer et de configurer Cognos TM1 :

Autres composants Cognos TM1

Pour plus d'informations, consultez la documentation des autres composantsCognos TM1.

IBM Cognos TM1 Operations Console

IBM Cognos TM1 Operations Console est un outil utilisé par lesadministrateurs pour superviser l'activité des serveurs TM1 de votreréseau. Pour plus d'informations, voir IBM Cognos TM1 Operations Console.

Génération de scorecard avec IBM Cognos TM1L'utilisation de scorecards avec IBM Cognos TM1 intègre des fonctions descorecard et de gestion de stratégie dans Cognos TM1 pour fournir unemeilleure intégration de la gestion des performances dans la planification.Vous pouvez créer des solutions de scorecard qui comportent desdiagrammes d'incidence interactifs, des cartes stratégiques et desdiagrammes personnalisés qui surveillent vos indicateurs clés deperformance. Pour plus d'informations, voir IBM Cognos TM1 PerformanceModeler.

Intégration de Cognos TM1 à un autre logiciel IBM Cognos

Consultez le chapitre relatif à l'«intégration de Cognos TM1 à un autre logiciel IBMCognos» pour plus de détails sur les manières suivantes d'intégrer Cognos TM1 àun autre logiciel IBM Cognos.

Sécurité IBM Cognos Analytics

Vous pouvez configurer le serveur Cognos TM1 pour authentifier lesutilisateurs à l'aide de la sécurité IBM Cognos Analytics.

Génération de rapports IBM Cognos Analytics

Vous pouvez configurer IBM Cognos Analytics pour qu'il accède auxserveurs et aux cubes Cognos TM1 depuis des applications CognosAnalytics telles que Cognos Report Studio et Cognos Query Studio.

iWidgets dans IBM Cognos Workspace

Vous pouvez afficher des objets de données d'IBM Cognos TM1 Web, telsque des vues de cube, des graphiques et des feuilles Web en tantqu'iWidgets dans IBM Cognos Workspace.

IBM Planning Analytics for Microsoft Excel


Utilisez IBM Planning Analytics for Microsoft Excel avec les sources dedonnées IBM Cognos TM1 pour saisir et écrire en mode différé des valeursdans les cubes TM1.

IBM Cognos TM1 Package Connector

IBM Cognos TM1 Package Connector sert à importer les packs IBMCognos Framework Manager. Pour plus d'informations, voir IBM CognosTM1 TurboIntegrator.

Configuration des postes client en vue de l'exportation des donnéesCognos TM1 au format PDF

Pour exporter des données IBM Cognos TM1 au format Adobe PDF depuis desapplications client IBM Cognos TM1 qui s'exécutent sous Microsoft Windows,définissez PDFCamp comme votre imprimante par défaut. Cette procédures'applique à IBM Cognos TM1 Perspectives, IBM Cognos TM1 Architect et IBMCognos TM1 Web.

Avant de commencer

Assurez-vous que PDFCamp est correctement installé en vérifiant que PDFCampPrinter Driver existe dans la configuration Windows, Imprimantes et télécopieurs.

Procédure1. Dans Windows, ouvrez la fenêtre de configuration Imprimantes et

télécopieurs.2. Cliquez avec le bouton droit sur PDFCamp Printer Driver et sélectionnez

Définir comme imprimante par défaut.


Chapitre 8. Installation de Cognos TM1 Server

Aidez-vous de cette section pour installer et configurer IBM Cognos TM1 AdminServer et IBM Cognos TM1 Server sur un ordinateur dédié avec le systèmed'exploitation Microsoft Windows, UNIX ou Linux.

Le serveur Cognos TM1 Admin Server peut résider sur le même ordinateur queCognos TM1 Server, ou sur un autre ordinateur du réseau.

Les composants serveur peuvent être installés sur des ordinateurs MicrosoftWindows 32 bits ou 64 bits. Dans le cas des systèmes d'exploitation UNIX et Linux,seuls les ordinateurs 64 bits sont pris en charge.

Pour plus de détails sur les scénarios et les options de déploiement, voir«Déploiement de Cognos TM1 Admin Server et de TM1 Server», à la page 34.

Composants serveur

Les composants serveur de Cognos TM1 sont les suivants :v Serveur Admin Cognos TM1 - obligatoirev Cognos TM1 Server - obligatoirev Outils Cognos TM1 - facultatif

Dans le programme d'installation, ces composants sont regroupés sous le niveau dedonnées TM1.

IBM Cognos Configuration

Par défaut, IBM Cognos Configuration est également installé avec les composantsrequis sous Windows, UNIX et Linux en tant que principal outil de gestion deCognos Admin Server et de Cognos TM1 Server. Cet outil fournit une interfaceutilisateur pour l'arrêt et le démarrage des composants serveur.

Installation de Cognos TM1 Server sous WindowsVous pouvez installer les composants serveur Cognos TM1 sur des ordinateursMicrosoft Windows 32 bits ou 64 bits. Utilisez ce type d'installation pour installeret exécuter le serveur Cognos TM1 sur un ordinateur dédié accessible auxutilisateurs distants.Concepts associés:«Mise à niveau de Cognos TM1 Server sous Windows», à la page 50Vous pouvez mettre à jour les composants serveur Cognos TM1 sur desordinateurs Microsoft Windows 32 bits ou 64 bits.

Installation des composants de Cognos TM1 Server sousWindows

Installez les composants serveur IBM Cognos TM1 Server sur un ordinateurfonctionnant sous Microsoft Windows.


Procédure1. Sélectionnez le programme d'installation qui correspond au type de l'ordinateur

utilisé pour Cognos TM1 Server :v Cognos TM1 32 bits pour Windowsv Cognos TM1 64 bits pour Windows

2. Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008, cliquezavec le bouton droit sur le fichier issetup.exe, puis cliquez sur Exécuter entant qu'administrateur. Dans le cas des autres systèmes d'exploitation, cliquezdeux fois sur le fichier issetup.exe pour lancer l'assistant d'installation.

3. Suivez les instructions de l'assistant d'installation et passez à la page Sélectiondes composants.

4. Désélectionnez tous les composants. Par défaut, tous les composants sontsélectionnés au départ.

5. Développez Niveau de données TM1 et sélectionnez les composants suivants :v TM1 Server

v Serveur admin TM1

v Outils TM1 - Facultatifv Echantillons TM1 - Facultatif

6. Suivez la procédure de l'assistant d'installation pour terminer l'installation.7. Sur la page Terminer de l'assistant d'installation, cliquez sur Terminer.

Utilisation de Cognos Configuration pour démarrer lesserveurs Cognos TM1 sous Windows

Avant de pouvoir utiliser Cognos TM1 Server, vous devez démarrer IBM CognosTM1 Admin Server dans IBM Cognos Configuration. Les serveurs qui s'exécutentautomatiquement dans un environnement Microsoft Windows sont appelés"services".


Par défaut, Cognos Configuration enregistre les composants serveur TM1 pourqu'ils s'exécutent en tant que services Windows sous le compte prédéfini systèmelocal. Cependant, les composants TM1 doivent être exécutés sous un utilisateurspécifique.

Important : Modifiez les services Cognos TM1 suivants créés par CognosConfiguration pour qu'ils s'exécutent sous un compte utilisateur spécifique sousMicrosoft Windows :v Cognos TM1 Admin Serverv Cognos TM1 Server

Pour plus d'informations, voir «Comptes utilisateur pour l'exécution des servicesCognos TM1 sous Windows», à la page 18.

Procédure1. S'il n'est pas encore actif, démarrez l'outil de configuration en cliquant sur

Démarrer > Tous les programmes > IBM Cognos TM1 > IBM CognosConfiguration.

A faire : Cliquez avec le bouton droit et sélectionnez Exécuter en tantqu'administrateur sous Windows Vista, Windows 7 et Windows Server 2008.


2. Dans la sous-fenêtre Explorateur de Cognos Configuration, développezConfiguration locale > Environnement.

3. Cliquez avec le bouton droit de la souris sur chaque serveur à démarrer, etsélectionnez Démarrer :a. TM1 Admin Server

Conseil : L'outil Cognos Configuration vous invite à enregistrer lesmodifications que vous avez éventuellement apportées aux paramètres deconfiguration. Ce processus est plus long lors du premier enregistrementd'un paramètre, car différents éléments, notamment les réglagescryptographiques, sont alors mis en place. Cliquez sur Oui en réponse aumessage vous invitant à enregistrer les paramètres. Ce type de messages'affiche aussi lorsque vous fermez Cognos Configuration.

4. Développez le noeud Accès aux données > TM1 Server et cliquez avec lebouton droit sur chaque serveur de base de données d'exemple Cognos TM1 àdémarrer, puis sélectionnez Démarrer. Par exemple, démarrez les bases dedonnées qui ont été fournies comme exemple :a. SData

b. Planning Sample

c. GO_New_Stores

5. Cliquez sur Fichier > Enregistrer.6. Modifiez les entrées des composants Cognos TM1 dans les Services Windows

pour qu'ils s'exécutent sous un compte utilisateur spécifique.Pour plus d'informations, voir «Modification des services Cognos TM1 en vuede leur fonctionnement sous un compte utilisateur spécifique sous Windows».

Modification des services Cognos TM1 en vue de leurfonctionnement sous un compte utilisateur spécifique sousWindows

Lorsque vous utilisez IBM Cognos Configuration pour gérer les services CognosTM1, vous devez modifier le compte utilisateur par défaut qui exécute les servicesMicrosoft Windows de Cognos TM1 Admin Server et des serveurs Cognos TM1que vous démarrez avec Cognos Configuration. Par défaut, Cognos Configurationenregistre ces services sous le compte prédéfini système local de MicrosoftWindows. Cependant, ces services doivent être modifiés de façon qu'ils s'exécutentsous un compte utilisateur spécifique.

Avant de commencer

Vérifiez les privilèges qui sont requis pour un compte utilisateur autre que lecompte système local. Pour plus d'informations, voir «Comptes utilisateur pourl'exécution des services Cognos TM1 sous Windows», à la page 18.


Utilisez les services Windows pour modifier le compte utilisateur d'un composantCognos TM1 configuré pour s'exécuter en tant que service.

Procédure1. Ouvrez IBM Cognos Configuration.2. Développez l'arborescence Explorateur > Configuration locale :

a. Développez le noeud Configuration locale > Environnement.

Chapitre 8. Installation de Cognos TM1 Server 79

b. Développez le noeud Accès aux données > TM1 Server.3. Cliquez sur chaque composant Cognos TM1 à modifier et sélectionnez Arrêter.v TM1 Admin Server

v Nom de l'instance Cognos TM1 Server - nom de chaque serveur disponibledans Cognos Configuration.

Conseil : Il n'est pas nécessaire d'arrêter le composant TM1 ApplicationServer.

4. Ouvrez les services Windows.5. Localisez le composant Cognos TM1 à mettre à jour et modifiez le compte

utilisateur du service Windows qui l'exécute :a. Cliquez avec le bouton droit de la souris sur le service, sélectionnez

Propriétés, puis cliquez sur l'onglet Connexion.b. Entrez un nouveau nom d'utilisateur et un mot de passe pour le service.c. Répétez ces étapes pour tous les autres composants Cognos TM1 s'exécutant

en tant que service Windows et que vous voulez modifier.6. Fermez les services Windows.7. Dans Cognos Configuration, redémarrez chaque service à modifier :

Cliquez avec le bouton droit de la souris sur l'élément et sélectionnezDémarrer..

8. Fermez Cognos Configuration.

Installation de Cognos TM1 Server sous UNIX ou LinuxVous pouvez installer les composants serveur Cognos TM1 Sever sur un ordinateur64 bits fonctionnant avec un système d'exploitation UNIX ou Linux. Utilisez cetype d'installation pour installer et exécuter le serveur Cognos TM1 sur unordinateur dédié accessible aux utilisateurs distants.

Gestion des composants après l'installation

Une fois l'installation terminée, vous gérez les serveurs à exécuter à l'aide d'IBMCognos Configuration. Vous pouvez également utiliser les scripts de démarrage etd'arrêt fournis avec l'installation.

Accès au données et affichage

Pour afficher les données stockées dans un serveur Cognos TM1 sous UNIX etinteragir avec elles, utilisez un client Cognos TM1 sur un ordinateur MicrosoftWindows.

Conseil : Vous pouvez utiliser Cognos TM1 Architect sur un ordinateur MicrosoftWindows pour vous connecter à distance à un serveur sur un système UNIX.Concepts associés:«Mise à niveau de Cognos TM1 Server sous UNIX ou Linux», à la page 50Vous pouvez mettre à niveau les composants serveur Cognos TM1 sur unordinateur 64 bits fonctionnant avec un système d'exploitation UNIX ou Linux.

Installation des composants Cognos TM1 Server sous UNIXou Linux

Utilisez l'assistant d'installation pour sélectionner les composants serveur àinstaller, ainsi que l'emplacement approprié sur votre ordinateur.


Pour obtenir la liste complète des systèmes d'exploitation UNIX et Linux pris encharge, voir Software Environments for IBM Planning Analytics 2.0 Local(http://www.ibm.com/support/docview.wss?uid=swg27049052).

Avant de commencer

Lorsque vous installez Cognos TM1 sur des systèmes d'exploitation UNIX ouLinux, configurez les composants pour qu'ils s'exécutent en tant qu'utilisateurdisposant des droits appropriés pour les binaires Cognos TM1 et les bases dedonnées TM1.

Pour préparer l'installation de Cognos TM1, effectuez les tâches décrites dans laliste de contrôle suivante :v Familiarisez-vous avec les termes et concepts employés dans Cognos TM1.

Reportez-vous aux documentations TM1 Architect, Perspectives, and TM1 Web etTM1 for Developers.

v Décidez quels composants vous souhaitez installer et comment ils devront êtrerépartis dans votre environnement matériel.

A faire : Seuls les composants serveur Cognos TM1 peuvent fonctionner sousUNIX ou Linux. Les clients Cognos TM1 ne peuvent pas être exécutés sousUNIX.Pour plus d'informations sur la création d'un environnement TM1 optimal, voirChapitre 3, «Architecture», à la page 21 et Chapitre 4, «Déploiement», à la page33.

v Identifiez vos besoins en matériel et logiciels.Passez en revue la liste à jour des environnements pris en charge par CognosTM1, ainsi que les informations sur les systèmes d'exploitation, les correctifs, lesserveurs Web et les navigateurs Web, à la page Software Environments for IBMPlanning Analytics 2.0 Local (http://www.ibm.com/support/docview.wss?uid=swg27049052).Si vous avez l'intention d'importer des données depuis une autre base dedonnées relationnelle, commencez par installer le logiciel de base de données.Si vous exécutez Oracle sous UNIX, installez le logiciel client UNIX appropriépour votre base de données Oracle sur l'ordinateur UNIX. Servez-vous del'assistant de configuration de réseau Oracle (Oracle Network ConfigurationAssistant) pour spécifier un nom de service de réseau local.

v Installez votre propre copie de Java Runtime Environment (JRE). L'installationCognos TM1 ne fournit pas d'environnement d'exécution Java pour lesinstallations UNIX.

v Vérifiez le logiciel de serveur X sur votre machine UNIX.Pour exécuter l'assistant d'installation de l'interface utilisateur graphique pourUNIX, vous devez avoir installé un logiciel serveur X sur l'ordinateur qui seral'hôte de vos composants TM1. Vous devez avoir installé un logiciel de client deserveur X sur l'ordinateur sur lequel vous exécuterez l'assistant d'installationTM1. Si le logiciel de serveur X n'est pas installé sur l'ordinateur UNIX, exécutezl'installation par la console.Si vous n'utilisez pas X-server, exécutez une installation sans surveillance. Pourplus d'informations, voir Annexe C, «Définitions d'installations et deconfigurations sans surveillance», à la page 389.

v Installez et configurez les composants Cognos TM1 pour une exécution en tantqu'utilisateur disposant des droits appropriés pour les binaires Cognos TM1 etles bases de données TM1.


http://www-01.ibm.com/support/docview.wss?uid=swg27049052



Procédure1. Accédez au répertoire dans lequel les fichiers d'installation ont été téléchargés

et extraits, ou insérez le disque du produit.2. Accédez au répertoire du système d'exploitation, puis entrez :

./issetup

3. Suivez les instructions de l'assistant d'installation et copiez les fichiers requissur votre ordinateur.

4. Sélectionnez les composants à installer. Par défaut, tous les composants sontinstallés.

5. Sur la page Terminer de l'assistant d'installation, cliquez sur Terminer.6. Si vous installez le serveur IBM Cognos TM1 Application sous Linux avec un

environnement d'exécution Java Sun, vous devez également réaliser lesopérations suivantes pour installer d'autres fichiers Xerces requis.a. Accédez à la page de téléchargement du site Web Xerces,

http://xerces.apache.org/mirrors.cgi.b. Téléchargez la distribution binaire pour Java : Xerces-J-bin.2.11.0.zip.c. Décompressez xercesImpl.jar et xml-apis.jar, et copiez-les dans votre

répertoire d'installation répertoire_install_TM1/webapps/pmpsvc/WEB-INF/lib.

d. Redémarrez le service TM1 Applications.

Mise à jour de l'environnement JavaPour pouvoir démarrer IBM Cognos Configuration sur les systèmes d'exploitationUNIX et Linux, vous devez définir la variable d'environnement JAVA_HOME.

Procédure

Vérifiez que la variable d'environnement JAVA_HOME pointe vers un emplacementde JRE valide.

Démarrage de Cognos Configuration sur les systèmesd'exploitation UNIX ou LinuxUtilisez IBM Cognos Configuration pour configurer les composants Cognos TM1 etpour démarrer et arrêter les services.

Avant de commencer

Vous devez avoir défini la variable d'environnement JAVA_HOME avant dedémarrer IBM Cognos Configuration.

Procédure

Accédez au répertoire répertoire d'installation/bin64, puis entrez :./cogconfig.sh

Démarrage de Cognos TM1 Server sous UNIXVous pouvez utiliser IBM Cognos Configuration pour démarrer et arrêter lesserveurs Cognos TM1 sous UNIX ou Linux. Vous pouvez également utiliser lesscripts de démarrage et d'arrêt fournis avec l'installation.


http://xerces.apache.org/mirrors.cgi


Sous UNIX, vous pouvez également utiliser les commandes et les scripts suivantspour arrêter et démarrer les composants serveur de Cognos TM1. Pour plusd'informations, reportez-vous aux rubriques «Démarrage d'un serveur UNIX TM1»et «Arrêt d'un serveur UNIX TM1» dans la documentation TM1 Operations.v startup_tm1admsrv.sh - Démarre Cognos TM1 Admin Serverv shutdown_tm1admsrv.sh- Arrête Cognos TM1 Admin Serverv startup_tm1s.sh- Démarre Cognos TM1 Serverv tm1srvstop.exe - Utilitaire destiné à l'arrêt d'un serveur Cognos TM1v shutdown_tm1s.sh - Autre méthode pour arrêter un serveur Cognos TM1v startup_pmpsvc.sh - Démarre Cognos TM1 Application Serverv shutdown_pmpsvc.sh - Arrête Cognos TM1 Application Server

Procédure1. Démarrez IBM Cognos Configuration.2. Dans la fenêtre Explorateur, cliquez sur Configuration locale >

Environnement.3. Cliquez avec le bouton droit de la souris sur Cognos TM1 Admin Server, puis

sur Démarrer.4. Sous Accès aux données > Cognos TM1 Server, cliquez avec le bouton droit

sur un serveur, puis cliquez sur Démarrer.

Exécution de Cognos TM1 sous IBM AIXCette section décrit les points techniques à prendre en compte en cas d'exécutionde Cognos TM1 sur le système d'exploitation IBM AIX.

Configuration des limites de ressources mémoire d'IBM AIX pourCognos TM1Si vous exécutez IBM Cognos TM1 sous IBM AIX, vous devez vérifier les limitesde ressources mémoire AIX pour voir s'il y a suffisamment de mémoire pourCognos TM1.

Cognos TM1 est configuré de façon à exploiter la quantité maximale de mémoiredisponible du système d'exploitation IBM AIX, en fonction du paramètre de limitephysique de ressources mémoire AIX. Pour vérifier la limite physique définie surAIX, utilisez la commande AIX ulimit comme suit :

ulimit -d -H

Si vous bénéficiez de droits d'accès utilisateur root, vous pouvez modifier la limitephysique à l'aide de cette commande. Pour plus d'informations sur l'utilisation dela commande ulimit, consultez la documentation AIX.

Optimisation des performances de Cognos TM1 sous IBM AIXSi vous utilisez IBM Cognos TM1 sous IBM AIX, optimisez votre environnementpour améliorer vos performances.

Des tests montrent que les modifications décrites dans cette rubrique peuvententraîner une amélioration des performances de 5 à 25 %, en fonction del'application et de son utilisation, par rapport aux versions antérieures de TM1.


Variables d'environnement

Les variables d'environnement suivantes sont applicables à toutes les éditions deTM1 sous AIX à partir de septembre 2014.export AIXTHREAD_SCOPE=Sexport AIXTHREAD_MNRATIO=1:1export MALLOCOPTIONS=multiheap:32,pool:0x20000000export SPINLOOPTIME=300export AIXTHREAD_MUTEX_FAST=ONexport LDR_CNTRL=DATAPSIZE=16M@TEXTPSIZE=16M@STACKPSIZE=16Mexport AIXTHREAD_AFFINITY=first-touchexport MEMORY_AFFINITY=MCMexport OBJECT_MODE=64 export YIELDLOOPTIME=0

Gestionnaire de mémoire virtuelle

Le gestionnaire de mémoire virtuelle (VMM) doit être paramétré en fonction de lataille et du nombre de grandes pages à réserver. Seuls les utilisateurs root ou ceuxqui disposent des privilèges nécessaires peuvent paramétrer le gestionnaire demémoire virtuelle. Consultez la documentation AIX pour connaître l'ensemble desoptions vmo utilisables pour affiner les paramètres VMM.

Remarque : L'activation des grandes pages augmente la mémoire de TM1 Serverde 10 à 15 %.

La commande suivante active les grandes pages avec les paramètres suggérés pourTM1 Server :vmo -o lgpg_regions=2000 -o lgpg_size=16777216

Pour accorder des privilèges aux utilisateurs non root, utilisez la commandesuivante :chuser capabilities=CAP_BYPASS.RAC_VMM,CAP_PROPAGATE userid

Pour vérifier que les grandes pages sont activées pour TM1 Server, exécutez lacommande suivante :ps -Zdef | grep tm1

Activation de l'alignement d'objets pour la plateforme IBM Power

Le paramètre CacheFriendlyMalloc du fichier tm1s.cfg active l'alignement demémoire spécifique à la plateforme Power. Les tests montrent que l'activation decette option donne les meilleurs résultats pour les scénarios d'utilisationimpliquant un grand nombre d'utilisateurs. Pour ceux qui impliquent un seul ouquelques utilisateurs, le bénéfice peut être faible ou nul. Cette option est désactivéepar défaut. Pour l'activer, ajoutez la ligne suivante au fichier tm1s.cfg :CacheFriendlyMalloc=T

Utilisation des commandes IBM AIX qui n'acceptent pas lesnoms de fichier pour les objets de contrôle Cognos TM1Certaines commandes du système d'exploitation IBM AIX, comme sysck, ne sontpas compatibles avec les noms de fichier des objets de contrôle IBM Cognos TM1commençant par une accolade fermante (}).

Par exemple, les objets de contrôle Cognos TM1 portent généralement des noms defichier tels que }Clients.dim, }Groups.dim ou }ClientsGroups.cub.


Ce problème concerne toutes les commandes IBM AIX standards qui lisent lesnoms de fichiers depuis stdin, y compris les commandes et les outils AIX chargésde sauvegarder les données. Ces commandes AIX échouent et génèrent une erreurlorsqu'elles sont émises avec ces fichiers Cognos TM1.

Noms d'objet TM1 et codage des caractères pour les serveursTM1 sous UNIX et Windows

Respectez les instructions suivantes pour assurer un codage correct et cohérent descaractères des noms d'objets Cognos TM1 comme les cubes, les vues, lesdimensions et les sous-ensembles.

Transfert des bases de données Cognos TM1 entre dessystèmes Windows et UNIXNe transférez pas manuellement les fichiers de base de données Cognos TM1 d'unsystème Microsoft Windows vers un système UNIX (ou vice-versa) lorsque lesnoms d'objet Cognos TM1 contiennent des caractères non ASCII (ne figurant pasdans le jeu de 128 caractères ASCII d'origine).

Au lieu de transférer manuellement les fichiers, utilisez l'utilitaire tm1xfer pourdéplacer les données TM1 d'une plateforme à une autre.

utilitaire tm1xfer

L'utilitaire tm1xfer compresse et déplace les objets du serveur TM1 d'uneplateforme à une autre, tout en conservant les noms d'objet en casse mixte à la foissur les plateformes Microsoft Windows et UNIX. Pour plus d'informations,consultez la rubrique «tm1xfer» du document TM1 Operations.

Transfert manuel des fichiers

Le transfert manuel des fichiers s'avère délicat du fait d'une incompatibilitééventuelle du codage ou du mappage des caractères entre ces deux plateformes. Lesystème d'exploitation Windows stocke les noms de répertoire et de fichier auformat UTF-16 alors que le système d'exploitation UNIX peut stocker les nomssous différents codages en fonction des paramètres régionaux utilisés.

Par exemple, les noms d'objet Cognos TM1 des cubes et des dimensionscomportant des caractères non ASCII risquent de ne pas s'afficher correctementdans les applications clientes Cognos TM1 si les fichiers de base de donnéesCognos TM1 ont été copiés d'une plateforme, et exécutés sur une autre qui utilisaitun codage différent.

Utilisez le même paramètre régional que le système UNIX lors dudémarrage d'un serveur Cognos TM1 dont le nom contient descaractères non ASCIISi vos noms d'objet Cognos TM1 (cubes, vues, dimensions, sous-ensembles, etc.)comportent des caractères non ASCII, utilisez le même paramètre régional en casde démarrage d'un serveur Cognos TM1 sur un système UNIX.

Ceci garantit que les noms d'objet Cognos TM1 et les noms de répertoires et defichiers Cognos TM1 associés sur le système UNIX utilisent toujours le mêmecodage des caractères. Le démarrage d'un serveur Cognos TM1 avec un paramètrerégional différent de celui avec lequel ont été créés et stockés les noms d'objetCognos TM1 risque de corrompre leur affichage.


Par exemple, les noms d'objet Cognos TM1 (cubes et dimensions) qui ont étéenregistrés alors que le serveur s'exécutait avec le paramètre régional en_US nes'afficheront probablement pas bien si le serveur est redémarré avec le paramètrerégional ja_JP.

Configuration de la langue de Cognos TM1IBM Cognos TM1 configure automatiquement la langue de Cognos TM1 Server,des interfaces utilisateur client et des messages en détectant la langue en cours ducompte utilisateur du système d'exploitation ou celle du navigateur Web danslequel il est exécuté. Vous pouvez remplacer cette configuration automatique etconfigurer Cognos TM1 pour qu'il utilise l'une des langues prises en charge.

Pour en savoir plus sur les langues prises en charge, voir «Codes de langueCognos TM1», à la page 87.

Détection automatique de la langue

Cognos TM1 utilise le processus suivant pour détecter et configurerautomatiquement la langue au moment de l'exécution :1. Le serveur et les clients Cognos TM1 qui s'exécutent dans Microsoft Windows

tentent de détecter et d'utiliser la langue configurée dans les paramètresrégionaux du système d'exploitation de l'utilisateur en cours. Sous Windows, ceparamétrage se fait dans Région et Langue. Cette langue sera utilisée si ellecorrespond à l'une des langues prises en charge.

Important : Par défaut, les instances de Cognos TM1 Server que vous démarrezdans IBM Cognos Configuration sont initialement configurées pour s'exécuteren tant que service Windows utilisant le compte utilisateur système local, quiest un compte Windows réservé. Si vous désirez que Cognos TM1 Server utiliseune langue associée à un compte utilisateur spécifique, modifiez le service pourqu'il s'exécute sous cet utilisateur, et configurez la langue de celui-ci dans lepanneau Région et langue de Windows. Pour plus d'informations, voir«Modification des services Cognos TM1 en vue de leur fonctionnement sous uncompte utilisateur spécifique sous Windows», à la page 79.

2. Les composants serveur et client recherchent également l'existence d'une languede substitution basée sur le paramètre de configuration Language de CognosTM1 :v Le serveur vérifie le paramètre Language dans le fichier de configuration

Tm1s.cfg. Si un code de langue valide est configuré, la languecorrespondante utilisée pour les messages du serveur.

v Les composants client vérifient le paramètre Language dans le fichier deconfiguration Tm1p.ini. Si un code de langue valide est configuré, la languecorrespondante utilisée pour l'interface utilisateur.

3. Si la langue configurée dans l'un des paramètres ci-dessus n'est pas prise encharge, l'anglais est utilisé.


Configuration de la langue des composants Cognos TM1

Les langues des composants Cognos TM1 suivants sont définies séparément.

Tableau 14. Récapitulatif de la configuration des langues des composants Cognos TM1

Composant Configuration de la langue

Cognos TM1 Server Utilisez le paramètre Language dans le fichier Tm1s.cfgpour configurer une langue spécifique pour un serveurCognos TM1.

Pour obtenir des détails, voir «Configuration de la languedu serveur Cognos TM1», à la page 88.

Cognos TM1 Architect,

Cognos TM1 Perspectives

Utilisez le paramètre Language dans le fichier Tm1p.inipour configurer une langue spécifique pour les clientsCognos TM1 qui s'exécutent sur Microsoft Windows.

Pour plus de détails, voir «Configuration de la langue desclients Cognos TM1 sous Windows», à la page 88.

Cognos TM1 Web Utilisez les paramètres de langue dans votre navigateurWeb pour sélectionner une langue spécifique pour CognosTM1 Web.

Pour plus de détails, voir «Configuration de la langue dunavigateur Web pour Cognos TM1 Web», à la page 89.

Codes de langue Cognos TM1Le tableau suivant récapitule les codes de langue pour les langues prises en chargedans IBM Cognos TM1.

Language Code

Portugais (Brésil) bra

Croate hrv

Tchèque csy

Chinois (simplifié) sch

Chinois (traditionnel) tch

Danois dan

Néerlandais nld

Allemand deu

Finnois fin

Français fra

Hongrois hun

Italien ita

Japonais jpn

Kazakh kaz

Coréen kor

Norvégien nor

Polonais pol

Roumain rom

Russe rus


Language Code

Espagnol esp

Slovène vli

Suédois sve

Thaï tha

Turc trk

Configuration de la langue du serveur Cognos TM1Utilisez le paramètre Language dans le fichier Tm1s.cfg pour configurer une languespécifique pour un serveur IBM Cognos TM1.


Le paramètre de configuration Language de Cognos TM1 Server commande lalangue des messages générés par le serveur. Il s'applique aussi à l'interface de laboîte de dialogue lorsque vous exécutez le serveur en tant qu'application, et nonen tant que service Windows.

Pour en savoir plus sur le paramètre Language de Cognos TM1 Server, voir leparamètre Language du fichier Tm1s.cfg.

Remarque : Pour que Cognos TM1 Server utilise une langue en fonction d'uncompte utilisateur et non du paramètre Language, modifiez le service MicrosoftWindows de Cognos TM1 Server pour qu'il s'exécute sous un utilisateur spécifique.Pour plus d'informations, voir «Modification des services Cognos TM1 en vue deleur fonctionnement sous un compte utilisateur spécifique sous Windows», à lapage 79.

Procédure1. Ouvrez le fichier de configuration de Cognos TM1 Server, Tm1s.cfg, dans un

éditeur de texte.Pour connaître son emplacement, voir «Emplacement du fichier tm1s.cfg», à lapage 311.

2. Modifiez ou ajoutez le paramètre Language avec le code de la langue à utiliser.Par exemple :Language=deu

Pour obtenir la liste des codes de langue pris en charge, voir «Codes de langueCognos TM1», à la page 87.

3. Enregistrez et fermez le fichier Tm1s.cfg.4. Redémarrez le serveur Cognos TM1.

Configuration de la langue des clients Cognos TM1 sousWindows

Utilisez le paramètre Language dans le fichier Tm1p.ini pour configurer unelangue spécifique pour les clients IBM Cognos TM1 qui s'exécutent sur MicrosoftWindows, tels que Cognos TM1 Architect et Cognos TM1 Perspectives.



Pour en savoir plus sur ce paramètre, voir les informations sur le paramètre delangue dans le fichier Tm1p.ini..

Remarque : Le paramètre Language pour les clients Cognos TM1 est distinct duparamètre du même nom pour le serveur Cognos TM1.

Procédure1. Ouvrez le fichier de configuration du client Cognos TM1, Tm1p.ini, dans un

éditeur de texte.Pour connaître son emplacement, voir «Emplacement du fichier Tm1p.ini», à lapage 377.

2. Modifiez ou ajoutez le paramètre Language avec le code de la langue à utiliser.Par exemple :Language=sch

Pour obtenir la liste des codes de langue pris en charge, voir «Codes de langueCognos TM1», à la page 87.

3. Enregistrez et fermez le fichier Tm1p.ini.4. Redémarrez le client Cognos TM1.

Configuration de la langue du navigateur Web pour CognosTM1 Web

Les paramètres linguistiques définis dans votre navigateur Web déterminent lalangue utilisée dans l'interface IBM Cognos TM1 Web.


Suivez la procédure générale ci-dessous pour configurer Microsoft InternetExplorer et Mozilla Firefox de sorte qu'IBM Cognos TM1 Web s'affiche dans votrelangue principale. Pour des informations plus détaillées, consultez ladocumentation de votre navigateur.

Procédure1. Selon le navigateur Web que vous utilisez, utilisez les options de langue

disponibles pour sélectionner et configurer votre langue principale.v Dans Internet Explorer, les options de langue se trouvent généralement dans

le menu Tools > Internet Options > General > Languages.v Dans Firefox, les options de langue se trouvent généralement dans le menu

Tools > Options > Content > Languages.2. Ajoutez votre langue à la liste des langues.3. Organisez la liste de façon que la langue souhaitée soit la première.

Création d'un nouveau serveur Cognos TM1 vide dans CognosConfiguration

Vous pouvez utiliser IBM Cognos Configuration pour créer un nouveau serveurCognos TM1 vide.



Cette procédure crée le fichier de configuration tms.cfg, et d'autres fichiers requispour une nouvelle instance vide de Cognos TM1 Server. N'effectuez cetteprocédure que dans un répertoire vide, ne contenant aucun autre fichier.

Conseil : Pour ajouter une instance existante de TM1 Server à CognosConfiguration, voir «Ajout d'un serveur Cognos TM1 existant dans CognosConfiguration», à la page 91.

Procédure1. Utilisez le système d'exploitation pour créer un dossier vide pour les

nouveaux fichiers de Cognos TM1 Server.2. Ouvrez IBM Cognos Configuration.3. Dans le panneau Explorateur, sous Accès aux données, cliquez avec le bouton

droit sur TM1 Server, et cliquez sur Nouvelle ressource > Instances de TM1Server.

4. Dans la zone Nom, saisissez le nom de votre serveur.5. Dans la zone Type, sélectionnez TM1 Server instance, puis cliquez sur OK.

Le nouveau serveur est ajouté sous le noeud TM1 Server et ses propriétéssont affichées dans la liste Instances de TM1 Server - Propriétés desressources.

6. Dans la liste Propriétés des ressources, cliquez sur la zone de saisie, puis surl'icône Editer.

7. Entrez le chemin du dossier vide dans lequel vous souhaitez créer le nouveauserveur Cognos TM1, ou naviguez jusqu'à lui.

Conseil : N'incluez pas le nom du fichier dans ce chemin. Ne sélectionnez quele dossier.

8. Cliquez sur le bouton Sélectionner.9. Cliquez sur Fichier > Enregistrer.

Un nouveau fichier tms.cfg est automatiquement créé dans le dossier. Lesvaleurs des paramètres de configuration suivants sont automatiquementajoutées au fichier.v La valeur du paramètre ServerName est le nom de serveur que vous avez

entré.v La valeur du paramètre DataBaseDirectory est le répertoire de données que

vous avez entré.v La valeur du paramètre PortNumber est un numéro de port généré

automatiquement de manière aléatoire.10. Si vous utilisez cette base de données avec Cognos TM1 Applications, entrez

les valeurs nécessaires dans le fichier tms.cfg. Pour plus d'informations, voir«Configuration d'un serveur Cognos TM1 en vue de son utilisation avecCognos TM1 Application Web», à la page 142.

11. Dans le panneau Explorateur de Cognos Configuration, cliquez avec le boutondroit sur le nouveau serveur, puis cliquez sur Démarrer.Les fichiers de base du nouveau serveur Cognos TM1 sont créés dans ledossier.

12. Pour tester le nouveau serveur Cognos TM1, démarrez Cognos TM1 Architectet connectez-vous à la base de données avec le nom d'utilisateur admin et sansmot de passe.


Ajout d'un serveur Cognos TM1 existant dans Cognos ConfigurationVous pouvez gérer un serveur Cognos TM1 existant en l'ajoutant à IBM CognosConfiguration.

Avant de commencer

Cette procédure implique que vous disposiez déjà d'un répertoire de donnéesCognos TM1 avec un fichier tm1s.cfg valide.

Procédure1. Ouvrez IBM Cognos Configuration.2. Dans le panneau Explorateur, sous Accès aux données, cliquez avec le bouton

droit sur TM1 Server, et cliquez sur Nouvelle ressource > Instances de TM1Server.

3. Dans la zone Nom, entrez le nom défini par le paramètre ServerName dans lefichier tm1s.cfg.

4. Dans la zone Type, sélectionnez TM1 Server instance, puis cliquez sur OK.Le nouveau serveur est ajouté sous le noeud TM1 Server et ses propriétéssont affichées dans la liste Instances de TM1 Server - Propriétés desressources.

5. Dans la liste Propriétés des ressources, cliquez sur la case située à droite deChemin de configuration de TM1 Server et cliquez sur l'icône Modifier.

6. Entrez le chemin du répertoire de données Cognos TM1 existant, ou naviguezjusqu'à lui.

Conseil : N'incluez pas le nom du fichier dans ce chemin. Ne sélectionnez quele dossier.

7. Cliquez sur le bouton Sélectionner.8. Cliquez sur Fichier > Enregistrer.9. Dans le panneau Explorateur de Cognos Configuration, cliquez avec le bouton

droit sur le nouveau serveur, puis cliquez sur Démarrer.10. Pour tester ce serveur Cognos TM1, démarrez Cognos TM1 Architect et

connectez-vous à la base de données.

Définition de l'emplacement de l'hôte Admin de Cognos TM1Vous spécifiez l'emplacement de l'hôte Admin d'IBM Cognos TM1 en fonction desclients (interfaces utilisateur) ou des serveurs distants.


L'hôte Admin est l'ordinateur sur lequel Cognos TM1 Admin Server est exécuté.

Procédure1. Pour spécifier l'hôte Admin référencé par les clients tels que Cognos TM1

Architect ou Cognos TM1 Perspectives :v Modifiez le fichier Tm1p.ini à l'aide du menu Options de Cognos TM1 dans

l'explorateur de serveur.v Vous pouvez également éditer manuellement le paramètre AdminHost dans le

fichier de configuration Tm1p.ini du client.


Pour plus d'informations, voir Annexe B, «Fichier de configuration du clientTm1p.ini», à la page 377.

2. Pour spécifier le nom de l'hôte Admin auprès duquel les serveurs distants sontenregistrés, appliquez l'une des méthodes suivantes :v Editez le paramètre AdminHost dans le fichier Tm1s.cfg.v Utilisez le paramètre de ligne de commande -v quand vous lancez la version

Windows du serveur Cognos TM1.Pour plus d'informations, voir Annexe A, «Fichier de configuration du serveurtm1s.cfg», à la page 311.

Définition de plusieurs hôtes Admin pour Cognos TM1Vous pouvez configurer un client IBM Cognos TM1 pour qu'il référence plusieurshôtes Admin, en intercalant un point-virgule entre chaque nom d'hôte.


Un client définissant plusieurs hôtes Admin peut accéder à tous les serveursCognos TM1 enregistrés sur les serveurs Admin Cognos TM1 de ces hôtes.

Procédure

Pour référencer plusieurs hôtes Admin dans un client tel que Cognos TM1Architect ou Cognos TM1 Perspectives, séparez le nom des hôtes par unpoint-virgule :v Modifiez le fichier Tm1p.ini à l'aide du menu Options de Cognos TM1 dans

l'explorateur de serveur.v Vous pouvez également éditer manuellement le paramètre AdminHost dans le

fichier de configuration Tm1p.ini du client.

Pour plus d'informations, voir Annexe B, «Fichier de configuration du clientTm1p.ini», à la page 377.

Configuration avancée de Cognos TM1 Admin Server et de CognosTM1 Server

Cette section décrit la configuration avancée destinée à personnaliser IBM CognosTM1 en fonction de vos besoins métier et de votre environnement après la fin de laprocédure d'installation initiale.

Modification des ports par défaut pour Cognos TM1 AdminServer

Si vous modifiez les valeurs par défaut dunuméro de port de l'hôte du serveurAdmin TM1 ou du numéro de port SSL du serveur Admin TM1 dans IBMCognos Configuration, vous devez mettre à jour manuellement les nouvellesvaleurs dans le fichier des services UNIX et Microsoft Windows sur tous lesordinateurs concernés dans votre environnement. Ce fichier du systèmed'exploitation n'est pas mis à jour par Cognos TM1.


Mettez à jour le fichier des services du système d'exploitation sur tous lesordinateurs exécutant des composants Cognos TM1 et ayant besoin decommuniquer avec Cognos TM1 Admin Server. Par exemple :


v Cognos TM1 Serverv Des clients Cognos TM1 : Cognos TM1 Architect ou Cognos TM1 Perspectives,

par exemplev Des applications Cognos TM1 personnalisées créées avec l'API de Cognos TM1v Cognos TM1 Web (serveur Web seulement)

Procédure1. Localisez et ouvrez le fichier des services du système d'exploitation.v Pour UNIX, l'emplacement standard du fichier des services est :

/etc/services

v Pour Windows, l'emplacement standard du fichier des services est :C:\WINDOWS\system32\drivers\etc\services

2. Ajoutez les entrées suivantes dans le fichier des services, ou remplacez lesnuméros de port. Par exemple :tm1adminsvr 5400/tcp # Added by IBM Cognos TM1

tm1admsrv_ssl 5403/tcp # Added by IBM Cognos TM1

3. Enregistrez et fermez le fichier.4. Répétez cette procédure sur tous les ordinateurs exécutant des composants

Cognos TM1 et qui communiquent avec Cognos TM1 Admin Server.5. Editez le fichier tm1web_config.xml pour définir le numéro de port du serveur

admin.v Si vous utilisez le protocole SSL, éditez le paramètre AdminHostSSLPort.v Si vous utilisez le protocole SSL, éditez le paramètre AdminHostPort.

Le fichier tm1web_config.xml se trouve dans <répertoire_installation_TM1>\webapps\tm1web\WEB-INF\configuration\.Pour plus d'informations sur le fichier tm1web_config.xml, voir «Edition dufichier de configuration de Cognos TM1 Web», à la page 119 et «Paramètres deconfiguration de Cognos TM1 Web», à la page 113.

Configuration de Cognos TM1 en vue de l'utilisation d'IPv6Pour utiliser IBM Cognos TM1 avec Internet Protocol version 6 (IPv6), vous devezconfigurer des paramètres de Cognos TM1 et une variable d'environnement dusystème d'exploitation.


Par défaut, Cognos TM1 utilise IPv4.

Vous pouvez configurer dans Cognos TM1 l'utilisation de l'un des modes suivants,pour définir le protocole IP que Cognos TM1 doit utiliser avec votre réseau.

ipv4 Valeur par défaut. Utilisée pour les réseaux IPv4.

dual Utilisée comme transition entre IPv4 et IPv6. Les deux protocoles sont prisen charge.

ipv6 Utilisée pour les réseaux IPv6.

Procédure1. Configurez le serveur de Cognos TM1 Admin Server :

a. Sur l'ordinateur sur lequel Cognos TM1 Admin Server est exécuté, ouvrezCognos Configuration.


b. Développez le noeud Configuration locale > Environnement, puis cliquezsur TM1 Admin Server.

c. Dans la sous-fenêtre Propriétés des composants, choisissez Double (IPv4 etIPv6), IPv4 ou IPv6 pour l'option Prise en charge IP de TM1 AdminServer.

d. Si nécessaire, ajoutez l'adresse IPv6 au fichier du système d'exploitation/etc/hosts sous UNIX et Microsoft Windows. Dans certains cas, selonl'environnement réseau et la configuration du DNS, vous devrez peut-êtreeffectuer également l'opération suivante pour que Cognos TM1 AdminServer et Cognos TM1 Server puissent être exécutés en mode IPv6.

e. Ajoutez la variable d'environnement TM1_IPVersion, comme indiqué àl'étape 3.

2. Configurez le serveur Cognos TM1 :a. Sur l'ordinateur sur lequel Cognos TM1 Server est exécuté, ouvrez le fichier

tm1s.cfg.b. Affectez au paramètre IPversion le mode IP à utiliser.

Par exemple, pour indiquer que votre réseau utilise le protocole IPv6,ajoutez le paramètre de la façon suivante :IPVersion=ipv6

Pour plus de détails, voir «IPVersion», à la page 335.c. Si nécessaire, ajoutez l'adresse IPv6 au fichier du système d'exploitation

/etc/hosts sous UNIX et Microsoft Windows.d. Ajoutez la variable d'environnement TM1_IPVersion, comme indiqué à

l'étape 3.3. Ajoutez la variable d'environnement TM1_IPVersion au système d'exploitation

sur chaque ordinateur qui communique directement avec Cognos TM1 Serveret/ou Admin Server.Respectez le nom et le format suivant pour définir cette variable :TM1_IPVersion=ip_mode

où mode_ip peut être l'une des valeurs suivantes :v Dual

v IPv6

v IPv4

La variable d'environnement TM1_IPVersion est requise sur tous les ordinateursexécutant l'un des composants Cognos TM1 suivants :v Cognos TM1 Admin Serverv Cognos TM1 Serverv Outils d'administration de Cognos TM1, tels que TM1 Top, ETLDAP ou

l'utilitaire tm1srvstop.exe.v Cognos TM1 Web (serveur Web seulement)v Cognos TM1 Application Serverv Clients Cognos TM1 :

– Cognos TM1 Architect– Cognos TM1 Perspectives– Cognos Insight– Cognos TM1 Performance Modeler

v Applications personnalisées utilisant l'API de Cognos TM1.


Remarque : Il n'est pas nécessaire de définir cette variable d'environnement surles ordinateurs qui n'utilisent qu'un navigateur Web pour accéder à CognosTM1 Web.

4. Redémarrez les serveurs Cognos TM1 que vous avez modifiés.5. Testez la connexion entre votre serveur Cognos TM1 et les applications client.

Surveillance de l'utilisation des licences de serveur TM1Le serveur IBM Cognos TM1 génère des fichiers IBM Software License Metric Tag(SLMT). Les versions d'IBM License Metric Tool qui prennent en charge les fichiersSLMT peuvent générer des rapports de consommation de licences qui fournissentdes informations sur l'utilisation de licences de votre serveur TM1.

Pour des détails complets sur l'installation et l'utilisation d'IBM License MetricTool, voir IBM License Metric Tool sur l'IBM Knowledge Center.

La génération initiale des fichiers SLMT est déterminée par le paramètreLicenseMetricTime Tm1s.cfg. Une fois que la génération des fichiers SMLT estactivée avec LicenseMetricTime, un fichier SLMT est créé toutes les 24 heures.

A propos de l'indicateur AUTHORIZED_USER

L'indicateur AUTHORIZED_USER peut avoir les sous-types suivants :v Modélisateur IBM Cognos Enterprise Planning TM1 - Tout utilisateur membre

du groupe d'utilisateurs Admin, DataAdmin ou SecurityAdmin sur le serveurTM1.

v Contributeur IBM Cognos Enterprise Planning TM1 - Un utilisateur autre qu'unmodélisateur, mais affecté à un groupe avec un accès en écriture à au moins uncube sur un serveur TM1. Un groupe est défini avec un accès en écriture à uncube s'il dispose de l'un des droits suivants pour le cube : Ecriture, Verrouillage,Réservation ou Admin.

v IBM Cognos Enterprise Planning TM1 Explorer - Un utilisateur autre qu'unmodélisateur ou un contributeur.

Pour chacun de ces sous-types, l'indicateur AUTHORIZED_USER enregistre lenombre d'utilisateurs qui se sont connectés au serveur TM1 au cours de la périodeidentifiée dans le fichier SLMT.

Emplacement des fichiers SLMT (Software License Metric Tag)

Sur tous les systèmes d'exploitation, les fichiers SLMT sont créés dans le répertoireslmtag au même niveau que le répertoire bin ou bin64 dans l'emplacementd'installation de TM1. Par exemple, C:\Program Files\IBM\cognos\tm1_64\slmtag.Tous les fichiers SLMT utilisent l'extension de fichier .slmtag.

Dépannage

Pour vous aider à comprendre la manière dont les nombres de modélisateurs, decontributeurs et d'explorateurs sont calculés lors de la génération d'un fichierSLMT, le serveur TM1 génère également un fichier de même nom, mais avecl'extension de fichier .slmtagraw. Ces fichiers .slmtagraw sont créés dans un dossierintitulé slmtagraw, qui existe au même niveau que le dossier slmtag.

Les fichiers .slmtagraw ne sont pas consommés par IBM License Metric Tool. Leurseul objectif est de vous fournir des renseignements sur le calcul des indicateurs.


http://www.ibm.com/support/knowledgecenter/SS8JFY/lmt_welcome.html

Par exemple, dans l'extrait ci-après d'un fichier .slmtagraw, vous pouvez voir quel'utilisateur Planner est un contributeur. Cet utilisateur appartient au groupeBUDGET PLANNER qui dispose de droits en ECRITURE sur le cubeplan_BudgetPlan.<Metric LogTime="2016-10-18T14:45:20Z"><Type>GROUP_INFO</Type><SubType>GROUP_DETAIL</SubType><Value><![CDATA[Group BUDGET PLANNER is a contributor group:

Group BUDGET PLANNER has WRITE permission on cube plan_BudgetPlan.]]></Value><Period><StartTime>2016-10-18T14:44:50Z</StartTime><EndTime>2016-10-18T14:45:20Z</EndTime></Period></Metric>

<Metric LogTime="2016-10-18T14:45:20Z"><Type>USER_INFO</Type><SubType>MODELER</SubType><Value><![CDATA[User Planner is a Contributor. Belongs to group

BUDGET PLANNER. Group BUDGET PLANNER has WRITE permission on cubeplan_BudgetPlan.]]></Value>

<Period><StartTime>2016-10-18T14:44:50Z</StartTime><EndTime>2016-10-18T14:45:20Z</EndTime></Period></Metric>


Chapitre 9. Installation de Cognos TM1 Operations Console

Le programme d'installation d'IBM Cognos TM1 installe IBM Cognos TM1Operations Console avec le serveur d'applications Web fourni. Vous pouvez aussiinstaller TM1 Operations Console avec votre propre serveur d'applications Web.TM1 Operations Console est un composant Java facultatif utilisé pour surveillerl'activité des serveurs Cognos TM1.

Installation de Cognos TM1 Operations Console à l'aide du logiciel deserveur Web WebSphere Liberty fourni

IBM Cognos TM1 Operations Console est un composant Java facultatif utilisé poursurveiller l'activité des serveurs Cognos TM1.

Avant de commencer

The Cognos TM1 Operations Console est installé par défaut en même temps queCognos TM1 et utilise le logiciel de serveur Web WebSphere Liberty fourni.

Avant d'installer Cognos TM1 Operations Console :v Assurez-vous que les logiciel prérequis pour Cognos TM1 sont installés.v Assurez-vous que Cognos TM1 Admin Server, TM1 Application Server, le

serveur Cognos TM1 à surveiller et le serveur TM1 Sdata sont installés etopérationnels.

v Vérifiez que vous pouvez démarrer Cognos TM1 Architect et que vous pouvezvous connecter en tant qu'administrateur à l'instance du serveur Cognos TM1 àsurveiller.

v Tous les services doivent s'exécuter dans un compte de domaine unique.L'assistant d'installation de Cognos TM1 définit automatiquement les paramètresdu compte de domaine, mais vous devez créer le compte sous lequel les servicesseront exécutés avant de procéder à l'installation. Si les services s'exécutent sousdes comptes différents, ils ne pourront pas communiquer entre eux.

v Il est possible de surveiller des serveurs Cognos TM1 version 9.5.2 à l'aide deCognos TM1 Operations Console. Cependant, l'ensemble des fonctionnalitésn'étant pas disponible dans le système 9.5.2, vous ne pouvez mettre en oeuvrequ'une surveillance de base et surveiller le signale de présence des serveurs 9.5.2en fonction ou hors ligne.

v Mise à niveau : en raison des modifications apportées à la configuration, enparticulier pour les fichiers de planification de journaux partagés, il estimpossible d'utiliser les fichiers de configuration de Cognos TM1 OperationsConsole d'une version 9.x. Vous devez saisir à nouveau les données relatives auserveur et à la planification, ainsi que la configuration utilisateur.

Procédure1. Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008, cliquez

avec le bouton droit sur la commande issetup.exe, puis cliquez sur Exécuteren tant qu'administrateur. Pour les autres systèmes d'exploitation, cliquez deuxfois sur le fichier issetup.exe sur le disque d'installation d'IBM Cognos TM1,ou à partir de l'emplacement dans lequel les fichiers d'installation de CognosTM1 ont été téléchargés et extraits.


2. Vérifiez que le composant Groupe de serveurs d'applications Web > CognosTM1 Operations Console est sélectionné.

A faire : Installez les composants IBM Cognos TM1 dans un répertoire dont lechemin d'accès ne contient que des caractères ASCII. Certains serveurs WebWindows ne prennent pas en charge les caractères non ASCII dans les noms derépertoire.

Déploiement de Cognos TM1 Operations Console à l'aide de CognosConfiguration

Démarrez TM1 Applications Server dans Cognos Configuration pour déployer leserveur WebSphere Liberty nécessaire pour exécuter TM1 Operations Console.

Avant de commencer

Si vous avez installé le produit depuis le répertoire Program Files (x86) sur unordinateur équipé du système d'exploitation Microsoft Windows Vista, Windows 7ou Windows 2008, démarrez IBM Cognos Configuration en tant qu'administrateur.

Procédure1. Cliquez sur Démarrer > Tous les programmes > IBM Cognos TM1 > IBM

Cognos Configuration.2. Cliquez avec le bouton droit sur TM1 Application Server et cliquez sur

Démarrer.Cette opération démarre la version de WebSphere Liberty fournie avec CognosTM1 et déploie automatiquement CognosTM1 Operations Console.

3. Enregistrez les données de configuration en cliquant sur Fichier > Enregistrer.4. Fermez Cognos Configuration en cliquant sur Fichier > Quitter.

Installation avancée de Cognos TM1 Operations ConsoleLes sections suivantes contiennent des informations supplémentaires sur d'autresfaçons d'installer Cognos TM1 Operations Console.

Installation de Cognos TM1 Operations Console sur unemachine distincte

Vous ne pouvez installer Cognos TM1 Operations Console que sur une machinedistincte des serveurs qui font l'objet d'une surveillance.

Procédure1. Installez Cognos TM1 en suivant la procédure habituelle, mais en sélectionnant

uniquement TM1 Operations Console dans la liste des composants Web. Pardéfaut, Cognos TM1 Applications Server et d'autres services sont égalementinstallés.

2. Après l'installation, sur une machine distincte, arrêtez TM1 Application Service.3. Supprimez les répertoires rép_install/webapps/pmpsvc et rép_install/

webapps/p2pd.4. Redémarrez TM1 Application Service.


Installation de Cognos TM1 Operations Console avec votrepropre installation de serveur d'applications Web ApacheTomcat

Cette section explique comment installer Cognos TM1 Applications sur unordinateur distinct et le déployer avec votre propre installation de Apache Tomcat.

Lorsque vous déployez Cognos TM1 Operations Console, PerformanceManagement Hub est également déployé.

Ce type d'installation est destiné à un environnement dans lequel TM1 AdminServer et TM1 Server s'exécutent sur un autre ordinateur. Lorsque vous utilisezvotre propre logiciel de serveur Web, vous devez installer des certificats etdéployer les fichiers war.

Reportez-vous à la rubrique "Utilisation du protocole SSL pendant la surveillancede TM1 Applications Server" du document Cognos TM1 Operations Console pourplus d'informations sur l'installation des certificats.

Vérification d'une variable d'environnement utilisateur JRECognos TM1 Operations Console nécessite que la variable d'environnementutilisateur de chemin d'accès aux classes soit définie.

Si vous utilisez votre propre installation d'Apache Tomcat, vérifiez que la variabled'environnement utilisateur Microsoft Windows destinée au chemin del'environnement d'exécution Java est définie comme suit.v Nom de la variable : classpathv Valeur de la variable : .;C:\Program Files\Java\jre7\bin

Si vous utilisez la version de Tomcat fournie avec l'installation Cognos TM1, lavariable est prédéfinie.

Ajout de certificats au fichier de clés du JREIBM Cognos TM1 Operations Console a besoin d'un certificat dans le fichier de clésdu JRE (Java Runtime Environment).

Procédure1. Exécutez la commande Java keytool pour importer le certificat dans le fichier

de clés.a. Ouvrez une invite de commande et accédez au répertoire suivant :

répertoire \bin\jre\7.0\bin

où répertoire est le répertoire de fichiers dans lequel Cognos TM1 est installé.ATTENTION :Sur les ordinateurs 64 bits, veillez à ajouter les certificats au dossierbin64.

b. Exécutez la ligne de commande suivante. Pour des raisons de mise en page,la commande est présentée ici avec des sauts de ligne, mais vous devez lasaisir sur une seule ligne.keytool -import -file "C:\location\bin\ssl\applixca.pem"-keystore "C:\location\bin\jre\7.0\lib\security\cacerts"-storepass "changeit"

Dans le cas des installations 64 bits, ciblez le dossier 64 bits lorsque voustravaillez sur les certificats. Par exemple, l'exemple de commande qui suitcible le JRE 64 bits :

Chapitre 9. Installation de Cognos TM1 Operations Console 99

cd C:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.0\bin

La commande suivante est un exemple destiné aux systèmes 64 bits. Pourdes raisons de mise en page, la commande est présentée ici avec des sautsde ligne, mais vous devez la saisir sur une seule ligne.keytool -import -file "C:\Program Files\ibm\cognos\TM1_64\bin64\ssl\tm1ca_v2.pem" -keystore "C:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.0\lib\security\cacerts" -storepass "changeit"

Si vous ne ciblez pas correctement les répertoires 64 bits pour les certificatslors de l'exécution d'une installation 64 bits, vous recevrez un messaged'avertissement indiquant que les serveurs ne sont pas joignables.

c. Entrez yes lorsque vous êtes invité à faire confiance au certificat ou àl'ajouter.

Le message suivant s'affiche : Certificate was added to keystore

2. Il peut être nécessaire de redémarrer votre serveur d'applications pour que lamodification soit effective.

A faire : Les certificats doivent être ajoutés à chaque réinstallation de CognosTM1.

Déploiement de Cognos TM1 Operations Console sur ApacheTomcatSi vous utilisez votre propre installation d'Apache Tomcat, vous devez déployerIBM Cognos TM1 Operations Console sur Tomcat.

Avant de commencerv Démarrez une instance d'Apache Tomcat sur l'ordinateur sur lequel vous voulez

déployer Cognos TM1 Operations Console.v Vérifiez que vous avez accès à la console Apache Tomcat Manager.v Si vous n'avez pas encore utilisé Tomcat Manager, vous devez ajouter un

utilisateur et un rôle au fichier tomcat-users.xml avant de pouvoir vousconnecter. Pour plus d'informations, voir la documentation Apache Tomcat.

v Générez les fichiers d'application à l'aide d'IBM Cognos Configuration. Voir«Génération de fichiers d'application pour un serveur Apache Tomcat ouWebSphere Liberty», à la page 146

Procédure1. Lorsqu'Apache Tomcat est en cours, cliquez sur Démarrer > Programmes >

Tomcat Manager. Entrez le nom d'utilisateur et le mot de passe si votreinstance d'Apache Tomcat les réclame.

2. Dans Tomcat Manager, faites défiler la page jusqu'à la section Deploy etlocalisez la sous-section WAR file to deploy.

A faire : Si une version précédente de Cognos TM1 Operations Console estdéjà déployée, annulez son déploiement à l'aide de l'option undeploy deTomcat Manager.

3. Cliquez sur Parcourir pour localiser le fichier archive de l'application WebCognos TM1 Operations Console que vous avez généré à l'aide d'IBM CognosConfiguration.

4. Cliquez sur OK.5. Dans Tomcat Manager, cliquez sur Deploy.


Lorsque le déploiement est terminé, Cognos TM1 Operations Console apparaîten tant que /tm1operationsconsole dans la section Applications de TomcatManager.

Installation de Cognos TM1 Operations Console sur IBMWebSphere

Vous pouvez déployer Cognos TM1 Operations Console sur IBM WebSphereApplication Server.

Lorsque vous déployez Cognos TM1 Operations Console, PerformanceManagement Hub est également déployé.

Cette installation est destinée à un environnement dans lequel TM1 Admin Serveret les serveurs TM1 sont exécutés sur un autre ordinateur.

Pour déployer Operations Console sur WebSphere, effectuez les opérationssuivantes :v Générez les fichiers d'application à l'aide de Cognos Configuration. Voir

«Génération de fichiers d'application pour un serveur IBM WebSphere», à lapage 150. Un fichier pmhub.war est créé au même emplacement que les fichierstm1web.war et pmpsvc.war. L'emplacement par défaut est <votre emplacementd'installation>\ibm\cognos\TM1\pmhub.war.

Remarque : Vous pouvez utiliser le format de fichier EAR au lieu de WAR.v Déployez le fichier pmhub.war sur le serveur d'applications Websphere.v Récupérez les certificats SSL du serveur TM1 Admin et des serveurs TM1.v Configurez les communications sortantes de Websphere vers le serveur TM1

Admin.

Déploiement de Cognos TM1 Operations Console sur IBMWebSphere Application ServerUtilisez la console d'administration d'IBM WebSphere pour déployer et exécuterTM1 Operations Console sur WebSphere Application Server.

Avant de commencerv Installez IBM WebSphere Application Server.v Créez un profil à l'aide de l'outil de gestion des profils.v Démarrez WebSphere Application Server avec le profil que vous avez créé.

Dans Microsoft Windows, cliquez sur Démarrer > Tous les programmes > IBMWebSphere Application Server > Profils > [nom du profil] > Démarrer leserveur.Une fenêtre de commande s'ouvre et indique la progression du démarrage.Lorsque le démarrage est terminé, la fenêtre de commande affiche le message"Serveur démarré". Vous pouvez réduire la fenêtre de commande, mais ne lafermez pas. Elle doit rester ouverte pendant l'exécution de WebSphere.

v Générez les fichiers d'application à l'aide de Cognos Configuration. Voir«Génération de fichiers d'application pour un serveur IBM WebSphere», à lapage 150. Le fichier pmhub.war contient Operations Console et PerformanceManagement Hub.

Pour plus d'informations sur l'installation de WebSphere et la création d'un profil,reportez-vous à la documentation WebSphere.



Ces étapes sont basées sur IBM WebSphere Application Server 8.5.5. Elles sontsemblables pour la version 8.5.

Remarque : Après avoir lancé l'assistant d'installation d'application dansWebSphere, cliquez sur Annuler pour le quitter si vous décidez finalement de nepas installer l'application. Ne vous contentez pas de passer à une autre page de laconsole d'administration sans avoir au préalable cliqué sur Annuler sur une pagede l'assistant.

Procédure1. Ouvrez la console d'administration WebSphere.v Dans Windows, cliquez sur Démarrer > Tous les programmes > IBM

WebSphere Application Server > Profils > [nom du profil] > Consoled'administration. Vous pouvez aussi accéder à https://localhost:9043/ibm/console/.

v Dans UNIX, cliquez sur Applications > IBM Websphere > Serveurd'applications IBM Websphere > Profils > [nom du profil] > Consoled'administration. Vous pouvez aussi accéder à https://localhost:9043/ibm/console/.

2. Connectez-vous avec le profil WebSphere que vous avez créé. La consoled'administration s'ouvre.

3. Définissez la taille de la mémoire de la pile JVM.a. Cliquez sur Serveurs > Types de serveurs > Serveurs d'applications

WebSphere.b. Cliquez sur le serveur sur lequel vous déployez Operations Console.c. Sous Infrastructure du serveur, cliquez sur Gestion des processus et Java

> Définition des processus.d. Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.e. Dans la zone Arguments JVM génériques, ajoutez -Xmso512k.

Remarque : Ne déployez pas Operations Console avant d'avoir défini lataille de la mémoire de la pile. Si vous le faites, Operations Console seradéployé mais WebSphere Application Server ne démarrera pas.N'utilisez pas le fichier startServer.sh pour définir la taille de la mémoirede la pile. WebSphere supprime le paramètre -Xmso du fichier audémarrage du serveur et le remplace par la valeur par défaut, qui est troppetite.

f. Cliquez sur Appliquer, puis sur OK. Cliquez sur Enregistrer.4. Cliquez sur Applications > Nouvelle application, puis cliquez sur Nouvelle

application d'entreprise.5. Cliquez sur Parcourir pour localiser et sélectionner le fichier pmhub.war que

vous avez généré à l'aide de la commande Générer des fichiers d'applicationdans Cognos Configuration. Cliquez sur Ouvrir.

6. Cliquez sur Suivant.7. Cliquez sur Raccourci, puis cliquez sur Suivant.8. Cliquez sur Etape 4 : Mappage des racines de contexte des modules Web.9. Dans la zone Racine du contexte, saisissez /pmhub. Cliquez sur Suivant.

10. Cliquez sur Terminer. WebSphere installe l'application. Cette opération peutprendre quelques minutes.


Lorsque l'installation est terminée, WebSphere indique "Applicationpmhub_war installée avec succès."

11. Cliquez sur Enregistrer.12. Cliquez sur Applications > Types d'application > Applications d'entreprise

Websphere.13. Cochez la case en regard de pmhub_war, puis cliquez sur Démarrer.

WebSphere indique "Le démarrage de l'application pmhub_war installée sur leserveur serveur et le noeud noeud a abouti. Il se peut que vous deviezactualiser la collection pour afficher le statut actuel."

Que faire ensuite

L'étape suivante consiste à récupérer les certificats SSL du serveur TM1 Admin etdes serveurs TM1.

Récupération des certificats SSL du serveur TM1 Admin et desserveurs TM1L'étape qui suit le déploiement du fichier d'applications, pmhub.war, sur IBMWebSphere Application Server consiste à extraire les certificats SSL du serveur TM1Admin Server et des serveurs TM1.

Procédure1. Dans la console d'administration d'IBM WebSphere, développez Sécurité, puis

cliquez sur Certificat SSL et gestion des clés.2. Sous Articles liés, cliquez sur Magasins de clés et certificats.3. Cliquez sur le magasin de clés NodeDefaultTrustStore.4. Dans le menu Propriétés supplémentaires, cliquez sur Certificats de

signataires.5. Cliquez sur Extraire d'un port. Entrez les informations suivantes :v Dans la zone Hôte, entrez le nom du serveur TM1 Admin.v Dans la zone Port, entrez 5498, le numéro de port du serveur TM1 Admin.v Dans la zone Alias, entrez TM1AdminServer_cert.

6. Cliquez sur Récupérer les informations du signataire. WebSphere extrait lecertificat SSL du serveur TM1 Admin.

7. Vérifiez que ces informations correspondent à un certificat digne de confiance.8. Cliquez sur Appliquer, puis sur Sauvegarder.9. Répétez ces étapes pour les serveurs TM1 que vous voulez surveiller avec

Operations Console. Par exemple :v Dans la zone Hôte, entrez le nom d'hôte du serveur TM1.v Dans la zone Port, entrez le numéro de port du serveur TM1.v Dans la zone Alias, entrez TM1ServerName_cert.

Conseil : Le numéro de port d'un serveur TM1 est configuré dans le fichiertm1s.cfg, dans le paramètre PortNumber.

10. Enregistrez les modifications.

Que faire ensuite

L'étape suivante consiste à configurer les communications sortantes entreWebsphere et le serveur TM1 Admin.


Configuration des communications sortantes vers le serveurTM1 AdminL'étape qui suit le déploiement du fichier d'applications, pmhub.war, sur IBMWebSphere Application Server et l'extraction des certificats SSL est la configurationdes communications sortantes depuis WebSphere vers le serveur TM1 Admin.

Procédure1. Dans la console d'administration de WebSphere, développez Sécurité, puis

cliquez sur Certificat SSL et gestion des clés.2. Dans le menu Paramètres de configuration, cliquez sur Gérer les

configurations de sécurité des noeuds finaux.3. Développez Sortant > [noeud]Node01Cell > noeud.4. Cliquez sur [[noeud]Node01Cell, où noeud est le nom du serveur sur lequel

vous déployez Operations Console.5. Dans le menu Articles liés, cliquez sur Configurations SSL de noeud final de

communications sortantes dynamiques.6. Cliquez sur le magasin de clés NodeDefaultTrustStore.7. Cliquez sur Nouveau.8. Dans la zone Nom, entrez tm1admin.9. Dans la zone Description, entrez Connexion SSL.

10. Sous Informations de connexion, entrez *,*,5498, puis cliquez sur Ajouter.

Remarque : La valeur 5498 est le numéro de port SSL du serveur TM1 Admindéfini dans Cognos Configuration.

11. Cliquez sur Appliquer, puis sur OK.12. Enregistrez les modifications.13. Redémarrez WebSphere Application Server.14. Dans le navigateur Web, entrez l'URL permettant d'exécuter Operations

Console, http://localhost:port/pmhub/pm/opsconsole/. Remplacez port parle numéro de port de l'hôte virtuel sur lequel vous avez déployé pmhub.war.Par exemple : http://localhost:9080/pmhub/pm/opsconsole/. La page deconnexion à Operations Console est affichée.

Configuration de Cognos TM1 Operations ConsolePar défaut, Cognos TM1 Operations Console est configuré pour utiliser unexemple d'hôte admin localhost, un serveur de données et le groupe appelé adminpour l'authentification afin de vous permettre d'être opérationnel rapidement. Sivous préférez, vous pouvez modifier ces configurations pour personnaliser leserveur d'authentification.

Procédure1. Entrez http://nom du serveur:numéro de port/pmhub/pm/admin pour ouvrir

l'écran de configuration.2. Pour changer l'hôte admin, le serveur et le groupe par défaut pour la

surveillance, développez le noeudcom.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor etsélectionnez l'optioncom.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor.dictionary.Cliquez sur chacun des paramètres pour les modifier. Si vous souhaitez utiliser


Microsoft Internet Explorer 8 avec Cognos TM1 Operations Console, consultezla documentation Microsoft Internet Explorer et vérifiez les paramètressuivants :v Activez l'option d'actualisation des pages Web à chaque visitev Désactivez les options de débogage des scripts

Démarrage de Cognos TM1 Operations Console et connexionPour ouvrir IBM Cognos TM1 Operations Console, entrez l'URL qui identifie leport et le nom du serveur pour le composant.

Procédure1. Dans un navigateur Web, entrez l'adresse Web suivante : http://

nom_serveur:numéro_port/pmhub/pm/opsconsole

oùv nom_serveur est l'ordinateur sur lequel sont installés Cognos TM1 Operations

Console et le serveur d'applications Web. Le mot clé localhost peut êtreutilisé si vous êtes connecté au serveur Web qui exécute Cognos TM1Application Web. Ou vous pouvez utiliser le nom de machine ou dedomaine, ou l'adresse IP du serveur Web hébergeant l'application.

v numéro_port est le numéro du port sur lequel s'exécute le serveurd'applications. Pour la version de WebSphere Liberty fournie avecl'installation Cognos TM1, le numéro de port par défaut est 9510. PourApache Tomcat, ouvrez le fichier server.xml d'Apache Tomcat dans lerépertoire C:\Program Files\Apache Software Foundation\Tomcat 6.0\conf\pour déterminer le paramétrage du port utilisé par votre version de Tomcat.

2. Dans la page de connexion, remplissez les zones suivantes, puis cliquez sur Seconnecter. Pour utiliser le groupe de surveillance par défaut, entrez :v Espace-noms : Sélectionnez l'espace-noms disponible dans le menu

déroulant. Si le système est de type "CAM-secured", l'espace-noms estl'espace-noms Cognos Analytics pour lequel le système TM1 est sécurisé.Dans le cas contraire, l'espace-noms est adminhost/tm1 server, par exemplelocalhost/SData

v Nom d'utilisateur : adminv Mot de passe : appleVoir Configuration de Cognos TM1 Operations Console pour commencer.


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_op.2.0.0.doc/c_tm1_ops_console_configuration_tasks.html

Chapitre 10. Installation de Cognos TM1 Web

Vous pouvez installer IBM Cognos TM1 Web sur un ordinateur distinct de celuisur lequel sont installés le serveur et les autres composants Cognos TM1.

Vous pouvez déployer TM1 Web sur un serveur d'applications Apache Tomcat ousur IBM WebSphere Application Server. Voir :v «Installation de TM1 Web avec le serveur d'applications WebSphere Liberty

fourni»v «Installation de TM1 Web avec IBM WebSphere», à la page 110

Lorsque vous installez TM1 Web, TM1 Applications Web est également installé.

Pour des informations détaillées sur l'architecture de Cognos TM1 Web, voir«Architecture de Cognos TM1 Web», à la page 27.

Liste de contrôle pour l'installation de Cognos TM1 Web

Les éléments suivants constituent une liste de contrôle pour l'installation deCognos TM1 Web.v Installez Cognos TM1 Web.v Si vous utilisez Tomcat, utilisez IBM Cognos Configuration pour démarrer le

serveur d'applications Web qui prend en charge Cognos TM1 Web.Si vous utilisez WebSphere Application Server, utilisez la consoled'administration WebSphere pour démarrer le serveur d'applications.

v Exécutez et testez Cognos TM1 Web à partir de votre environnement réseau.v Editez le fichier de configuration de Cognos TM1 Web pour prendre en charge

l'environnement multiserveur. Voir «Configuration de la page de connexionCognos TM1 Web à l'aide des paramètres AdminHostName et TM1ServerName», à la page 120.

v Configurez l'authentification et la sécurité de la transmission des données. VoirChapitre 18, «Configuration de la sécurité», à la page 225.

v Configurez d'autres options dans le fichier de configuration de Cognos TM1Web. Voir «Modification des paramètres de configuration de Cognos TM1 Web»,à la page 113.

v Configurez les navigateurs Web de votre environnement. Voir «Configuration dunavigateur Web pour Cognos TM1 Web», à la page 131.

Concepts associés:«Mise à niveau de Cognos TM1 Web», à la page 51Si IBM Cognos TM1 Web est installé sur un ordinateur distinct de celui sur lequelest installé le serveur Cognos TM1, procédez de la façon suivante pour mettre àniveau le serveur Web.

Installation de TM1 Web avec le serveur d'applications WebSphereLiberty fourni

Vous pouvez installer Cognos TM1 Web sur un ordinateur distinct et le déployeravec l'instance de WebSphere Liberty fournie avec l'installation.


L'installation d'IBM Cognos TM1 configure Cognos TM1 Web pour qu'il fonctionneavec la version fournie du serveur d'applications Web WebSphere Liberty.

Après avoir installé Cognos TM1 Web sur un ordinateur distinct, éditez le fichierde configuration de Cognos TM1 Web pour identifier l'ordinateur distant surlequel s'exécute Cognos TM1 Admin Server.

Installation et configuration de Cognos TM1 Web sousMicrosoft Windows

Cette procédure décrit la manière d'installer IBM Cognos TM1 Web sur unordinateur distinct qui fonctionne sous Microsoft Windows. Cette procédures'applique si vous utilisez le serveur d'applications WebSphere Liberty fourni.


Cette procédure installe également l'utilitaire IBM Cognos Configuration. Vousutilisez Cognos Configuration pour démarrer et arrêter le serveur d'applications.

Si IBM Cognos TM1 Web est installé sur un ordinateur distinct, éditez le fichier deconfiguration pour identifier les serveurs IBM Cognos TM1 Admin et IBM CognosTM1 de votre réseau à utiliser avec Cognos TM1 Web.

Procédure1. Exécutez le programme d'installation qui correspond au type d'ordinateur

utilisé pour Cognos TM1 Web :v 32 bits pour Windowsv 64 bits pour Windows

2. Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008, cliquezavec le bouton droit sur le fichier issetup.exe, puis cliquez sur Exécuter entant qu'administrateur. Dans le cas des autres systèmes d'exploitation, cliquezdeux fois sur le fichier issetup.exe.

3. Sélectionnez uniquement les composants Niveau Web TM1 suivants : TM1Web, TM1 Application Server et Cognos Access Manager. Désélectionneztous les autres composants.

4. Suivez la procédure de l'assistant d'installation pour réaliser l'installation.5. Démarrez IBM Cognos Configuration.

Avertissement : Si vous avez installé le produit depuis le répertoire ProgramFiles (x86) sur un ordinateur Windows Vista, Windows 7 ou Windows Server2008, démarrez IBM Cognos Configuration en tant qu'administrateur.

6. Dans le panneau Explorateur de Cognos Configuration, développez le noeudConfiguration locale > Environnement, cliquez avec le bouton droit sur TM1Application Server, puis cliquez sur Démarrer.Cette opération démarre le serveur d'applications Web fourni avec CognosTM1 Web.

7. Vérifiez que Cognos TM1 Web est en cours d'exécution en entrant son URLdans un navigateur Web. Par exemple :http://localhost:9510/tm1web/

Sur un ordinateur distant, remplacez localhost par le nom ou l'adresse IP del'ordinateur sur lequel Cognos TM1 Web est exécuté.

8. Configurez Cognos TM1 Web pour qu'il se connecte aux serveurs CognosTM1 de votre réseau.


Si Cognos TM1 Web doit se connecter à un serveur Cognos TM1 Admin ouCognos TM1 spécifique de votre réseau, configurez les paramètresAdminHostName et TM1ServerName du fichier de configuration Cognos TM1 Web,tm1web_config.xml.Voir «Configuration de la page de connexion Cognos TM1 Web à l'aide desparamètres AdminHostName et TM1ServerName», à la page 120.

9. Configurez les options de sécurité de Cognos TM1 Web.Vous pouvez configurer la sécurité authentifiée, par exemple la connexionintégrée ou la sécurité IBM Cognos, ainsi que la sécurité de la transmissiondes données, par exemple SSL, en fonction de votre système et de votreenvironnement.Voir Chapitre 18, «Configuration de la sécurité», à la page 225.

10. Configurez d'autres options dans le fichier de configuration de Cognos TM1Web.Voir «Modification des paramètres de configuration de Cognos TM1 Web», àla page 113.

11. Prenez connaissance des informations relatives à la configuration dunavigateur Web.Vous pouvez configurer pour les utilisateurs des options telles que lesparamètres linguistiques et régionaux du navigateur Web.Voir «Configuration du navigateur Web pour Cognos TM1 Web», à la page131.

Installation et configuration de Cognos TM1 Web sous UNIXL'installation d'IBM Cognos TM1 Web sur un système UNIX implique l'importationdu certificat dans le magasin de clés Java sous UNIX. Cette procédure s'applique sivous utilisez le serveur d'applications WebSphere Liberty fourni.

Avant de commencer

Vous devez définir la variable d'environnement JAVA_HOME avant de démarrerIBM Cognos Configuration. Cognos Configuration est utilisé pour démarrer leserveur d'applications Web de Cognos TM1 Web.


L'importation du certificat dans le magasin de clés Java sous UNIX est nécessairepour permettre à Cognos TM1 Web d'afficher la liste des serveurs Cognos TM1.

Procédure1. Exécutez le programme d'installation :

a. Accédez au répertoire dans lequel les fichiers d'installation ont ététéléchargés et extraits, ou insérez le disque du produit.

b. Accédez au répertoire du système d'exploitation, puis entrez :./issetup

c. Avancez jusqu'à l'écran Sélection des composants.d. Sélectionnez uniquement les composants Niveau Web TM1 suivants : TM1

Web et TM1 Application Server.Désélectionnez tous les autres composants.

e. Suivez la procédure de l'assistant d'installation pour réaliser l'installation.2. Importez le certificat dans le magasin de clés Java sous UNIX.

Chapitre 10. Installation de Cognos TM1 Web 109

a. Accédez au répertoire bin associé à JAVA_HOME.b. Exécutez la commande suivante :

keytool -import -file “/bin64/ssl/applixca.pem” -keystore“/usr/java7/jre/lib/security/cacerts” -storepass “changeit”

3. Démarrez IBM Cognos Configuration :Accédez au répertoire répertoire d'installation/bin64, puis entrez lacommande suivante :./cogconfig.sh

4. Démarrez le serveur d'applications Web pour Cognos TM1 Web :Dans le panneau Explorateur de Cognos Configuration, développez le noeudConfiguration locale > Environnement, cliquez avec le bouton droit sur TM1Application Server, puis cliquez sur Démarrer.

5. Vérifiez que Cognos TM1 Web est en cours d'exécution en entrant son URLdans le navigateur Web d'un ordinateur distant. Par exemple :http://<serveur Web UNIX>:9510/tm1web/

Remplacez <serveur Web UNIX> par le nom ou l'adresse IP de l'ordinateur surlequel s'exécuteCognos TM1 Web.

Que faire ensuite

En fonction de votre système et de votre environnement réseau, effectuez lesopérations de configuration suivantes :v Configurez Cognos TM1 Web pour qu'il se connecte à un serveur Cognos TM1

Admin ou Cognos TM1 de votre réseau.Voir «Configuration de la page de connexion Cognos TM1 Web à l'aide desparamètres AdminHostName et TM1ServerName», à la page 120.

v Configurez les options de sécurité de Cognos TM1 Web.Voir Chapitre 18, «Configuration de la sécurité», à la page 225.

v Configurez d'autres options dans le fichier de configuration de Cognos TM1Web.Voir «Modification des paramètres de configuration de Cognos TM1 Web», à lapage 113.

v Prenez connaissance des informations relatives à la configuration du navigateurWeb.Voir «Configuration du navigateur Web pour Cognos TM1 Web», à la page 131.

Installation de TM1 Web avec IBM WebSphereVous pouvez déployer Cognos TM1 Web sur IBM WebSphere Application Server.Lorsque vous installez TM1 Web, TM1 Applications Web est également installé.

Pour installer TM1 Web et TM1 Applications Web sur un serveur d'applicationsWebSphere, procédez de la manière suivante :v Générez les fichiers d'application à l'aide de Cognos Configuration. Voir

«Génération de fichiers d'application pour un serveur IBM WebSphere», à lapage 150. Un fichier tm1web.war est créé. L'emplacement par défaut est <votreemplacement d'installation>\ibm\cognos\TM1\tm1web.war.

Remarque : Vous pouvez utiliser le format de fichier EAR au lieu de WAR.v Déployez le fichier tm1web.war sur le serveur d'applications Websphere.v Importez le certificat SSL de TM1 dans WebSphere.


Déploiement de TM1 Web sur IBM WebSphere ApplicationServer

Utilisez la console d'administration d'IBM WebSphere pour déployer et exécuterTM1 Web et TM1 Applications Web sur WebSphere Application Server.


Dans Microsoft Windows, cliquez sur Démarrer > Tous les programmes > IBMWebSphere Application Server > Profils > [nom du profil] > Démarrer leserveur.Une fenêtre de commande s'ouvre et indique la progression du démarrage.Lorsque le démarrage est terminé, la fenêtre de commande affiche le message"Serveur démarré". Vous pouvez réduire la fenêtre de commande, mais ne lafermez pas. Elle doit rester ouverte pendant l'exécution de WebSphere.

v Générez les fichiers d'application à l'aide de Cognos Configuration. Voir«Génération de fichiers d'application pour un serveur IBM WebSphere», à lapage 150.





Procédure1. Ouvrez la console d'administration WebSphere.v Dans Windows, cliquez sur Démarrer > Tous les programmes > IBM




3. Cliquez sur Applications > Nouvelle application, puis cliquez sur Nouvelleapplication d'entreprise.

4. Cliquez sur Parcourir pour localiser et sélectionner le fichier tm1web.war quevous avez généré à l'aide de la commande Générer des fichiers d'applicationdans Cognos Configuration. Cliquez sur Ouvrir.

5. Cliquez sur Suivant.


6. Cliquez sur Raccourci, puis cliquez sur Suivant.7. Cliquez sur Etape 4 : Mappage des racines de contexte des modules Web.8. Dans la zone Racine du contexte, saisissez /tm1web. Cliquez sur Suivant.9. Cliquez sur Terminer. WebSphere installe l'application. Cette opération peut

prendre quelques minutes.Lorsque l'installation est terminée, WebSphere indique "Applicationtm1web_war installée avec succès."

10. Cliquez sur Sauvegarder.11. Cliquez sur Applications > Types d'application > Applications d'entreprise

Websphere.12. Cochez la case en regard de tm1web_war, puis cliquez sur Démarrer.

WebSphere indique "Le démarrage de l'application tm1web_war installée surle serveur serveur et le noeud noeud a abouti. Il se peut que vous deviezactualiser la collection pour afficher le statut actuel."

Que faire ensuite

L'étape suivante consiste à importer les certificats TM1 dans le fichier de clés.

Importation de certificats SSL pour TM1 WebL'étape qui suit le déploiement du fichier d'applications, tm1web.war, sur IBMWebSphere Application Server consiste à importer les certificats SSL de TM1 dansle fichier de clés.


Pour TM1 Web, tous les certificats racine doivent être installés dans le magasin decertificats sur l'ordinateur sur lequel TM1 Web est exécuté.

Procédure1. Dans la console d'administration d'IBM WebSphere, développez Sécurité, puis

cliquez sur Certificat SSL et gestion des clés.2. Sous Articles liés, cliquez sur Magasins de clés et certificats.3. Cliquez sur le magasin de clés NodeDefaultTrustStore.4. Dans le menu Propriétés supplémentaires, cliquez sur Certificats de

signataires.5. Cliquez sur Ajouter.6. Entrez les informations suivantes :v Dans la zone Alias, entrez applixca.pem.v Dans la zone Nom de fichier, entrez le chemin complet et le nom du fichier

du certificat SSL de TM1, par exemple répertoire_installation_TM1\bin\SSL\applixca.pem.

Remarque : Si vous utilisez vos propres certificats SSL, saisissez le chemin etle nom du fichier du certificat racine.

v Pour la zone Type de données, conservez la valeur par défaut.7. Cliquez sur Appliquer, puis sur OK.8. Vérifiez que Cognos TM1 Web est en cours d'exécution en entrant son URL

dans un navigateur Web. Par exemple :http://hôte:port/tm1web/


Sur un ordinateur distant, remplacez hôte par le nom ou l'adresse IP del'ordinateur sur lequel Cognos TM1 Web est exécuté. Remplacez port par lenuméro de port de l'hôte virtuel sur lequel vous avez déployé tm1web.war. Parexemple : http://serveur1:9080/tm1web.

Que faire ensuite

L'étape suivante consiste à configurer TM1 Web. Voir «Modification des paramètresde configuration de Cognos TM1 Web» et «Configuration du navigateur Web pourCognos TM1 Web», à la page 131.

Modification des paramètres de configuration de Cognos TM1 WebLe fichier tm1web_config.xml est un fichier XML qui contient les paramètres deconfiguration d'IBM Cognos TM1 Web.

A partir de Cognos TM1 Web version 10.2, le nouveau fichier tm1web_config.xmlremplace le fichier web.config des versions précédentes de Cognos TM1 Web.

Les paramètres présents dans ce fichier contrôlent les fonctionnalités suivantesd'IBM Cognos TM1 Web.v Noeud Vuev Taille des pages Cube Viewerv Nombre de feuilles exportables depuis Cube Viewerv Paramètres de démarrage et d'apparence d'IBM Cognos TM1 Web

Paramètres de configuration de Cognos TM1 WebLes paramètres de configuration d'IBM Cognos TM1 Web se trouvent dans lefichier tm1web_config.xml.

Le fichier tm1web_config.xml se trouve à l'emplacement suivant :

<emplacement installation TM1>\webapps\tm1web\WEB-INF\configuration\

Les paramètres suivants sont disponibles :

ActionButtonFullRecalculationEnabled

Détermine le niveau de recalcul effectué lors de l'exécution d'un boutond'action. Ce paramètre n'est applicable qu'aux boutons d'action dont letype de Calcul est Recalculer la feuille automatiquement.

Si la valeur est true, un recalcul complet se produit dans le classeur cible.

Si la valeur est false, un recalcul partiel est réalisé dans le classeur cible.Seules les parties visible du classeur cible sont recalculées. Ce recalculinclut tous les formulaires actifs, les formules DBS/DBSW/DBR/DBRW/DBRA/DBSA, et les dépendances de cellule dans la zone visible. Lesparties situées au-delà de la limite de défilement du classeur cible ne sontpas recalculées. La valeur false est la valeur par défaut, ce qui peutaméliorer les performances, en particulier pour les classeurs volumineux.

AdminHostNameSi ce paramètre est défini, les utilisateurs ne sont pas invités à entrer unevaleur pour l'hôte admin lors de la connexion.


Voir «Configuration de la page de connexion Cognos TM1 Web à l'aide desparamètres AdminHostName et TM1ServerName», à la page 120.

AdminHostPortSi ce paramètre est défini, le client tente d'utiliser ce port à la place du portpar défaut de l'hôte admin.

AdminHostSSLPortSi ce paramètre est défini, le client tente d'utiliser ce port à la place du portSSL par défaut de l'hôte admin.

CamLoginApiRedirectEnabled

La valeur par défaut est false.

Si ce paramètre est activé, l'authentification CAM depuis l'API TM1 Web(l'API URL ou la bibliothèque JavaScript) procède à une redirection vers lapage de connexion CAM de Cognos Analytics. Ce comportement diffère decelui par défaut qui consiste à afficher la page de connexion CAM deCognos Analytics dans une boîte de dialogue. Ce paramètre doit être activési Cognos Analytics inclut un en-tête X-Frame-Options avec la valeurSAMEORIGIN ou DENY, utilisé pour améliorer la protection contre les attaquesde type détournement de clic.

CleanDimensionMetaDataCache

Au cours du calcul de la feuille Web, le paramètreCleanDimensionMetaDataCache indique si des éléments de dimension sontextraits du serveur TM1 ou à l'aide d'éléments mis en cache depuis TM1Web.

Valeur par défaut : falsev Si CleanDimensionMetaDataCache a pour valeur false, les éléments du

cache tm1web sont utilisés.v Si CleanDimensionMetaDataCache a pour valeur true, les éléments de

dimension tm1web sont effacés du cache et les éléments sont extraitsdirectement du serveur TM1.

CrossDomainAccessList

Indique la liste des adresses URL interdomaine autorisées à accéder à TM1Web.

Vous pouvez utiliser ce paramètre pour définir le domaine dans lequelIBM Cognos Workspace est exécuté, s'il s'agit d'un domaine distinct decelui de TM1 Web.

Utilisez un astérisque (*) pour autoriser tout domaine à accéder à TM1Web.

Si vous spécifiez plusieurs adresses URL, séparez-les par une virgule.

Si ce paramètre n'est pas défini, ou si sa valeur est vide, aucun accèsinterdomaine à TM1 Web n'est autorisé.

CubeViewerColumnPageSizeDéfinit le nombre de colonnes à extraire dans une page Cube Viewer.

Voir «Modification de la taille des pages de Cube Viewer», à la page 129.

CubeViewerRowPageSizeDéfinit le nombre de lignes à extraire dans une page Cube Viewer.

Voir «Modification de la taille des pages de Cube Viewer», à la page 129.


CubeviewerStringWrapParamétrage du retour à la ligne des chaînes dans les cellules de CubeViewer.

Voir «Retour à la ligne des valeurs chaîne dans les vues de cube», à lapage 129.

CustomCAMLogoutUrl

Définit l'adresse URL de la page de déconnexion dédiée de CA SiteMinderlorsque TM1 est configuré pour utiliser la sécurité CAM (mode 4 ou 5).Cette page de déconnexion doit être accessible lors de la déconnexion desorte que le cookie de session de SiteMinder puisse être invalidé.

Lorsqu'un utilisateur clique sur Déconnexion dans TM1 Web, ladéconnexion CAM se produit d'abord. Puis, la page de déconnexion deSiteMinder est appelée.

EvaluationServiceURLIndique l'emplacement du service d'évaluation. La valeur valide esthostname:port_number. Si aucune valeur n'est affectée, l'emplacementsupposé est http://localhost:9510.

ExternalUrl

Définissez le paramètre ExternalUrl si vous utilisez l'authentification TM1®

Web et de sécurité Cognos (CAM) avec un équilibreur de charge externequi modifie l'adresse URL de démarrage pour TM1 Web. Le paramètreExternalUrl fournit l'adresse URL correcte pour que la sécurité Cognospuisse être redirigée vers TM1 Web.

Comme valeur, définissez l'adresse URL que vous utilisez pour démarrerTM1 Web, par exemple :<add key="ExternalUrl" value="http://mycomputer/TM1Web" />

GzipCompressionEnabledDétermine si les réponses du serveur Web doivent être compressées. Lesvaleurs valides sont true/false.

HideCubeviewerToolBarSi la valeur est True, les barres d'outils de Cube Viewer ne s'affichent pas.

Voir «Paramètre HideCubeviewerToolBar», à la page 128.

HideTabBarSi la valeur est True, un seul onglet est affiché.

Voir «Paramètre HideTabBar», à la page 127.

HideWebsheetToolBarSi la valeur est True, les barres d'outils des feuilles Web ne s'affichent pas.

Voir «Paramètre HideWebsheetToolBar», à la page 128.

HomePageObjectSi ce paramètre est défini, les objets de type feuille Web, Cube Viewer ouURL s'affichent lorsqu'un utilisateur se connecte.

Voir «Configuration d'une page d'accueil globale pour tous les utilisateurs», à la page 123.

LegacyUrlApiSessionDiscoveryEnabledUtilisez le paramètre de configurationLegacyUrlApiSessionDiscoveryEnabled pour contrôler la manière dont


l'API URL de TM1 Web gère les sessions de connexion. Configurez ceparamètre pour définir si l'API URL suit de manière individuelle lessessions de connexion uniques.

Ce paramètre permet la réutilisation de la session de l'API URL sur la basede l'hôte admin, du serveur TM1 et, facultativement, du nom d'utilisateur.

Si vous utilisez la méthode de connexion avec un jeton de session avecl'API URL, vous devez associer le paramètre de configurationLegacyUrlApiSessionDiscoveryEnabled dans le fichier tm1web_config.xml àla valeur False. Pour plus d'informations sur la connexion avec un jeton desession, voir Connexion de session d'API TM1 Web.

Utilisez ce format :

<add key="LegacyUrlApiSessionDiscoveryEnabled" value=True or False/>

Exemple :

<add key="LegacyUrlApiSessionDiscoveryEnabled" value="False"/>

La valeur par défaut est True.v True

TM1 Web tente de faire correspondre la nouvelle demande de connexionavec une session de connexion existante, sur la base des informationsfournies (hôte admin TM1, serveur TM1, nom d'utilisateur).Vous ne devez définir la valeur True pour ce paramètre que si uneconnexion et une seule doit être établie pour une combinaison uniqued'hôte admin TM1, de serveur TM1 et de nom d'utilisateur.

v False

Implique qu'un jeton de session doit être fourni à chaque ouverture d'unobjet TM1 Web avec l'API URL de TM1 Web. Sinon, l'utilisateur estinvité à s'identifier.Associez ce paramètre à la valeur False si vous prévoyez d'utiliserplusieurs sessions de connexion avec l'API URL de TM1 Web. Utilisezégalement cette configuration si vous utilisez plusieurs sessions deconnexion avec l'API URL et d'autres clients TM1 Web, tels que TM1Web et TM1 Application Web. Cette configuration utilise le jeton desession pour garantir la séparation et l'unicité des sessions utilisateur.

MaximumConcurrentExportsDétermine le nombre maximal d'exportations simultanées qui peuvent êtreexécutées à partir de TM1 Web. La valeur par défaut est 5.

Vous pouvez définir MaximumConcurrentExports sur 0 pour autoriser unnombre illimité d'exportations simultanées. Ce paramètre est analogue aucomportement d'exportation de TM1 Web avant la version 10.3.

Les nouvelles exportations initiées alors que le nombre maximald'exportations simultanées est atteint sont placées en file d'attente jusqu'àce qu'un créneau d'exportation se libère. L'initiateur d'une exportation miseen file d'attente n'est pas informé de cette situation.

Le paramétrage optimal dépend de la capacité de la mémoire RAM et desbesoins des utilisateurs. En règle générale, plus TM1 Web dispose demémoire RAM, plus la valeur du paramètre peut être élevée.L'augmentation de la valeur accroît la consommation de mémoire, maisréduit la file d'attente d'exportation. (La valeur 0 supprime la mise en filed'attente des exportations.) A l'inverse, la diminution de la valeur réduit la


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_dg_dvlpr.2.0.0.doc/c_tm1webjv_api_sessiontoken_login.html

consommation de mémoire résultant des exportations, mais peut entraînerune mise en file d'attente plus fréquente des exportations.

MaximumSheetsForExportSpécifie le nombre maximal de feuilles autorisées pour l'exportation.

Voir «Réglage du nombre maximum de feuilles à exporter depuis un CubeViewer», à la page 129.

MixedCellPaste

Si le paramètre MixedCellPaste a pour valeur true, lorsque vous copiez desvaleurs dans une plage mixte de feuilles et de valeurs consolidées dansune feuille Web, les valeurs collées correspondent exactement.

Remarque : Ce paramètre est valable pour les feuilles Web seulement ; ilne s'applique pas à Cube Viewer.La valeur par défaut est false.

NavTreeCollapsedOnStartDétermine si le panneau de navigation est développé ou réduit lorsqu'unutilisateur se connecte.

Voir «Paramètre NavTreeCollapsedOnStart», à la page 127.

NavTreeDisplayServerViewDéfinit si le noeud Vue du serveur est affiché dans l'arborescence denavigation. Les valeurs valides sont Y et N.

Voir «Affichage ou masquage du noeud Vues dans la sous-fenêtre denavigation», à la page 128.

NavTreeHiddenDétermine si le panneau de navigation s'affiche lorsqu'un utilisateur seconnecte.

Voir «Paramètre NavTreeHidden», à la page 126.

RecalcOnActivate

Si le paramètre RecalcOnActivate a pour valeur true, un recalcul esteffectué à chaque fois qu'une feuille Web ou qu'une vue de cube est activéedans TM1 Web, par exemple lorsque vous changez d'onglet.Les valeursvalides sont true et false.

RecalcOnDataValidationChange

Définit si le comportement par défaut du recalcul est remplacé lors de lamodification d'une valeur dans une liste de validation des données.

Si la valeur est True, un recalcul est déclenché en cas de modification d'unevaleur d'une liste de validation de données.

Si la valeur est False, le recalcul n'est pas déclenché.

RecalcOnPicklistChange

Définit si le comportement par défaut du recalcul est remplacé lors de lamodification d'une valeur dans une liste de sélection.

Si la valeur est True, un recalcul est déclenché en cas de modification d'unevaleur d'une liste de sélection.

Si la valeur est False, le recalcul n'est pas déclenché.


RelationalResultMaxRowsSi une valeur supérieure à -1 est spécifiée, les ensembles de résultats derequête relationnelle ne renvoient que le nombre spécifié de lignes.

TM1ServerNameSi ce paramètre est défini, les utilisateurs ne sont pas invités à sélectionnerun serveur TM1 auquel se connecter lors de la connexion.

Voir «Configuration de la page de connexion Cognos TM1 Web à l'aide desparamètres AdminHostName et TM1ServerName», à la page 120.

UseBookRecalcSetting

Le paramètre UseBookRecalcSetting est inclus dans le fichiertm1web_config.xml. Lorsque le paramètre est true, le serveur Web respectele mode dans lequel la feuille Excel a été publiée. Si la feuille Excel a étépubliée en mode de calcul manuel, les données de la feuille Web ne sontpas renvoyées au client tant qu'un recalcul n'a pas été effectué.

Le paramètre UseBookRecalcSetting utilise le format suivant dans le fichiertm1web_config.xml :<add key="UseBookRecalcSetting" value="false" />

où la valeur est "false" ou "true"

Si vous associez UseBookRecalcSetting à la valeur true, TM1 Web respecteles paramètres de recalcul dans la feuille de calcul Excel.

Lorsque les options de calcul sont définies sur Automatique :v Si vous définissez UseBookRecalcSetting = "true", la feuille Web est

recalculée automatiquement lorsque vous changez la fonction SUBNM.v Si vous définissez UseBookRecalcSetting = "false", la feuille Web est

recalculée automatiquement lorsque vous changez la fonction SUBNM.

Lorsque les options de calcul sont définies sur Manuel :v Si vous définissez UseBookRecalcSetting = "true", la feuille Web n'est

pas recalculée automatiquement. Pour la recalculer, vous devez cliquersur le bouton Recalculer.

v Si vous définissez UseBookRecalcSetting = "false", la feuille Web estrecalculée automatiquement lorsque vous changez la fonction SUBNM.

WebsheetBackgroundRecalculationMode

Définit le niveau de recalcul en arrière-plan qui se produit pour une feuilleWeb.

Les appels à WebSheetService.scrollWebSheet peuvent prendrequelques secondes, car les données ne sont pas aisément disponibles.Utilisez le paramètre WebsheetBackgroundRecalculationMode pourrecalculer le livre en arrière-plan de manière que les données nécessairessoient prêtes lorsqu'elles sont réclamées.

Si ce paramètre est défini sur 0 (valeur par défaut), seule la zone mise enmémoire tampon (visible) est calculée lors de l'actualisation d'une feuille.

S'il est défini sur 1, la zone adjacente à la zone en mémoire tampon estcalculée, en plus de celle-ci. Le temps d'attente est réduit si l'utilisateur faitdéfiler le fichier pour s'éloigner légèrement de la zone visible de départ.

Si la valeur est définie sur 2, la totalité de la feuille de calcul en cours estcalculée. Le temps d'attente est réduit si l'utilisateur fait défiler le fichierpour s'éloigner de toutes les zones de la feuille en cours.


Si la valeur est définie sur 3, la totalité du classeur en cours est calculée. Letemps d'attente est réduit si l'utilisateur affiche une zone de la feuille encours ou d'une autre feuille.

Remarque : Plus le nombre est élevé, plus le nombre de cellules calculéescroît, augmentant ainsi la charge sur le serveur Web.

X-Frame-Options

Le paramètre X-Frame-Options définit l'en-tête de réponseX-Frame-Options. Le paramètre (et l'en-tête de réponse) indique si lenavigateur doit être autorisé à afficher une page TM1 Web dans un<cadre>, un <iframe> ou un <objet>. Utilisez ce paramètre pour éviter lesattaques de type détournement de clic et empêcher l'intégration ducontenu TM1 Web à d'autres sites. Trois valeurs sont admises pour ceparamètre.v 0 correspond à l'en-tête de réponse DENY, qui empêche tout domaine

d'insérer le contenu TM1 Web dans des cadres.v 1 correspond à l'en-tête de réponse SAMEORIGIN, qui autorise

uniquement le domaine actuel à insérer le contenu TM1 Web dans descadres.

v 2 correspond à la valeur d'en-tête de réponse ALLOW-FROM. Dans cecas, TM1 Web vérifie dans le paramètre CrossDomainAccessList dufichier tm1web_config.xml la liste des URL interdomaine autorisées àaccéder au contenu TM1 Web et à l'utiliser dans des cadres.L'en-tête de réponse ALLOW-FROM n'est pas pris en charge par tous lesnavigateurs. TM1 Web utilise les valeurs de CrossDomainAccessListpour déterminer si le domaine est autorisé. S'il ne l'est pas, TM1 Webinsère l'en-tête de réponse DENY, qui empêche l'utilisation dans descadres. Il peut arriver que TM1 Web ne puisse pas déterminer ledomaine d'origine de la demande. Dans ce cas, l'en-tête de réponseSAMEORIGIN est inclus.

Si le paramètre X-Frame-Options est omis ou vide, deux (2) est la valeurpar défaut.

Les fichiers .jsp de TM1 Web n'insèrent l'en-tête de réponseX-Frame-Options que pour les valeurs DENY et SAMEORIGIN. Sil'autorisation du domaine est vérifiée, l'en-tête X-Frame-Options est inclus.

Edition du fichier de configuration de Cognos TM1 WebVous pouvez éditer le fichier de configuration d'IBM Cognos TM1 Web pour yconfigurer différents paramètres.

Le fichier de configuration de Cognos TM1 Web est un fichier xml qui ne doit êtreouvert qu'avec un éditeur de type XML. Si vous l'ouvrez avec un éditeur de textestandard, tel que Microsoft Wordpad, il risque d'être corrompu par l'ajout decaractères incorrects.

A partir de Cognos TM1 Web version 10.2, le nouveau fichier tm1web_config.xmlremplace le fichier web.config des versions précédentes de Cognos TM1 Web.

Procédure1. Localisez et ouvrez le fichier tm1web_config.xml qui se trouve à l'emplacement

suivant :<emplacement d'installation TM1>\webapps\tm1web\WEB-INF\configuration\


Remarque : Le fichier tm1web_config.xml est un fichier xml qui ne doit êtreouvert qu'avec un éditeur de type XML. Si vous l'ouvrez avec un éditeur detexte standard, tel que Microsoft WordPad, il risque d'être corrompu par l'ajoutde caractères incorrects.

2. Editez les paramètres et enregistrez vos modifications.3. Connectez-vous à IBM Cognos TM1 Web pour vérifier le résultat de vos

modifications.

Configuration de la page de connexion Cognos TM1 Web àl'aide des paramètres AdminHostName et TM1ServerName

Les paramètres AdminHostName et TM1ServerName déterminent si la page deconnexion IBM Cognos TM1 Web invite l'utilisateur à entrer des valeurs pourl'hôte admin TM1 et le serveur TM1.

Si vous définissez une valeur pour un de ces paramètres dans le fichiertm1web_config.xml, le processus de connexion utilise la valeur spécifiée sansinviter l'utilisateur à spécifier ces informations.

Paramètre AdminHostName

Ce paramètre spécifie le nom de l'hôte admin sur lequel s'exécute un serveuradmin TM1. Editez le paramètre AdminHostName dans le fichier tm1web_config.xmlen utilisant le format suivant :<add key="AdminHostName" value="HostName"/>

où HostName peut correspondre à l'une des valeurs suivantes :v Si HostName est vide (valeur par défaut), la page de connexion affiche l'invite de

saisie de l'hôte admin.v Si HostName a pour valeur le nom d'un hôte admin TM1 valide, IBM Cognos

TM1 Web utilise cet hôte admin pour le processus de connexion et n'invite pasl'utilisateur à entrer une valeur.

Paramètre TM1ServerName

Ce paramètre définit le nom du serveur TM1. Editez le paramètre TM1ServerNamedans le fichier tm1web_config.xml en utilisant le format suivant :<add key="TM1ServerName" value="ServerName"/>

où ServerName peut correspondre à l'une des valeurs suivantes :v Si ServerName est vide (valeur par défaut), l'invite du serveur TM1 est affichée

dans la page de connexion IBM Cognos TM1 Web.v Si ServerName a pour valeur un nom de serveur TM1 valide, la page de

connexion n'affiche pas d'invite de saisie de l'hôte admin ou du serveur TM1.v Si le paramètre AdminSvrSSLCertID n'est pas configuré correctement, la liste

déroulante des noms de serveur est vide et une erreur est consignée dans lefichier journal de Cognos TM1 Web. Pour plus d'informations, voir la sectionExécution de TM1 en mode sécurisé à l'aide de SSL dans le document TM1Operation.

Une fois que l'utilisateur a entré un nom d'utilisateur et un mot de passe valides,IBM Cognos TM1 Web se connecte au serveur TM1 spécifié par le paramètreTM1ServerName dans le fichier tm1web_config.xml.


Par exemple, le paramètre TM1ServerName peut être défini à planning sample,comme indiqué dans le code suivant.<add key="TM1ServerName" value="planning sample" />

Configuration d'une page d'accueil personnalisée pour IBMCognos TM1 Web

Vous pouvez configurer une page d'accueil personnalisée pour IBM Cognos TM1Web afin d'afficher une feuille Web, une vue de cube ou une adresse URL une foisque des utilisateurs se sont connectés à IBM Cognos TM1 Web. Cette paged'accueil fournit aux utilisateurs un point de départ pour accéder aux donnéesTM1 et les manipuler.

Une page d'accueil peut être configurée globalement pour tous les utilisateursd'IBM Cognos TM1 Web ou affectée individuellement à différents utilisateurs ougroupes d'utilisateurs. Par exemple, si vous configurez l'option de page d'accueilpour l'affichage d'un fichier HTML ou un autre type de page Web, vous pouvezfournir aux utilisateurs des instructions, des tâches, des liens ou tout autre contenuaffichable sur une page Web.

Si une page d'accueil est configurée, elle s'affiche dans le premier onglet d'IBMCognos TM1 Web et ne peut pas être fermée par les utilisateurs. S'il est configuré,le lien Accueil est affiché dans la zone d'en-tête d'IBM Cognos TM1 Web et permetaux utilisateurs de revenir facilement à la page d'accueil.

Vous pouvez configurer une page d'accueil IBM Cognos TM1 Web de l'une desfaçons suivantes :

Page d'accueil différente pour différents utilisateurs d'IBM Cognos TM1 WebUtilisez la boîte de dialogue Paramètres du client dans TM1 Architect etl'explorateur de serveur afin de configurer une page d'accueil de départpour différents clients (utilisateurs) d'IBM Cognos TM1 Web.

Page d'accueil globale pour tous les utilisateurs d'IBM Cognos TM1 WebUtilisez le paramètre HomePageObject qui figure dans le fichiertm1web_config.xml pour configurer une page d'accueil qui s'applique defaçon générale à tous les utilisateurs d'IBM Cognos TM1 Web.

Remarque : Toute affectation de page d'accueil réalisée avec la boîte de dialogueParamètres du client peut remplacer le paramètrage global du fichiertm1web_config.xml si vous définissez AllowOverwrite=true dans le paramètreHomePageObject de ce fichier.

Configuration de pages d'accueil différentes pour desutilisateurs précisLa boîte de dialogue Paramètres du client, dans Architect et dans l'explorateur deserveur, permet de configurer la page d'accueil des différents clients (utilisateurs)d'IBM Cognos TM1 Web.

Par exemple, vous pouvez affecter une page d'accueil aux utilisateurs d'IBMCognos TM1 Web du service Ventes et une autre page d'accueil aux utilisateurs duservice Comptabilité.

Remarque : Vous pouvez utiliser la boîte de dialogue Paramètres du client pouraffecter des pages d'accueil à des utilisateurs précis, remplaçant ainsi le réglagede page d'accueil globale du paramètre HomePageObject dans le fichiertm1web_config.xml.


Procédure1. Dans Architect ou l'explorateur de serveur, cliquez avec le bouton droit de la

souris sur le serveur et sélectionnez Sécurité, Clients/Groupes.La boîte de dialogue Clients/Groupes s'affiche.

2. Cliquez sur Paramètres.La boîte de dialogue Paramètres du client s'ouvre.

3. Sélectionnez dans la liste Client actuel le client auquel s'applique le paramètrede page d'accueil.

4. Entrez la feuille Web, la vue de cube ou l'URL de la page d'accueil :v Pour afficher une URL, saisissez-la, avec le protocole http://, dans la zone

Page d'accueil. Vous pouvez entrer l'URL d'un site Web ou d'un fichierprécis.

v Pour sélectionner une feuille Web ou vue de cube comme page d'accueil,cliquez sur Parcourir. La boîte de dialogue Sélectionnez une page d'accueilIBM Cognos TM1 Web s'affiche, et vous pouvez y sélectionner une référenceà une feuille Web ou vue de cube depuis l'arborescence Application.

Après avoir sélectionné une référence de feuille Web ou vue de cube, cliquezsur OK pour retourner à la boîte de dialogue Paramètres du client.

5. Sélectionnez les paramètres qui contrôlent l'apparence de la sous-fenêtre denavigation.

Remarque : Les paramètres de la sous-fenêtre de navigation que vousdéfinissez ici s'appliquent uniquement si la valeur du paramètre correspondantdans le fichier tm1web_config.xml est AllowOverwrite=true. Pour plusd'informations, voir «Configuration des paramètres de démarrage etd'apparence d'IBM Cognos TM1 Web», à la page 126.Les paramètres disponibles pour contrôler l'apparence de la sous-fenêtre denavigation sont :v Inclure la sous-fenêtre de navigation - Détermine si la sous-fenêtre de

navigation est affichée ou non lorsque le client sélectionné se connecte à IBMCognos TM1 Web.

v Ouvrir la sous-fenêtre à la connexion - Définit l'affichage en mode agrandide la sous-fenêtre de navigation quand le client sélectionné se connecte àIBM Cognos TM1 Web.

v Fermer la sous-fenêtre à la connexion - Définit l'affichage en mode réduit dela sous-fenêtre de navigation quand le client sélectionné se connecte à IBMCognos TM1 Web.

v Enregistrer les paramètres de la sous-fenêtre de navigation du client -Détermine si les paramètres personnels de la sous-fenêtre de navigation sontenregistrés quand le client se déconnecte d'IBM Cognos TM1 Web.

6. Sélectionnez une des options de la liste Appliquer à pour configurer les clientscapables d'afficher la page d'accueil.v Client actuel - Applique le paramètre de page d'accueil uniquement au

client sélectionné dans la liste Client actuel.v Clients sélectionnés - Active le bouton Sélectionner permettant d'ouvrir

l'éditeur de sous-ensemble afin de sélectionner une collection de clients quiutiliseront le même réglage de page d'accueil.

v Tous les clients - Applique le même réglage de page d'accueil à tous lesclients TM1.


Si vous choisissez Clients sélectionnés, puis cliquez sur Sélectionner, l'éditeurde sous-ensemble, dans lequel vous pouvez sélectionner un sous-ensemble desclients TM1 utilisant la page d'accueil, s'ouvre.Utilisez l'éditeur de sous-ensemble pour sélectionner un sous-ensemble declients, puis cliquez sur OK pour retourner à la boîte de dialogue Paramètresdu client. Le nombre de clients sélectionnés dans l'éditeur de sous-ensemble estrésumé dans la boîte de dialogue Paramètres du client.

7. Cliquez sur Appliquer les paramètres pour configurer la page d'accueil desclients sélectionnés dans la liste Appliquer à.

8. Répétez les étapes 4, 5, 6 et 7 afin de configurer une page d'accueil pour unensemble différent de clients TM1.

9. Cliquez sur OK pour fermer la boîte de dialogue Paramètres du client.Vous venez de configurer une page d'accueil pour IBM Cognos TM1 Web. Lesclients IBM Cognos TM1 Web sélectionnés verront la page d'accueil affectée àleur prochaine connexion à IBM Cognos TM1 Web.

Configuration d'une page d'accueil globale pour tous lesutilisateursLe paramètre HomePageObject du fichier tm1web_config.xml active une paged'accueil globale qui s'affiche pour tous les utilisateurs d'IBM Cognos TM1 Web.

Remarque : Vous pouvez remplacer le paramètre global HomePageObject enutilisant la boîte de dialogue Paramètres du client pour affecter différentes pagesd'accueil à des clients Cognos TM1 individuels. Pour plus d'informations, voir«Configuration de pages d'accueil différentes pour des utilisateurs précis», à lapage 121.

Le paramètre HomePageObject s'applique à trois types d'objet :v Cube Viewerv Feuille Webv URL

L'objet page d'accueil s'affiche lorsque l'utilisateur s'est connecté à IBM CognosTM1 Web.

Utilisation du paramètre HomePageObject :

Mode d'utilisation du paramètre HomePageObject.

Le paramètre HomePageObject utilise le format suivant :

<add key="HomePageObject" value="ObjectPath ;Type= ObjectType ;Description=ObjectTitle ; AllowOverwrite =true" />

où :v chemin_objet correspond au chemin de l'objet feuille Web, vue de cube ou URL à

ouvrir. Le format exact du chemin dépend du type d'objet.v type_objet est le mot clé associé à l'objet à ouvrir : feuille Web, Cube Viewer ou

URL.v titre_objet est un titre bref que vous affectez à l'objet qui s'affiche dans la barre de

titre du navigateur Web et sur l'onglet de page d'accueil dans IBM Cognos TM1Web.

v AllowOverwrite peut être défini sur la valeur true ou false comme suit :


Si vous réglez AllowOverwrite=true, le paramètre HomePageObject peut êtreremplacé en définissant une page d'accueil différente pour des clients précis àl'aide de la boîte de dialogue Paramètres du client dans Architect et l'explorateurde serveur.

Si vous définissez AllowOverwrite=false, le paramètre HomePageObject s'appliqueglobalement à tous les utilisateurs TM1 et ne peut pas être configuréindividuellement à l'aide de la boîte de dialogue Paramètres du client dansArchitect et l'explorateur de serveur.

Les sections suivantes décrivent l'emploi du paramètre HomePageObject pour desfeuilles Web, vues de cube et URL.

Définition d'une vue de cube comme page d'accueil d'IBM Cognos TM1 Web :

Utilisez le format ci-après pour définir une vue de cube comme page d'accueild'IBM Cognos TM1 Web.value=CubeName$$ViewName$$Status

où les arguments suivants sont séparés par des caractères $$ :v CubeName est le nom du cube auquel la vue appartient.v ViewName est le nom de la vue de cube à afficher.v Status est le statut public ou privé de la vue de cube.

Remarque : Vous devez inclure la valeur PUBLIC ou PRIVATE pour identifiercorrectement la vue de cube que vous souhaitez ouvrir.

Par exemple, pour ouvrir une vue publique nommée Price depuis le cubeSalesCube :&ltadd key="HomePageObject" value="SalesCube$$Price$$Public;Type=cubeviewer;Description=MyStartCube;AllowOverwrite=true"/>

Définition d'une feuille Web comme page d'accueil IBM Cognos TM1 Webglobale :

Vous pouvez affecter une feuille Web comme page d'accueil IBM Cognos TM1Web, selon la manière dont le fichier Excel a été inclus dans TM1.

Ouverture d'une feuille Web référençant un fichier Excel hors de TM1 :

Vous pouvez ouvrir une feuille Web référençant un fichier Excel.

Procédure

Utilisez le format suivant :value="WebsheetPath

où WebsheetPath est l'emplacement et le nom du fichier Excel. Il peut s'agir duchemin d'un fichier local ou d'un chemin UNC pour un fichier situé sur un réseau.Par exemple, pour définir un chemin réseau UNC pour feuille Web :value=//MySystem/Samples/classic_slice.xls


Résultats

Le paramètre HomePageObject complet se présente comme suit :<add key="HomePageObject" value="//MySystem/Samples/classic_slice.xls;Type=websheet;

Description=MyWebsheet;AllowOverwrite=true"/>

Ouverture d'un objet de feuille Web qui a été téléchargé sur le serveur TM1 :

Vous pouvez ouvrir un objet de feuille Web qui a été téléchargé.

Procédure

1. Dans l'explorateur de serveur, utilisez la sous-fenêtre Propriétés pour trouver lenom TM1 affecté au fichier Excel téléchargé.

2. Définissez le paramètre de valeur à l'aide du format suivant :value="TM1://ServerName/blob/PUBLIC/.\}Externals\TM1_Filename

où :v ServerName est le nom du serveur TM1 sur lequel se trouve le fichier Excel.v TM1_location est le nom affecté par TM1 au fichier Excel téléchargé.Exemple :value="TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls

La ligne complète du paramètre HomePageObject se présente comme suit :<add key="HomePageObject" value="TM1://sdata/blob/PUBLIC/.\}Externals\Report_2006.xls_20070123212746.xls;Type=websheet;Description=MyUploaded Websheet;AllowOverwrite=true" />

Définition d'une page d'accueil IBM Cognos TM1 Web globale sur une URL :

Vous pouvez définir le paramètre HomePageObject sur une URL.

Utilisez ce format :value="URL_Path

Où Chemin_URL peut pointer à un site Web ou un fichier de page Web précis.

Par exemple :

Figure 6. Exemple de nom affecté pour un fichier Excel téléchargé dans l'explorateur du serveur


v Pour définir comme page d'accueil une URL qui pointe vers un fichier :<addkey="HomePageObject" value="homepage.html;Type=URL;

Description=MyStart Page;AllowOverwrite=true"/>

v Pour définir comme page d'accueil une URL qui pointe vers un site Web :<addkey="HomePageObject" value="http://www.ibm.com;Type=URL;

Description=IBM;AllowOverwrite=true"/>

Configuration des paramètres de démarrage et d'apparenced'IBM Cognos TM1 Web

Vous pouvez contrôler l'apparence de la sous-fenêtre de navigation, de la barred'onglets, et des barres d'outils des feuilles Web et de Cube Viewer à la dispositiondes utilisateurs qui se connectent à IBM Cognos TM1 Web.

Ces paramètres se trouvent dans le fichier tm1web_config.xml et s'appliquentglobalement à tous les utilisateurs d'IBM Cognos TM1 Web.

Remarque : Pour plus d'informations sur l'utilisation du paramètreHomePageObject et la définition d'une page d'accueil personnalisée, voir«Configuration d'une page d'accueil personnalisée pour IBM Cognos TM1 Web», àla page 121.

Paramètre NavTreeHiddenLe paramètre NavTreeHidden détermine si la sous-fenêtre de navigation s'affichelorsque les utilisateurs se connectent à IBM Cognos TM1 Web.

Il permet d'afficher une page d'accueil personnalisée pour les utilisateurs et demasquer complètement la sous-fenêtre de navigation.

Le paramètre NavTreeHidden utilise le format suivant dans le fichiertm1web_config.xml :<add key="NavTreeHidden" value="false;AllowOverwrite=true"/>

où :

value peut être True ou False.v Si la valeur est false, la sous-fenêtre de navigation est affichée lorsque les

utilisateurs se connectent à IBM Cognos TM1 Web.v Si la valeur est true, la sous-fenêtre de navigation n'est pas affichée lorsque les

utilisateurs se connectent à IBM Cognos TM1 Web.

AllowOverwrite peut avoir comme valeur true ou false comme suit :v Si vous définissez AllowOverwrite=true, le paramètre NavTreeHidden est affecté

globalement à tous les utilisateurs, mais peut être remplacé pour des clientsprécis à l'aide de la boîte de dialogue Paramètres du client dans Architect etl'explorateur de serveur.

v Si vous définissez AllowOverwrite=false, le paramètre NavTreeHiddens'applique globalement à tous les utilisateurs TM1 et ne peut pas être remplacépour des clients précis via la boîte de dialogue Paramètres du client dansArchitect et l'explorateur de serveur.


Paramètre NavTreeCollapsedOnStartLe paramètre NavTreeCollapsedOnStart détermine si la sous-fenêtre de navigationest réduite ou agrandie lorsque les utilisateurs se connectent. Si elle est réduite,une petite barre verticale s'affiche pour permettre à l'utilisateur de restaurer lasous-fenêtre.

Le paramètre NavTreeCollapsedOnStart utilise le format suivant dans le fichiertm1web_config.xml :<add key="NavTreeCollapsedOnStart" value="false;AllowOverwrite=true"/>

où :

value peut être true ou false.v Si la valeur est false, la sous-fenêtre de navigation est agrandie et s'affiche dans

son mode par défaut lorsque les utilisateurs se connectent à IBM Cognos TM1Web.

v Si la valeur est true, la sous-fenêtre de navigation est réduite lorsque lesutilisateurs se connectent à IBM Cognos TM1 Web.

AllowOverwrite peut avoir comme valeur true ou false comme suit :v Si vous définissez AllowOverwrite=true, le paramètre NavTreeCollapsedOnStart

est affecté globalement à tous les utilisateurs, mais peut être remplacé pour desclients précis via la boîte de dialogue Paramètres du client dans TM1 Architect etl'explorateur de serveur.

v Si vous définissez AllowOverwrite=false, le paramètre NavTreeCollapsedOnStartest appliqué globalement à tous les utilisateurs TM1, mais peut être remplacépour des clients précis via la boîte de dialogue Paramètres du client dans TM1Architect et l'explorateur de serveur.

Paramètre HideTabBarLe paramètre HideTabBar détermine si IBM Cognos TM1 Web peut afficherplusieurs onglets lorsqu'un utilisateur ouvre plusieurs objets IBM Cognos TM1Web, ou si une seule vue est affichée.

Ceci peut être utile pour limiter les utilisateurs à une vue à la fois.

Le paramètre HideTabBar utilise le format suivant dans le fichiertm1web_config.xml :<add key="HideTabBar" value="false;AllowOverwrite=true"/>

où value peut être true ou false.v Si value est false, plusieurs onglets peuvent être affichés. Il s'agit du

comportement par défaut d'IBM Cognos TM1 Web.

Figure 7. Exemple de paramètre HideTabBar


v Si value est true, il n'est pas possible d'afficher plusieurs onglets et un seul objetà la fois peut être ouvert.

L'option AllowOverwrite n'est pas actuellement utilisée pour ce paramètre.

Paramètre HideWebsheetToolBarLe paramètre HideWebsheetToolBar détermine si la barre d'outils de feuille Webest affichée quand les utilisateurs ouvrent une feuille Web.

Le paramètre HideWebsheetToolBar utilise le format suivant dans le fichiertm1web_config.xml :<add key="HideWebsheetToolBar" value="false;AllowOverwrite=true"/>

où value peut être true ou false.v Si la valeur est false, la barre d'outils des feuilles Web s'affiche dans IBM Cognos

TM1 Web.v Si la valeur est true, la barre d'outils des feuilles Web ne s'affiche pas dans IBM

Cognos TM1 Web.

L'option AllowOverwrite n'est pas utilisée actuellement pour ce paramètre.

Paramètre HideCubeviewerToolBarLe paramètre HideCubeviewerToolBar détermine si la barre d'outils de CubeViewer est affichée quand les utilisateurs ouvrent une vue de cube.

Le paramètre HideCubeviewerToolBar utilise le format suivant dans le fichiertm1web_config.xml :<add key="HideCubeviewerToolBar" value="false;AllowOverwrite=true"/>

où value peut être true ou false.v Si la valeur est false, la barre d'outils des feuilles Web s'affiche dans IBM Cognos

TM1 Web.v Si la valeur est true, la barre d'outils des feuilles Web ne s'affiche pas dans IBM

Cognos TM1 Web.

L'option AllowOverwrite n'est pas utilisée actuellement pour ce paramètre.

Affichage ou masquage du noeud Vues dans la sous-fenêtre denavigationVous pouvez afficher ou masquer le noeud Vues dans la sous-fenêtre denavigation.

Procédure1. Editez tm1web_config.xml dans le répertoire virtuel d'IBM Cognos TM1 Web.2. Identifiez le paramètre NavTreeDisplayServerView, qui contrôle l'affichage du

noeud Vue du serveur. La valeur par défaut, Y, permet d'afficher le noeudVues dans la sous-fenêtre de navigation.

<add key="NavTreeDisplayServerView" value="Y" />

3. Pour masquer le noeud Vues, remplacez la valeur deNavTreeDisplayServerView par N.

4. Enregistrez le fichier tm1web_config.xml.5. Connectez-vous à IBM Cognos TM1 Web.

La sous-fenêtre de navigation s'affiche sans le noeud Vues.

Modification de la taille des pages de Cube ViewerVous pouvez modifier le nombre de lignes et de colonnes affichées dans lenavigateur Cube Viewer d'IBM Cognos TM1 Web.

Par défaut, Web Cube Viewer affiche les pages de données TM1 sur 20 colonnes et100 lignes, et inclut la liste des dimensions dans le nombre de lignes.

Procédure1. Editez le fichier tm1web_config.xml.2. Identifiez le code suivant :

CubeViewerRowPageSize

CubeViewerColumnPageSize

3. Changez la valeur de taille de page en lignes et/ou colonnes.4. Enregistrez le fichier tm1web_config.xml.5. Connectez-vous à IBM Cognos TM1 Web.

Par exemple, si vous définissez la taille de page à 10 lignes, Cube Vieweraffiche neuf lignes de données, plus la ligne de dimensions.

Réglage du nombre maximum de feuilles à exporter depuis unCube Viewer

Par défaut, le nombre maximum de feuilles pouvant être exportées d'un CubeViewer vers une imprimante est de 100. Vous pouvez configurer IBM Cognos TM1Web pour qu'il exporte un plus grand nombre de feuilles.

Procédure1. Editez le fichier tm1web_config.xml.2. Identifiez le code suivant :

MaximumSheetsForExport

3. Changez la valeur pour le nombre maximum de feuilles à exporter.4. Enregistrez le fichier tm1web_config.xml.5. Connectez-vous à IBM Cognos TM1 Web.

Retour à la ligne des valeurs chaîne dans les vues de cubeCubeviewerStringWrap permet de définir les paramètres utilisés pour l'affichagedes cellules d'élément chaîne dans une vue Web Cube.

Pour contrôler l'affichage et les retours à la ligne dans une vue, utilisez leparamètre CubeviewerStringWrap et enregistrez le fichier de configuration Web.Les cellules non affichées sont néanmoins modifiables dans une boîte de défilementen cliquant sur la zone du retour à la ligne.

EnabledActive ou désactive le retour à la ligne dans les cellules de la vuecontenant des chaînes. Si la valeur est "False", la colonne est aussi largeque la plus longue chaîne de la vue, toutes lignes prises en compte. Lavaleur "True" met en oeuvre le retour à la ligne avec les paramètres pardéfaut ci-dessous.


MinCharactersToWrapNombre minimal de caractères avant le retour à la ligne. Par exemple, leschaînes de moins de 50 caractères ne sont pas renvoyées à la ligne dans lescellules. Définissez 50 par défaut.

MaxDisplayCharactersNombre maximal de caractères affichables dans une cellule de type chaîne.La cellule peut contenir un nombre de caractères plus important, mais ilsne seront affichés que si l'utilisateur clique deux fois sur la cellule. Si lavaleur de MinCharactersToWrap est 50, et celle de MaxDisplayCharactersest 200, les cellules de type chaîne contenant 200 caractères ou plusconsommeront environ 4 lignes. Définissez 200 par défaut.

WidthOfWrapCellNombre de caractères de la portion mise à la ligne de l'affichage.Définissez 240 par défaut.

Utilisez le format suivant dans le fichier tm1web_config.xml (un retour chariot a étéinséré dans le texte suivant dans un souci de clarté, mais vous ne devez pas lefaire).<add key="CubeviewerStringWrap" value="Enabled=true;MinCharactersToWrap=50;MaxDisplayCharacters=200;WidthOfWrapCell=240" />

A faire : CubeviewerStringWrap ne s'applique pas aux feuilles Web.

Définition du délai d'expiration de la session de TM1 WebLe délai d'expiration de la session par défaut de TM1 Web est de 20 minutes. Vouspouvez modifier ce paramètre en fonction de votre environnement.


Le délai de session de TM1 Web est déterminé par le paramètre <session-timeout>du fichier web.xml.<session-config>

<session-timeout>20</session-timeout></session-config>

Le fichier web.xml se trouve dans votre répertoire <répertoire_installation>\webapps\tm1web\WEB-INF . Par exemple, C:\Program Files\IBM\cognos\tm1_64\webapps\tm1web\WEB-INF.

Si TM1 Web est déployé sur IBM Planning Analytics Workspace, le délaid'expiration de la session recommandé est de 60 minutes. Notez quel'augmentation du délai d'expiration de la session peut accroître la quantité demémoire utilisée sur votre système.

Procédure1. Ouvrez le fichier web.xml dans un éditeur de texte.2. Modifiez la valeur <session-timeout>.3. Enregistrez et fermez le fichier web.xml.4. Redémarrez le service IBM TM1 Application Server.


Configuration du navigateur Web pour Cognos TM1 WebCette section décrit les étapes de configuration du navigateur Web applicables àIBM Cognos TM1 Web et qui peuvent être requises dans votre environnementaprès l'installation initiale.

Les utilisateurs se connectent à Cognos TM1 Web à l'aide de l'un des navigateursWeb compatibles s'exécutant sur leur propre ordinateur. Des opérations deconfiguration supplémentaires peuvent être nécessaires.

Configuration de la langue du navigateur Web pour CognosTM1 Web

Les paramètres linguistiques définis dans votre navigateur Web déterminent lalangue utilisée dans l'interface IBM Cognos TM1 Web.


Suivez la procédure générale ci-dessous pour configurer Microsoft InternetExplorer et Mozilla Firefox de sorte qu'IBM Cognos TM1 Web s'affiche dans votrelangue principale. Pour des informations plus détaillées, consultez ladocumentation de votre navigateur.

Procédure1. Selon le navigateur Web que vous utilisez, utilisez les options de langue

disponibles pour sélectionner et configurer votre langue principale.v Dans Internet Explorer, les options de langue se trouvent généralement dans

le menu Tools > Internet Options > General > Languages.v Dans Firefox, les options de langue se trouvent généralement dans le menu

Tools > Options > Content > Languages.2. Ajoutez votre langue à la liste des langues.3. Organisez la liste de façon que la langue souhaitée soit la première.

Affichage et saisie de nombres dans Cognos TM1 Web enfonction des paramètres régionaux

Si vous exécutez le client IBM Cognos TM1 Web dans une langue autre que cellede votre système d'exploitation, assurez-vous que la langue de votre navigateurWeb et le paramètre régional Microsoft Windows ont la même valeur.

Ainsi, vous pouvez afficher et entrer les nombres dans Cognos TM1 Web enfonction d'un paramètre régional spécifique.

Par exemple, si vous disposez d'un système d'exploitation en anglais mais voulezexécuter Cognos TM1 Web en français, la langue de votre navigateur doit être lefrançais, tout comme le paramètre de langue sur votre ordinateur.

Paramètres Région et langue de Windows

Accédez aux paramètres régionaux de Windows en ouvrant la fonctionnalitéHorloge, langue et région dans le panneau de configuration de Windows.


Paramètre linguistique du navigateur Web

Accédez aux paramètres linguistiques de votre navigateur Web comme décrit à lasection «Configuration de la langue du navigateur Web pour Cognos TM1 Web», àla page 89.

Configuration d'Internet Explorer pour Cognos TM1 WebSi vous utilisez IBM Cognos TM1 Web avec Microsoft Internet Explorer, veillez à ceque ce paramètre de sécurité soit activé pour permettre un affichage correct desfenêtres de boîte de dialogue Cognos TM1 Web.

Modifiez les paramètres de sécurité de la façon suivante :v Autorisez les sites Web à ouvrir des fenêtres sans barre d'adresse ni barre de

statut.v Autorisez les fenêtres initialisées par des scripts sans contrainte de taille ou de

position.

Si Internet Explorer n'est pas configuré correctement, certaines boîtes de dialogueCognos TM1 Web peuvent être tronquées.

Exécution de Cognos TM1 Web sur un serveur WAN etexportation des fichiers Excel et PDF

Si vous exécutez IBM Cognos TM1 Web sur un serveur WAN et souhaitezautoriser les utilisateurs à exporter des fichiers Microsoft Excel et PDF depuisCognos TM1 Web, vous devez configurer des paramètres de sécurité particuliersdans Microsoft Internet Explorer.

Puisque les serveurs WAN résident dans la zone Internet, Internet Explorerapplique un profil de sécurité différent de celui qui est appliqué aux serveurs quise trouvent dans la zone intranet locale. Pour pouvoir exporter des fichiers depuisCognos TM1 Web dans un environnement WAN, vous devez ajouter le serveurCognos TM1 Web comme site de confiance dans les paramètres de sécurité pourInternet Explorer.

Ajout de Cognos TM1 Web comme site de confiance dansInternet ExplorerSi vous utilisez Microsoft Internet Explorer et si vous exécutez IBM Cognos TM1Web sur un serveur WAN, vous devez ajouter le serveur Cognos TM1 Web commesite de confiance, puis personnaliser les paramètres de sécurité des sites deconfiance.

Procédure1. Ouvrez Microsoft Internet Explorer.2. Cliquez sur Outils >Options Internet.

La boîte de dialogue Options Internet apparaît.3. Cliquez sur l'onglet Sécurité.4. Cliquez sur Sites de confiance puis cliquez sur le bouton Sites.5. Entrez l'URL du serveur Cognos TM1 Web dans la zone Ajouter ce site Web à

la zone.6. Cliquez sur Ajouter.7. Fermez la boîte de dialogue Sites de confiance.


8. Dans l'onglet Sécurité de la boîte de dialogue Options Internet, cliquez surSites de confiance puis sur le bouton Personnaliser le niveau.La boîte de dialogue Paramètres de sécurité - Zone Sites de confiance apparaît.

9. Identifiez les paramètres de Téléchargements et cochez l'option Activer pourDemander confirmation pour les téléchargements de fichiers.

10. Cliquez sur OK.


Chapitre 11. Installation de Cognos TM1 Application Server

Vous pouvez installer les composants de serveur d'applications Web d'IBM CognosTM1 sur un ordinateur distinct dédié, pour que les utilisateurs d'un environnementréseau puissent accéder au programme. Ces composants comprennent Cognos TM1Application Server et Cognos TM1 Application Gateway.

Cognos TM1 Applications Server doit être déployé sur un serveur d'applicationsWeb Java. Lorsque vous installez Cognos TM1 Application Server, commencez pardéterminer lequel des serveurs d'applications Web suivants vous souhaitezutiliser :v Le serveur d'applications WebSphere Liberty Profile fourniv Votre propre installation d'Apache Tomcatv Votre propre installation d'IBM WebSphere Application Server

Pour obtenir des informations sur l'architecture et le déploiement de Cognos TM1Application Server, voir :v «Architecture de Cognos TM1 Applications», à la page 29v «Déploiement de Cognos TM1 Applications», à la page 35

Déploiement avec la version de serveur WebSphere LibertyProfile fournie

La méthode la plus rapide et la plus simple pour installer et déployer Cognos TM1Application Server consiste à utiliser la version de serveur WebSphere LibertyProfile qui est fournie et installée avec le programme d'installation d'IBM CognosTM1. Cette méthode utilise Cognos Configuration pour démarrer et arrêter CognosTM1 Application Server.

Pour plus d'informations, voir «Installation de Cognos TM1 Application Serveravec le profil WebSphere Liberty fourni», à la page 136.

Déploiement de votre propre serveur d'applications Web

Pour déployer Cognos TM1 Application Server avec votre propre instance d'unserveur d'applications Web Java, utilisez IBM Cognos Configuration pour créerdans un premier temps le pmpsvc.war fichier d'archive de l'application Web, puisdéployez manuellement le fichier.

Pour plus de détails, voir les rubriques suivantes :v «Installation de Cognos TM1 Application Server avec votre propre serveur

d'applications Web Apache Tomcat», à la page 146v «Installation de Cognos TM1 Application Server avec votre propre installation

d'IBM Websphere», à la page 149

Cognos TM1 Application Server avec Windows x64

Si vous exécutez Cognos TM1 Application server sur un système MicrosoftWindows x64 doté du serveur WebSphere Liberty Profile, utilisez la même version32 bits ou 64 bits de Java Runtime Environment (JRE) et du serveur WebWebSphere Liberty Profile. Ne mélangez pas les différentes versions de


plateformes. Par exemple, si vous exécutez la version 64 bits de JRE, utilisezégalement la version 64 bits de WebSphere Liberty Profile.

Intégration de Cognos TM1 Application Server à CognosAnalytics et au portail Cognos Connection

Si votre installation TM1 met en oeuvre l'authentification à l'aide de la sécuritéCognos, les utilisateurs de Cognos Analytics peuvent utiliser le portail CognosConnection au lieu du portail TM1 Applications Web pour ouvrir les applicationsTM1. Cependant, les administrateurs doivent toujours passer par TM1 ApplicationsWeb pour configurer et gérer les applications.

Lorsque vous configurez TM1 Application Server en vue de l'utilisation de lasécurité Cognos, vous activez également l'affichage, dans le portail CognosConnection, d'un dossier qui contient des liens vers les applications TM1disponibles. La liste des applications affichées dépend des droits de l'utilisateur.

Le fichier planning.html contient les informations à partir desquelles CognosAnalytics et le portail Cognos Connection affichent les liens vers les applicationsTM1. Pour plus d'informations, voir «Utilisation de Cognos TM1 Applications avecla sécurité Cognos», à la page 266.

Installation de Cognos TM1 Application Server avec le profilWebSphere Liberty fourni

Vous pouvez installer Cognos TM1 Application Server sur un ordinateur distinct etle déployer avec l'instance de WebSphere Liberty Liberty Profile fournie avecl'installation.

Cette installation est destinée à un environnement dans lequel Cognos TM1 AdminServer et Cognos TM1 Server sont exécutés sur un autre ordinateur.

Installation des composants de Cognos TM1 Web TierCette rubrique décrit la procédure d'installation des fichiers requis pour IBMCognos TM1 Application Server sur un ordinateur distinct.


Utilisez l'un des programmes d'installation suivants pour installer les composantsde Cognos TM1 Web Tier :v IBM Cognos TM1 32 bits pour Windowsv IBM Cognos TM1 64 bits pour Windows

A faire : Si vous prévoyez d'utiliser le client Cognos TM1 Web, une installation deCognos TM1 Web sur le même ordinateur ou sur un autre ordinateur du réseau estnécessaire. Pour installer Cognos TM1 Web sur un ordinateur différent, voirChapitre 10, «Installation de Cognos TM1 Web», à la page 107.


avec le bouton droit sur le fichier issetup.exe, puis cliquez sur Exécuter entant qu'administrateur. Dans le cas des autres systèmes d'exploitation, cliquezdeux fois sur le fichier issetup.exe.


2. Dans le programme d'installation, sélectionnez uniquement les composantssuivants :v TM1 Application Gateway

v TM1 Application Server

v TM1 Web - Ce composant est facultatif. Sélectionnez cette option pourinstaller Cognos TM1 Web sur le même ordinateur que Cognos TM1Application Server.

3. Suivez les invites pour achever l'installation.

Déploiement de Cognos TM1 Application Server avec leserveur d'applications WebSphere Liberty Profile fourni

IBM Cognos TM1 Application Server fonctionne sur le serveur d'applicationsWebSphere Liberty Profile fourni avec l'installation. Utilisez Cognos Configurationpour déployer et démarrer WebSphere Liberty et Cognos TM1 Application Server.


Cognos Configuration.Si vous avez installé le produit depuis le répertoire Program Files (x86) sur unordinateur Windows Vista, Windows 7 ou Windows 2008, démarrez IBMCognos Configuration en tant qu'administrateur.

2. Dans le panneau Explorateur de Cognos Configuration, développez le noeudConfiguration locale > Environnement, cliquez avec le bouton droit sur TM1Application Server, puis cliquez sur Démarrer.Cette action lance la version fournie du serveur WebSphere Liberty Profile, puisdéploie et démarre Cognos TM1 Application Server.

3. Cliquez sur Fichier > Enregistrer et fermez IBM Cognos Configuration.

Configuration de la sécurité authentifiée de Cognos TM1Application Web

Pour les serveurs IBM Cognos TM1 utilisés avec Cognos TM1 Application Web,utilisez l'authentification de sécurité standard de TM1, ou la sécurité d'IBMCognos.


Configurez le mode de connexion authentifiée à l'aide du paramètreIntegratedSecurityMode dans le fichier Tm1s.cfg de chaque serveur Cognos TM1 àutiliser.

Cognos TM1 Application Web est compatible uniquement avec les modesd'authentification de sécurité TM1 suivants :v Mode d'authentification 1 - authentification de sécurité standard TM1v Mode d'authentification 5 - sécurité IBM Cognos

Important : N'utilisez pas des modes d'authentification de sécurité différents pourune même installation de Cognos TM1 Application Web.

Il est recommandé de déterminer le mode de sécurité avant de configurerl'utilisation d'un serveur Cognos TM1 dans Cognos TM1 Application Web, etd'utiliser le même mode de sécurité pour les serveurs que vous ajoutez.

Chapitre 11. Installation de Cognos TM1 Application Server 137

Pour plus de détails sur l'authentification de sécurité et le paramètreIntegratedSecurityMode, voir :v «Sécurité authentifiée», à la page 225v «IntegratedSecurityMode», à la page 332

Procédure1. Ouvrez le fichier répertoire de données du serveur TM1/Tm1s.cfg.2. Définissez le paramètre IntegratedSecurityMode pour le serveur Cognos TM1.v Pour activer l'authentification de sécurité standard de Cognos TM1,

définissez IntegratedSecurityMode=1.v Pour activer la sécurité IBM Cognos, définissez IntegratedSecurityMode=5.Pour plus d'informations sur l'utilisation de la sécurité IBM Cognos, voir :v «Utilisation de Cognos TM1 Applications avec la sécurité Cognos», à la page

266v «Utilisation de la sécurité Cognos avec Cognos TM1», à la page 257

3. Enregistrez et fermez le fichier Tm1s.cfg.4. Redémarrez le serveur Cognos TM1.5. Répétez ces étapes pour tous les autres serveurs Cognos TM1 que vous

souhaitez utiliser avec Cognos TM1 Application Web.

Configuration des environnements client et serveur deCognos TM1 Application Web

Avant d'utiliser IBM Cognos TM1 Application Web, vous devez définir l'hôteAdmin de TM1, le serveur TM1 et les interfaces utilisateur client à utiliser. Aupremier démarrage de Cognos TM1 Application Web, le programme vousdemande de configurer ces choix.

Avant de commencer

Assurez-vous que le serveur TM1 Admin et au moins un serveur TM1 sont encours d'exécution sur l'ordinateur local ou un ordinateur distant auquel vous avezaccès.

Vérifiez que chaque serveur TM1 à utiliser est paramétré avec les valeursadéquates. Pour plus d'informations, voir «Configuration d'un serveur CognosTM1 en vue de son utilisation avec Cognos TM1 Application Web», à la page 142.

Si vous prévoyez d'utiliser Cognos TM1 Application Web, vous devez connaître lenom et le numéro de port du serveur Web sur lequel Cognos TM1 Web s'exécute.

Procédure1. Démarrez Cognos TM1 Application Web et connectez-vous :

a. Dans un navigateur Web, entrez l'URL de Cognos TM1 Application Web :http://localhost:9510/pmpsvc

b. Remplacez localhost par le nom de l'ordinateur sur lequel est installé leserveur Cognos TM1 Applications.

2. Ouvrez la page Configuration de Cognos TM1 Application :v S'il s'agit du premier démarrage de Cognos TM1 Application Web depuis son

installation, la page Configuration s'ouvre.


v Si Cognos TM1 Application Web est déjà configuré, vous êtes invité à saisirun nom d'utilisateur et un mot de passe avant d'ouvrir la page deconfiguration en cliquant sur le bouton d'administration d'IBM Cognos TM1

Applications sur la barre d'outils de la page principale de Cognos TM1Application Web.

3. Dans la zone Hôte Admin, entrez le nom ou l'adresse IP de l'ordinateur surlequel Cognos TM1 Admin Server s'exécute.

Remarque : Les zones Hôte Admin et Nom du serveur sont vides si vousn'avez pas lancé le serveur Admin Cognos TM1 et au moins un serveur CognosTM1.

4. Dans la zone Nom du serveur, entrez le nom du serveur TM1 que vous voulezutiliser avec Cognos TM1 Application Web.Par exemple, vous pouvez définir l'exemple de serveur TM1 GO_New_Stores.Cliquez sur le bouton Actualiser pour mettre à jour la liste des serveursdisponibles.

5. Sélectionnez les clients de contribution de données que vous souhaitez utiliseravec Cognos TM1 Application Web.Ces clients seront disponibles lorsque vous créez des applications avec IBMCognos TM1 Performance Modeler.v Inclure Cognos Insight - Connecté - Client IBM Cognos Insight mettant en

oeuvre un traitement en temps réel avec le serveur TM1.v Inclure Cognos Insight - Réparti - Client IBM Cognos Insight mettant en

oeuvre le traitement local des données. Les données ne sont mises à jour surle serveur TM1 que lors des actions de validation des données.

v Inclure TM1 Application Web - Client par défaut. Le traitement des donnéesse fait en temps réel avec le serveur. Cette option utilise l'infrastructure de lagrille de données et du client graphiques de Cognos TM1 Web et nécessitel'entrée d'une valeur pour l'option URL TM1 Application Web.

6. Si vous avez sélectionné l'option Inclure TM1 Application Web, entrez unevaleur pour l'option URL de TM1 Application Web.Cette URL pointe vers le fichier Contributor.jsp sur le serveur Web quihéberge Cognos TM1 Web.Par exemple :http://WebServer:9510/tm1web/Contributor.jsp

où WebServer est le nom de l'ordinateur sur lequel Cognos TM1 Web estinstallé.

7. Cliquez sur OK.8. Si vous y êtes invité, entrez le nom d'utilisateur et le mot de passe du serveur

et cliquez sur Connexion.

Conseil : Le nom d'utilisateur et le mot de passe sont respectivement admin etapple si vous utilisez l'une des bases de données d'exemple.La page principale de Cognos TM1 Application Web s'affiche. Cette page estvide jusqu'à ce que vous construisiez ou déployiez des applications à l'intérieurde Cognos TM1 Application Web. Pour plus de détails, voir la documentationd'IBM Cognos Performance Modeler et d'IBM Cognos Insight.


Résultats

Le message suivant signale que le serveur Cognos TM1 que vous utilisez n'est pasconfiguré de façon adéquate pour être utilisé avec Cognos TM1 Application Web :

The new server can be added but it may not be configured with all theoptions required by IBM Cognos TM1 Applications.

Pour plus d'informations sur le façon de configurer ce serveur, voir «Configurationd'un serveur Cognos TM1 en vue de son utilisation avec Cognos TM1 ApplicationWeb», à la page 142.

Paramètres Cognos TM1 Application Server dans CognosConfiguration

Vous pouvez configurer les paramètres de Cognos TM1 Application Server dansCognos Configuration.

Dans Cognos Configuration, cliquez sur Environnement > TM1 ApplicationServer.

Délai d'expiration de la session (minutes)Délai au bout duquel le serveur TM1 se déconnecte en cas d'inactivité. Lavaleur par défaut est 60 minutes.

Chemins qualifiés imposésSi la valeur de ce paramètre est True, un nom de machine fourni commehôte admin est résolu en nom de domaine complet qualifié. En revanche, sila valeur du valeur est False, seul le nom de la machine est utilisé.

Fournisseur de notifications

v DLS (Service de diffusion) : si un serveur de messagerie est configuré,des messages électroniques sont envoyés, mais aucune notificationn'apparaît dans la boîte de réception Cognos.

v HTS (Service de gestion des tâches manuelles) : des notifications sontenvoyées à la boîte de réception Cognos et des messages électroniquessont également envoyés si un serveur de messagerie est configuré.

Par défaut, le paramètre est vide en l'absence de notification.

Activer Business ViewpointSi la valeur de ce paramètre est True, Business Viewpoint peut interagiravec l'installation. En revanche, si sa valeur est False, Business Viewpointne peut pas interagir.

Nom du dossier Cognos ConnectionIndique le nom du dossier Cognos Connection dans lequel figurent lesliens hypertexte des applications TM1 déployées. Par défaut, il s'agit deIBM Cognos TM1 Application - Mes Applications

URI du répartiteur de service d'application TM1Identificateur URI utilisé pour le servlet du répartiteur, par exemplehttp://localhost:9510/pmpsvc/dispatcher/servlet

ID utilisateur et mot de passeID utilisateur et mot de passe utilisés pour l'authentification.

Sous TM1 Application Server, cliquez sur Clients TM1.


URI de distributionSpécifie l'identificateur URI à utiliser pour définir manuellement lesemplacements msi.

Autoriser la mise à disposition des installationsLa valeur true permet aux utilisateurs qui n'ont pas installé les clients deles mettre à disposition et de les installer à partir de TM1 ApplicationServer. En revanche, la valeur false empêche les utilisateurs de mettre àdisposition et d'installer les logiciels clients.

Autoriser la mise à disposition des mises à jourLa valeur True du paramètre permet aux mises à jour qui sont installéessur TM1 Application Server, une version de groupe de correctifs parexemple, d'être mises à la disposition des clients lorsque les utilisateurs seconnectent à nouveau. La valeur False empêche les mises à jour d'êtremises à disposition.

Activer la publication depuis Cognos InsightSi la valeur du paramètre est True, un utilisateur doté des droits Adminpeut publier à partir de Cognos Insight. En revanche, si la valeur est False,l'opération de publication est interdite pour tous les utilisateurs.

Fréquence de ping de Cognos Insight (secondes)Détermine la fréquence à laquelle Cognos Insight vérifie la connectivité àTM1 Application Server. Si Cognos Insight ne reçoit pas de réponse alorsqu'il est en mode réparti, il est implicitement placé en mode hors ligne. Lavaleur par défaut est 30 secondes.

Identification du lien de démarrage de l'URL pour Cognos TM1Application Web

Le lien exact qui permet de démarrer Cognos TM1 Application Web et de s'yconnecter dépend du serveur Web que vous utilisez et de la façon dont il estconfiguré.

Vous pouvez voir l'URL de départ par défaut de Cognos TM1 Application Webdans IBM Cognos Configuration.1. Ouvrez Cognos Configuration.2. Cliquez pour développer Configuration locale > Environnement, puis

sélectionnez TM1 Application Server.3. L'URL est listé dans la colonne de valeur de la zone TM1 Application Server

Gateway URI.Par exemple : http://localhost:9510/pmpsvc

Paramètres du lien

Utilisez le format suivant pour l'URL de connexion à Cognos TM1 ApplicationWeb.

https://WebServer:PortNumber/pmpsvc


Tableau 15. Cognos TM1 Application Web - Paramètres d'URL

Paramètre Description

serveur_web L'un des éléments suivants :

Le mot clé localhost si vous êtes actuellement connecté au serveurWeb qui exécute Cognos TM1 Application Server.

Le nom de la machine ou nom de domaine du serveur Web quihéberge l'application Cognos TM1 Application Server.

L'adresse IP du serveur Web qui héberge l'application Cognos TM1Application Server.

numéro_port Numéro de port que vous avez configuré avec le serveurd'applications Web.

IBM WebSphere - Cliquez sur le lien Serveur Web situé dans laconsole d'administration de WebSphere pour afficher et éditer lesparamètres du port.

Apache Tomcat - Ouvrez le fichier Apache Tomcat server.xml dansl'emplacement ci-dessous, pour afficher et modifier les paramètresdu port :

C:\Program Files\Apache Software Foundation\Tomcat6.0\conf\server.xml.

Exemples de lien

Tableau 16. Cognos TM1 Application Web - Exemples de lien

Serveurd'applications Web En-tête

WebSphere LibertyLiberty fourni avecl'installation

Le lien par défaut en cas d'utilisation de la version fournie deWebSphere Liberty Liberty Profile est :

http://localhost:9510/pmpsvc

Apache Tomcat Le lien habituel pour Cognos TM1 Application Web sur ApacheTomcat est :

http://localhost:8085/pmpsvc

IBM WebSphereApplication Server

Le lien habituel pour Cognos TM1 Application Web sur IBMWebSphere Application Server est :

https://localhost:8443/pmpsvc

Configuration d'un serveur Cognos TM1 en vue de son utilisation avecCognos TM1 Application Web

Avant d'utiliser IBM Cognos TM1 Server avec IBM Cognos TM1 Application Web,modifiez le fichier de configuration du serveur TM1 pour y inclure les paramètreset les valeurs requises.


Les paramètres de configuration suivants dans le fichier Tm1s.cfg de Cognos TM1Server prennent en charge différents sous-composants de Cognos TM1 ApplicationWeb.


v Paramètre AllowSeparateNandCRules : prend en charge Cognos TM1Performance Modeler avec Cognos TM1 Application Web.Voir «AllowSeparateNandCRules», à la page 313.

v Paramètre DistributedPlanningOutputDir : prend en charge le client CognosInsight - Distributed avec Cognos TM1 Application Web.Voir «DistributedPlanningOutputDir», à la page 327.

v Paramètre ForceReevaluationOfFeedersForFedCellsOnDataChange : prend encharge Cognos TM1 Performance Modeler avec Cognos TM1 Application Web.La définition de ce paramètre force la réévaluation d'une instruction de feederlorsque des données sont modifiées.Voir «ForceReevaluationOfFeedersForFedCellsOnDataChange», à la page 330.

Procédure1. Ouvrez le fichier de configuration de Cognos TM1 Server, Tm1s.cfg.2. Pour prendre en charge Cognos TM1 Performance Modeler, modifiez ou

ajoutez la ligne suivante :AllowSeparateNandCRules=T

3. Pour prendre en charge le client Cognos Insight - Distributed, modifiez ouajoutez la ligne suivante :DistributedPlanningOutputDir=.\tunit

4. Modifiez ou ajoutez le paramètreForceReevaluationOfFeedersForFedCellsOnDataChange.

5. Enregistrez le fichier Tm1s.cfg.6. Redémarrez le serveur Cognos TM1.7. Répétez ces étapes pour tous les autres serveurs Cognos TM1 que vous


Configuration d'IBM Cognos TM1Application WebIBM Cognos TM1 utilise IBM Cognos TM1 Web pour prendre en charge le clientCognos TM1 Application Web. Cognos TM1 Application Web permet auxutilisateurs d'afficher les données des applications de planification sous forme degrille et de les modifier. Si vous souhaitez autoriser les utilisateurs à utiliserCognos TM1 Application Web, vous devez configurer cette option.


Lors de l'installation de Cognos TM1 Web, les fichiers requis pour Cognos TM1Application Web sont copiés vers le répertoire d'installation de Cognos TM1.

Le fichier principal de Cognos TM1 Application Web est :

Contributor.jsp

L'emplacement d'installation par défaut est le suivant :

répertoire d'installation de TM1\webapps\tm1web

Configurez le paramètre d'URL de Cognos TM1 Application Web dans CognosTM1 Application Web pour qu'il pointe vers le fichier Contributor.jsp de cerépertoire.


Procédure1. Ouvrez la page Configuration de Cognos TM1 Application Web :v Lors de la première utilisation de Cognos TM1 Application Web, utilisez

la page Configuration qui s'affiche au lancement du programme.Pour plus de détails, voir «Configuration des environnements client etserveur de Cognos TM1 Application Web», à la page 138.

v Si utilisez déjà Cognos TM1 Application Web, vous pouvez rouvrir la pageConfiguration en cliquant sur le bouton d'administration d'IBM Cognos TM1

Applications sur la barre d'outils de Cognos TM1 Application Web.2. Dans la zone URL de TM1 Application Web, entrez l'emplacement URL du

fichier Contributor.jsp.Utilisez le format suivant :http://WebServer:port_number/tm1web/Contributor.jsp

Exemple :http://webserver.example.com:9510/tm1web/Contributor.jsp

3. Cliquez sur OK. La page de connexion de Cognos TM1 Application Webs'affiche.

Journalisation du serveur Cognos TM1 ApplicationLe fichier journal du serveur IBM Cognos TM1 Application vous permet desurveiller l'activité et les performances de ce serveur.

Cognos TM1 Application Server utilise le système log4j pour contrôler lajournalisation du service Planning Services (pmpsvc). Les paramètres de lajournalisation sont dynamiques : les modifications apportées au fichier depropriétés sont détectées alors même que le service est en cours.

Fichier des propriétés de la journalisation

La journalisation est configurée dans le fichier suivant :

<installation TM1>\webapps\pmpsvc\WEB-INF\configuration\log4j.properties

Par exemple, l'emplacement d'installation par défaut sur un système MicrosoftWindows 32 bits est le suivant :

C:\Program Files\IBM\cognos\tm1\webapps\pmpsvc\WEB-INF\configuration\

Sur un système Windows 64 bits :

C:\Program Files\IBM\cognos\tm1_64\webapps\pmpsvc\WEB-INF\configuration\

Contenu du fichier journal

Par défaut, le service est configuré pour enregistrer uniquement les messages detype ERREUR dans un fichier texte contenant les entrées journal sur une période de24 heures. Le fichier journal se trouve dans le répertoire suivant :

<installation TM1>\webapps\pmpsvc\WEB-INF\logs\pmpsvc.log

La convention de dénomination des fichiers journaux des jours précédents est lasuivante :


pmpsvc.log.YYYY-MM-DD

Niveaux des messages du fichier journal

Il existe quatre niveaux de détail pour la journalisation. Chaque niveau contient sespropres entrées et celles des niveaux supérieurs.

Tableau 17. Description du niveau

Niveau Description

ERREUR Signale les événements exceptionnels qui empêchent le service determiner l'opération en cours.

AVERTISSEMENT Signale les situations dans lesquelles, bien que le service puisse sepoursuivre, l'intervention d'un administrateur est souhaitable.

INFORMATION Enregistre les informations relatives au fonctionnement des services.

DEBOGAGE Enregistre des informations détaillées sur le fonctionnement desservices.

Exemples d'activation de la journalisation

Le niveau d'information fourni par la journalisation est contrôlé par les niveauxdéfinis sous les deux racines du service :v log4j.logger.com.ibm.cognos

v log4j.logger.com.cognos

Tous les composants du service sont situés sous ces arborescences. Ainsi, le niveaudéfini pour celles-ci s'applique à tous les événements.

Par exemple, pour définir le niveau de journalisation INFORMATION, modifiez cesentrées de la façon suivante :#System logging settingslog4j.rootLogger=ERROR, TextFilelog4j.logger.com.ibm.cognos=INFOlog4j.logger.com.cognos=INFO

Vous pouvez définir la journalisation de façon plus précise en la définissant pourdes classes de niveau inférieur. Vous pouvez, par exemple, définir unejournalisation de niveau AVERTISSEMENT pour l'ensemble du service, et de niveauDEBOGAGE pour les appels de processus TurboIntegrator.#System logging settingslog4j.rootLogger=ERROR, TextFilelog4j.logger.com.ibm.cognos=WARNINGlog4j.logger.com.cognos=WARNINGlog4j.logger.com.ibm.cognos.pmpsvc.handler.util.PmtaProcessUtil=DEBUG

Vous pouvez activer la journalisation des performances du service en annulant lamise en commentaire de la journalisation standard, et en ajoutant les lignessuivantes dans le fichier de propriétés :# System logging settings#log4j.rootLogger=ERROR, Console, TextFile#log4j.logger.com.ibm.cognos=DEBUG#log4j.logger.com.cognos=DEBUG#log4j.logger.com.cognos.org=ERROR#log4j.logger.com.ibm.cognos.perf=ERROR


# Performance logging settingslog4j.rootLogger=ERROR, perfConsole, perfTextlog4j.logger.com.ibm.cognos.perf=DEBUG

Remarque : Vous pouvez également surveiller TM1 Application Server à l'aide deTM1 Operations Console. Voir IBM Cognos TM1 Operations Console.

Installation et configuration avancées de Cognos TM1 ApplicationServer

Vous pouvez effectuer des tâches d'installation et de configuration avancées pourpersonnaliser votre installation des composants IBM Cognos TM1 ApplicationServer.

Installation de Cognos TM1 Application Server avec votrepropre serveur d'applications Web Apache Tomcat

Cette section décrit la façon d'installer Cognos TM1 Application Server sur unordinateur distinct et de le déployer avec votre propre installation d'ApacheTomcat.

Cette installation est destinée à un environnement dans lequel TM1 Admin Serveret TM1 Server sont exécutés sur un autre ordinateur.

Génération de fichiers d'application pour un serveur ApacheTomcat ou WebSphere LibertyUtilisez IBM Cognos Configuration pour générer les fichiers d'application àdéployer sur votre serveur WebSphere Liberty ou Apache Tomcat.


Vous pouvez créer un fichier d'archive Web (WAR) ou un fichier d'archived'entreprise (EAR). Pour en savoir davantage sur les fichiers WAR et EAR et poursavoir lesquels sont pris en charge par votre serveur d'applications, reportez-vous àla documentation de celui-ci.


Cognos Configuration.2. Cliquez sur Action > Générer des fichiers d'application.3. Sous Applications, sélectionnez TM1 Application Server.4. Cochez le type de serveur d'applications Apache Tomcat. Cliquez sur Suivant.5. Sélectionnez le type de fichier et l'emplacement de l'enregistrement des fichiers.

L'emplacement par défaut est <your installation location>\ibm\cognos\TM1\.Cliquez sur Suivant.

6. Attendez que l'assistant de génération d'application termine le processus.Cliquez sur Terminer.

Que faire ensuite

Vous pouvez déployer le fichier d'application sur votre serveur d'applications.


Configuration de la sécurité authentifiée de Cognos TM1Application WebPour les serveurs IBM Cognos TM1 utilisés avec Cognos TM1 Application Web,utilisez l'authentification de sécurité standard de TM1, ou la sécurité d'IBMCognos.









266v «Utilisation de la sécurité Cognos avec Cognos TM1», à la page 257

3. Enregistrez et fermez le fichier Tm1s.cfg.4. Redémarrez le serveur Cognos TM1.5. Répétez ces étapes pour tous les autres serveurs Cognos TM1 que vous


Configuration des environnements client et serveur de CognosTM1 Application WebAvant d'utiliser IBM Cognos TM1 Application Web, vous devez définir l'hôteAdmin de TM1, le serveur TM1 et les interfaces utilisateur client à utiliser. Aupremier démarrage de Cognos TM1 Application Web, le programme vousdemande de configurer ces choix.


Avant de commencer








installation, la page Configuration s'ouvre.v Si Cognos TM1 Application Web est déjà configuré, vous êtes invité à saisir

un nom d'utilisateur et un mot de passe avant d'ouvrir la page deconfiguration en cliquant sur le bouton d'administration d'IBM Cognos TM1















Résultats




Installation de Cognos TM1 Application Server avec votrepropre installation d'IBM Websphere

Cette section décrit la façon d'installer Cognos TM1 Application Server sur unordinateur distinct et de le déployer avec votre propre installation d'IBMWebSphere.

Cette installation est destinée à un environnement dans lequel TM1 Admin Serveret TM1 Server sont exécutés sur un autre ordinateur.

Pour déployer TM1 Application Server sur WebSphere, effectuez les opérationssuivantes :v Générez les fichiers d'application à l'aide de Cognos Configuration. Voir

«Génération de fichiers d'application pour un serveur IBM WebSphere», à lapage 150. Un fichier pmpsvc.war est créé. L'emplacement par défaut est <votreemplacement d'installation>\ibm\cognos\TM1\.

Remarque : Vous pouvez utiliser le format de fichier EAR au lieu de WAR.v Déployez le fichier pmsvc.war sur le serveur d'applications Websphere.


Génération de fichiers d'application pour un serveur IBMWebSphereUtilisez IBM Cognos Configuration pour générer des fichiers d'application àdéployer sur un serveur IBM WebSphere.


Vous pouvez créer un fichier d'archive Web (WAR) ou un fichier d'archived'entreprise (EAR) pour les applications TM1 suivantes :v TM1 Planning Services : pmpsvc.war/earv TM1 Web TM1 Applications Web : tm1web.war/earv IBM Performance Management Hub et TM1 Operations Console : pmhub.war/ear

Vous pouvez ensuite déployer les fichiers EAR ou WAR sur WebSphere.


Cognos Configuration.2. Cliquez sur Actions > Générer des fichiers d'application d'application.3. Sous Applications, sélectionnez TM1 Application Server.4. Sous Type de serveur d'applications, sélectionnez IBM WebSphere. Cliquez sur

Suivant.5. Sélectionnez le type de fichier.6. Définissez l'emplacement de l'enregistrement des fichiers d'application.

L'emplacement par défaut est <your installation location>\ibm\cognos\TM1\.Cliquez sur Suivant.

7. Attendez que l'assistant de génération d'application termine le processus.Cliquez sur Terminer.

Que faire ensuite

Vous pouvez déployer le fichier d'application sur WebSphere Application Server.Voir «Déploiement de TM1 Application Server sur IBM WebSphere ApplicationServer», «Installation de TM1 Web avec IBM WebSphere», à la page 110 et«Installation de Cognos TM1 Operations Console sur IBM WebSphere», à la page101.

Déploiement de TM1 Application Server sur IBM WebSphereApplication ServerVous pouvez déployer et utiliser IBM Cognos TM1 Application Server sur IBMWebSphere Application Server.


Dans Microsoft Windows, cliquez sur Démarrer > Tous les programmes > IBMWebSphere Application Server > Profils > [nom du profil] > Démarrer leserveur.Une fenêtre de commande s'ouvre et indique la progression du démarrage.Lorsque le démarrage est terminé, la fenêtre de commande affiche le message


"Serveur démarré". Vous pouvez réduire la fenêtre de commande, mais ne lafermez pas. Elle doit rester ouverte pendant l'exécution de WebSphere.

v Générez les fichiers d'application à l'aide de Cognos Configuration. Voir«Génération de fichiers d'application pour un serveur IBM WebSphere», à lapage 150.





Procédure1. Vérifiez que vous disposez au minimum de 6 Go d'espace disque libre sur

l'ordinateur sur lequel WebSphere est installé.Sous UNIX, vérifiez que le disque monté sur /tmp contient au moins 6 God'espace disponible. Utilisez df pour vérifier à la fois l'espace total et lepourcentage utilisé pour tmpfs.

Remarque : Ne déployez pas TM1 Application Server avant d'avoir vérifiéque vous disposiez de suffisamment d'espace libre.

2. Ouvrez la console d'administration WebSphere.v Dans Windows, cliquez sur Démarrer > Tous les programmes > IBM




4. Définissez la taille de la mémoire de la pile JVM.a. Cliquez sur Serveurs > Types de serveurs > Serveurs d'applications

WebSphere.b. Cliquez sur le serveur sur lequel vous déployez TM1 Application Server.c. Sous Infrastructure du serveur, cliquez sur Gestion des processus et Java

> Définition des processus.d. Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.e. Dans la zone Arguments JVM génériques, ajoutez -Xmso512k.


DANGER

Ne déployez pas TM1 Application Server avant d'avoir défini la taillede la mémoire de la pile.

N'utilisez pas le fichier startServer.sh pour définir la taille de la mémoirede la pile. WebSphere supprime le paramètre -Xmso du fichier audémarrage du serveur et le remplace par la valeur par défaut, qui est troppetite.

f. Cliquez sur Appliquer, puis sur OK. Cliquez sur Enregistrer.5. Cliquez sur Applications > Nouvelle application, puis cliquez sur Nouvelle

application d'entreprise.6. Cliquez sur Parcourir pour localiser et sélectionner le fichier pmpsvc.war que

vous avez généré à l'aide de la commande Générer des fichiers d'applicationdans Cognos Configuration. Cliquez sur Ouvrir.

7. Cliquez sur Suivant.8. Cliquez sur Raccourci, puis cliquez sur Suivant.9. Cliquez sur Etape 4 : Mappage des racines de contexte des modules Web.

10. Dans la zone Racine du contexte, saisissez /pmpsvc. Cliquez sur Suivant.11. Cliquez sur Terminer. WebSphere installe l'application. Cette opération peut

prendre quelques minutes.Lorsque l'installation est terminée, WebSphere indique "Applicationpmpsvc_war installée avec succès."

12. Cliquez sur Enregistrer.13. Cliquez sur Applications > Types d'application > Applications d'entreprise

WebSphere.14. Cochez la case en regard de pmpsvc_war, puis cliquez sur Démarrer.

WebSphere indique "Le démarrage de l'application pmpsvc_war installée surle serveur serveur et le noeud noeud a abouti. Il se peut que vous deviezactualiser la collection pour afficher le statut actuel."

Traitement des incidents liés au déploiement de TM1 Application Server surIBM WebSphere :

Si le déploiement TM1 Application Server (pmpsvc.war) échoue avec un messaged'erreur lié au segment de mémoire Java, tentez d'ajuster les paramètres Java dansla console d'administration WebSphere.

Remarque : Il se peut que vous deviez réappliquer ce changement si vous mettezà niveau ou modifiez votre installation de WebSphere ultérieurement.

Procédure

1. Ouvrez la console d'administration de WebSphere.v Dans Windows, cliquez sur Démarrer > Tous les programmes > IBM




2. Connectez-vous à l'aide du profil WebSphere que vous avez utilisés pourdéployer TM1 Application Server. La console d'administration s'ouvre.

3. Cliquez sur Serveurs > Types de serveurs > Serveurs d'applicationsWebSphere.

4. Cliquez sur le serveur sur lequel vous avez déployé TM1 Application Server.5. Sous Infrastructure du serveur, cliquez sur Gestion des processus et Java >

Définition des processus.6. Sous Propriétés supplémentaires, cliquez sur Machine virtuelle Java.7. Dans la zone Taille de tas initiale, entrez 1024.8. Dans la zone Taille de tas maximale, entrez 2048.9. Cliquez sur Appliquer, puis sur OK. Cliquez sur Enregistrer.

10. Redémarrez WebSphere.

Configuration de la sécurité authentifiée de Cognos TM1Application WebPour les serveurs IBM Cognos TM1 utilisés avec Cognos TM1 Application Web,utilisez l'authentification de sécurité standard de TM1, ou la sécurité d'IBMCognos.









266


v «Utilisation de la sécurité Cognos avec Cognos TM1», à la page 2573. Enregistrez et fermez le fichier Tm1s.cfg.4. Redémarrez le serveur Cognos TM1.5. Répétez ces étapes pour tous les autres serveurs Cognos TM1 que vous


Configuration des environnements client et serveur de CognosTM1 Application WebAvant d'utiliser IBM Cognos TM1 Application Web, vous devez définir l'hôteAdmin de TM1, le serveur TM1 et les interfaces utilisateur client à utiliser. Aupremier démarrage de Cognos TM1 Application Web, le programme vousdemande de configurer ces choix.

Avant de commencer








installation, la page Configuration s'ouvre.v Si Cognos TM1 Application Web est déjà configuré, vous êtes invité à saisir

un nom d'utilisateur et un mot de passe avant d'ouvrir la page deconfiguration en cliquant sur le bouton d'administration d'IBM Cognos TM1















Résultats




Configuration de Cognos TM1 Application Web en vue del'utilisation de plusieurs serveurs Cognos TM1

Lorsque vous démarrez IBM Cognos TM1 Application Web pour la première fois,vous ne pouvez entrer qu'un serveur Cognos TM1 avec lequel travailler.

Pour ajouter d'autres serveurs, uuvrez la page Configuration de Cognos TM1Application Web.


Important : Pour utiliser plusieurs serveurs Cognos TM1 dans Cognos TM1Application Web, ceux-ci doivent tous utiliser le même mode d'authentification desécurité ( l'authentification standard de Cognos TM1 ou la sécurité de CognosAnalytics). Ils doivent en outre avoir le même nom d'administrateur et le mêmemot de passe. Pour plus d'informations, voir «Considérations relatives à la sécuritélors de l'utilisation de Cognos TM1 Applications», à la page 36.

Lorsque vous avez ajouté plusieurs serveurs Cognos TM1, ceux-ci sont disponiblesdans IBM Cognos TM1 Performance Modeler pour la conception des applicationsde planification.

Pour plus de détails, reportez-vous à la documentation TM1 Performance Modeler.

Procédure1. Connectez-vous à Cognos TM1 Application Web.2. Dans la barre d'outils, cliquez sur le bouton d'administration de Cognos TM1

Applications .La page Configuration d'IBM Cognos TM1 Applications s'ouvre.

3. Dans la section Nom des serveurs, cliquez sur Ajouter.La boîte de dialogue Ajouter un serveur s'affiche.

4. Définissez les valeurs des paramètres suivants :v Hôte Admin - Nom d'ordinateur ou adresse IP de l'hôte d'administration sur

lequel est exécuté Cognos TM1 Admin Server.Cliquez sur le bouton Actualiser pour mettre à jour la liste Nom desserveurs avec les serveurs disponibles pour l'hôte Admin que vous avezindiqué.

v Nom du serveur - Sélectionnez un serveur Cognos TM1 à utiliser avecCognos TM1 Application Web. Par exemple : Planning Sample.

5. Cliquez sur OK.Si vous recevez un message d'avertissement à propos de la configuration duserveur TM1, note-le et cliquez sur Fermer pour continuer. Pour en savoirdavantage sur les paramètres requis, reportez-vous à la section «Configurationd'un serveur Cognos TM1 en vue de son utilisation avec Cognos TM1Application Web», à la page 142. Les noms de l'hôte d'administration et duserveur Cognos TM1 entrés sont ajoutés à la section Nom des serveurs.

6. Pour ajouter des serveurs, cliquez sur Ajouter et répétez la procédure.7. Une fois tous les serveurs TM1 ajoutés, cliquez sur OK sur la page

Configuration d'IBM Cognos TM1 Applications.

Résultats

Les serveurs Cognos TM1 ajoutés peuvent à présent servir à la conception desapplications de planification.

Utilisation d'un proxyVous pouvez configurer un serveur proxy qui transmette les demandes desapplications client IBM Cognos TM1 à TM1 Application Server.

Un serveur proxy (parfois appelé proxy inverse) peut présenter les avantagessuivants :v Masquer l'existence et les caractéristiques du serveur d'applications


v Optimiser le traitement des demandesv Répartir la chargev Réaliser un audit sur le frontalv Ajouter de la sécurité

En outre, un proxy est requis lorsque les domaines internes et les ports du serveurd'applications TM1 ne sont pas disponibles pour l'accès direct depuis les sessionsInternet dans lesquelles les applications client TM1 sont utilisées.

Un environnement de proxy est constitué des composants suivants :v L'application client TM1, par exemple IBM Planning Analytics for Microsoft

Excel, sur Internetv Le serveur proxy, TM1 Application Server et TM1 Server sur le réseau internev Si vous utilisez la sécurité Cognos avec TM1, Cognos Business Analytics sur le

réseau interne

Configuration d'IBM Cognos TM1 pour qu'il fonctionne avec unproxyVous pouvez configurer IBM Cognos TM1 pour qu'il fonctionne avec un proxy.

Procédure1. Installez et configurez TM1 Application Server, TM1 Admin Server et le serveur

TM1. Suivez les procédures d'installation et de configuration de ladocumentation d'IBM Cognos TM1.

2. Si vous souhaitez utiliser la sécurité Cognos avec TM1, configurez la sécuritéCognos et testez l'environnement avant d'introduire le proxy. Pour plusd'informations sur la sécurité Cognos, voir «Présentation de la sécurité Cognos», à la page 257.

3. Installez et configurez le proxy pour qu'il interagisse avec TM1 ApplicationServer. Les détails de cette étape dépendent extrêmement du type de logicielproxy que vous utilisez et sortent donc du cadre de la documentation de TM1.En général, le proxy doit autoriser l'accès au domaine de réseau interne et auport exécutant TM1 Application Server, avec un accès particulier aux contextessuivants et à leurs sous-contextes : pmhub.

4. Installez et exécutez l'application client TM1, telle que Planning Analytics forMicrosoft Excel, sur le réseau interne. Cette étape permet de s'assurer que vousavez configuré TM1 et l'application client avant d'étendre la configuration pourinclure le proxy.


5. Configurez TM1 Application Server pour qu'il interagisse avec le proxy. Pourplus d'informations, voir «Configuration d'IBM Cognos TM1 Application Serverpour qu'il interagisse avec un proxy».

Configuration d'IBM Cognos TM1 Application Server pour qu'ilinteragisse avec un proxyUne fois que vous avez configuré TM1 et le serveur proxy, l'étape suivante consisteà configurer TM1 Application Server pour qu'il interagisse avec un proxy.


Utilisez IBM Cognos Configuration pour configurer TM1 Application Server afinqu'il interagisse avec un proxy.

Remarque : Cette rubrique s'applique à IBM Planning Analytics for MicrosoftExcel, IBM Cognos Performance Management Hub, et IBM Cognos OperationsConsole.

Procédure1. Ouvrez IBM Cognos Configuration.2. Arrêtez TM1 Application Server.3. Modifiez la propriété URI externe du serveur. Remplacez la valeur par défaut

http://localhost:9510 par le protocole, le domaine et le port du proxy tel qu'ildoit être référencé à partir d'une instance en cours d'exécution de l'applicationclient TM1 sur Internet. Utilisez un nom complet de domaine hôte. Parexemple : http://myproxy.mycompany.com:1234

Important : Utilisez des noms de domaine complets (par exemple,myproxy.mycompany.com plutôt que myproxy) lorsque vous définissez la propriétéURI externe du serveur. Les définitions de connexion (par exemple, dansPlanning Analytics for Microsoft Excel) et la navigation par les utilisateurs dansles navigateurs doivent référencer le nom complet correspondant. Il n'est pasrecommandé de mélanger les noms abrégés (myproxy) et les noms longs(myproxy.mycompany.com).

4. Redémarrez TM1 Application Server.5. Si vous utilisez la sécurité Cognos (Cognos Access Manager) avec TM1,

reportez-vous à la rubrique «Configuration d'IBM Cognos TM1 ApplicationServer pour la sécurité IBM Cognos lors de l'utilisation d'un proxy».

6. Testez vos changements de configuration.a. Connectez une instance en cours de l'application client, telle que Planning

Analytics for Microsoft Excel, à l'aide de l'adresse du proxy au lieu del'adresse par défaut.

b. Connectez-vous à IBM Cognos Performance Management Hub à l'aide del'adresse URL suivante : http://myproxy.mycompany.com:1234/pmhub/pm/security/login

Configuration d'IBM Cognos TM1 Application Server pour lasécurité IBM Cognos lors de l'utilisation d'un proxyDans une installation TM1 qui utilise la sécurité IBM Cognos (CAM), vous devezeffectuer des étapes supplémentaires pour prendre en charge le proxy.

Avant de commencerv TM1 est configuré avec la sécurité Cognos


v Le logiciel IBM Cognos Analytics est déjà installé et configuré avec desespaces-noms.

Procédure1. Désactivez l'accès anonyme.

a. Ouvrez IBM Cognos Configuration dans l'emplacement d'installation deCognos Analytics et non dans celui de TM1.

b. Développez Sécurité > Authentification, puis cliquez sur Cognos.c. Vérifiez que l'option Autoriser l'accès anonyme est définie sur False.

2. Définissez l'adresse URL de la sécurité Cognos dans IBM Cognos PerformanceManagement Hub (PM Hub).a. Accédez à la page de connexion du portail PM Hub à l'aide d'une adresse

URL de proxy, telle que http://myproxy.mycompany.com:1234/pmhub/pm/security/login

b. Cliquez sur la liste Espace-noms et sélectionnez une instance de serveurTM1. Entrez votre nom d'utilisateur Cognos et votre mot de passe pourvous connecter.

c. Cliquez sur le lien Administration et configuration.d. Développez com.ibm.ba.pm.resource.security et cliquez sur

com.ibm.ba.pm.resource.security.dictionary.e. Editez la propriété CAMBIURL.

Si TM1 Application Server peut accéder directement au répartiteur CognosAnalytics dans le réseau, vous pouvez utiliser une adresse URL directe :http://internal.bi.server:9300/p2pd/dispatch

Si le proxy protège l'URI interne derrière un pare-feu sécurisé, spécifiez ceproxy dans l'adresse URL : http://myproxy.mycompany.com:1234/p2pd/dispatch

Remarque : Configurez le serveur proxy pour qu'il redirige les demandesvers le répartiteur Cognos Analytics pour le contexte d'URL p2pd de lamême manière que pour les autres contextes de base de TM1, tels quepmhub, tm1web et pmpsvc.Si vous utilisez un code d'accès unique avec la passerelle Analytics, il sepeut que vous deviez définir la propriété CAMGatewayURL. DéfinissezCAMGatewayURL en suivant les étapes que vous avez utilisées pourdéfinir CAMBIURL.

3. Testez la configuration.a. Déconnectez-vous de PM Hub.b. Retournez à la page de connexion du portail PM Hub.c. Cliquez sur la liste Espace-noms. Cette liste doit contenir les serveurs TM1,

comme auparavant, ainsi que les espaces-noms IBM Cognos Analytics.

Remarque : Les espaces-noms Cognos Analytics doivent être définis dans laconfiguration de votre installation Cognos Analytics pour pouvoirapparaître dans la liste Espace-noms.

Identification et résolution des problèmes de configuration deproxy pour TM1Suivez ces étapes pour identifier et résoudre les problèmes de connexion dans unenvironnement TM1 qui inclut un proxy.1. Déterminez l'origine du problème :


v Dans une application client TM1, accédez directement au serveur TM1, sansutiliser l'URI du proxy. Par exemple, démarrez Cognos TM1 PerformanceModeler et cliquez sur Connexion directe.

v Si vous utilisez la sécurité Cognos, utilisez une application Web TM1, telleque TM1 Web, pour accéder au serveur Cognos Analytics, sans l'URI duproxy. Essayez de nouveau d'utiliser l'URI du proxy.

v Dans une application Web TM1, telle que TM1 Web, accédez au serveur TM1via TM1 Application Server, sans utiliser l'URI du proxy. Essayez de nouveaud'utiliser l'URI du proxy.

v Dans une application client TM1, telle que Planning Analytics for MicrosoftExcel, accédez au serveur TM1 via TM1 Application Server, sans utiliserl'URI du proxy. Essayez de nouveau d'utiliser l'URI du proxy.

Remarque : Il se peut que vous ayez des difficultés à accéder aux serveurs si leproxy est un pare-feu. Dans ce cas, exécutez le client TM1 ou l'application Webà l'intérieur du pare-feu pour tester les connexions sans le proxy.

2. Si l'un des tests de l'étape 1 échoue, vérifiez la configuration de cetteconnexion, réessayez, puis passez au test suivant.

Configuration de la sécurité des fonctions TurboIntegrator deCognos TM1 dans Insight

Lorsque vous ouvrez un espace de travail IBM Cognos Insight qui a été partagé àl'aide d'IBM Cognos Connection, vous avez la possibilité de restreindre l'exécutionde certaines fonctions TurboIntegrator, en particulier celles qui pourraient détruireou modifier des fichiers de données.

Il existe différentes fonctions TurboIntegrator capables d'écrire et de supprimer desfichiers, et d'exécuter des commandes. Lorsque vous recevez un espace de travailpartagé Insight, certains processus TurboIntegrator de cet espace peuvent contenirdes fonctions susceptibles de réaliser des actions indésirables. Pour empêcher lesprocessus d'effectuer des actions potentiellement nuisibles, votre installation Insightcontient un fichier de configuration nommé TM1Functions.cfg, qui peut servir àempêcher ou à restreindre l'exécution des fonctions TurboIntegrator.

L'exécution d'une fonction TurboIntegrator peut être entièrement bloquée. Il estpossible de configurer les fonctions ASCIIOutput, TextOutput et ASCIIDelete pourune exécution en mode restreint. Lorsqu'une fonction s'exécute en mode restreint,la portée de ses actions est limitée aux fichiers contenus dans le répertoire dedonnées du serveur TM1, et dans ses sous-répertoires.

Lors de l'installation d'IBM Cognos Insight, une version par défaut deTM1Functions.cfg est créée dans C:\Documents and Settings\<utilisateur>\Application Data\IBM\Cognos Insight\bins\bin_xxxx. <utilisateur> est le nomsous lequel vous avez installé Insight, et xxxx est la version de votre installation.

La version par défaut de TM1Functions.cfg est la suivante :ExecuteCommand=0AsciiOutput=1TextOutput=1AsciiDelete=1

Une fonction dont la valeur est 0 dans TM1Functions.cfg ne peut pas s'exécuter.Toute tentative d'exécuter cette fonction va générer une exception de sécuritéTurboIntegrator.


Une fonction dont la valeur est 1 dans TM1Functions.cfg s'exécute en moderestreint. Seules les fonctions ASCIIOutput, TextOutput et ASCIIDelete peuvent êtreexécutées en mode restreint.

Lorsqu'une fonction n'est pas dans TM1Functions.cfg, son exécution ne subitaucune limitation.

Exemples de fonctions s'exécutant en mode restreint

Lorsqu'une fonction est configurée pour s'exécuter en mode restreint, tout cheminrelatif transmis en tant qu'argument à la fonction est considéré comme démarrantdans le répertoire de données du serveur TM1, et il est autorisé. Tout cheminabsolu vers un répertoire au-dessus du répertoire de données du serveur TM1empêche l'exécution de la fonction et provoque une exception de sécurité aumoment de l'exécution.

Supposons, par exemple, que TM1Functions.cfg contienne AsciiDelete=1. Dans cecas, la fonction

ASCIIDelete('logs\sample.log’);

est autorisée et supprime le fichier sample.log dans le sous-répertoire logs durépertoire de données du serveur TM1.

Cependant, la fonction

ASCIIDelete('c:\autoexec.bat’);

ne s'exécutera pas et générera une exception de sécurité, car elle concerne unfichier situé à la racine de l'unité, c'est-à-dire au-dessus du répertoire de donnéesdu serveur TM1.

De la même façon, supposons que TM1Functions.cfg contienne TextOutput=1. Dansce cas, la fonction

TextOutput('logs\sample.txt’, 'this is sample text’);

est autorisé et écrit une chaîne dans le fichier sample.txt du sous-répertoire logs durépertoire de données du serveur TM1.

A l'inverse, la fonction

TextOutput('c:\autoexec.bat’, 'del *.* -r –f’);

n'est pas autorisée car le chemin est à la racine de l'unité. Cette fonction va générerune exception de sécurité pendant l'exécution.

Edition du fichier TM1Functions.cfgLe fichier TM1Functions.cfg vous permet d'empêcher ou de restreindre l'exécutiondes fonctions TurboIntegrator potentiellement nuisibles contenues dans un espacede travail partagé IBM Cognos Insight.


Lors de l'installation d'IBM Cognos Insight, une version par défaut deTM1Functions.cfg est créée dans C:\Documents and Settings\<utilisateur>\


Application Data\IBM\Cognos Insight\bins\bin_xxxx. <utilisateur> est le nomsous lequel vous avez installé Insight, et xxxx est la version de votre installation.Vous pouvez modifier ce fichier de configuration pour renforcer ou annuler lesrestrictions appliquées à l'exécution des fonctions.

Procédure1. Ouvrez TM1Functions.cfg dans un éditeur de texte.2. Pour bloquer entièrement l'exécution d'une fonction, affectez-lui la valeur 0. Par

exemple, ExecuteCommand=0 ou ServerShutdown=0.3. Pour autoriser l'exécution d'une fonction en mode restreint, affectez-lui la

valeur 1. Par exemple, AsciiDelete=1. Seules les fonctions ASCIIOutput,TextOutput et ASCIIDelete peuvent être exécutées en mode restreint.

4. Pour annuler toute restriction appliquée à une fonction, supprimez-la du fichierTM1Functions.cfg.

5. Enregistrez et fermez le fichier TM1Functions.cfg.


Chapitre 12. Planning Analytics Workspace installation

IBM Planning Analytics Workspace is a web-based interface for IBM PlanningAnalytics. It provides an interface to TM1 data, with exciting ways to plan, create,and analyze your content.

Planning Analytics Workspace architectureIBM Planning Analytics Workspace can be colocated with IBM Planning AnalyticsLocal or it can reside on its own. In either case, it must connect to the TM1 serversin your Planning Analytics Local system and to an authentication system.

The following diagram shows where Planning Analytics Workspace fits into yourIBM Planning Analytics Local architecture:

Authentication modes

You can use standard TM1 security (mode 1) or Cognos Analytics security (sécuritéIBM Cognos mode 5) to authenticate Planning Analytics Workspace users.


Planning Analytics Workspace installation overviewThe following diagram shows the workflow for installation. If you are viewing thisdiagram from IBM Knowledge Center, you can click on a task to go to theprocedure for that task.

PrerequisitesBefore you install IBM Planning Analytics Workspace, you must have IBMPlanning Analytics Local 2.0.0 or greater installed.

For information about late-breaking installation and configuration issues forPlanning Analytics Workspace, see Critical usage notes for IBM Planning Analytics.

Extract paw_<version>_ml.tar.gz. Use a directory structure that groups thePlanning Analytics Workspace installation kits into one directory and clearlyindicates the version number of each kit. For example,paw_install_kits/ paw_2.0_ml.tar.gz



Remarque : Planning Analytics Workspace is included as part of IBM PlanningAnalytics Local. If you haven't downloaded the Planning Analytics Workspaceinstallation kit, refer to the IBM Planning Analytics Local download document forinformation about how to do so.

If you are using IBM Cognos Analytics (IBM Cognos Business Intelligence) as yourauthentication provider, then you must have IBM Cognos Analytics 10.2.2 (IBMCognos Business Intelligence 10.2.2) or greater installed.

Planning Analytics Workspace communicates with TM1 servers using the TM1REST API. In the Tm1s.cfg file for all TM1 Servers, set the HTTPPortNumber propertyto a free port on the server.

Installing DockerDocker is the environment in which Planning Analytics Workspace runs.

Before you begin

You must install a minimum of Docker version 1.11.0.

Important : If you're installing Docker on a Microsoft Windows OS, your systemmust support hardware virtualization and you must enable it. If you are installingon a Linux OS, then you don't need to enable hardware virtualization.

About this task

If you're not familiar with Docker and want information about it, see What isDocker? (https://www.docker.com/what-docker).

Procedure1. If you're installing on a Microsoft Windows OS, install the Docker Toolbox. For

information about installing Docker Toolbox, see Docker Toolbox(https://www.docker.com/products/docker-toolbox). If you are prompted toallow VirtualBox Interface to make changes to your computer, reply «Yes». Youdon't need to start the Docker Quickstart Terminal.

2. If you're installing on a Linux OS, do the following steps:a. Install the Docker engine. For information, see Install Docker Engine on

Linux (https://docs.docker.com/engine/installation/linux/).b. Install Docker Compose (minimum version 1.8.1). For information, see

Install Docker Compose (https://docs.docker.com/compose/install/).

Installing Planning Analytics WorkspaceYou install IBM Planning Analytics Workspace on a Microsoft Windows OS that isrunning a Linux VM or directly on a Linux OS.

About this task

The start script does the following things:v Checks that the required ports are availablev If you are installing on a Microsoft Windows OS, it creates a Linux virtual

machine (VM) called «paw» on which Planning Analytics Workspace runs. Youcan change the following default values for the VM settings:– 8192 MB of memory

Chapitre 12. Planning Analytics Workspace installation 165

https://www.docker.com/what-docker

https://www.docker.com/what-docker

http://www.docker.com/products/docker-toolbox

https://docs.docker.com/engine/installation/linux/

https://docs.docker.com/engine/installation/linux/

https://docs.docker.com/compose/install/

– 4 CPUs– 20,000 MB of storage

v Installs the Planning Analytics Workspace Docker imagesv Opens the Outil d'administration IBM Planning Analytics Workspace

Here's a short video that shows the installation of Planning Analytics Workspaceon a Microsoft Windows OS:

https://youtu.be/8jOfrXapczM

Procedure1. Run the start script:

a. If you are installing on a Microsoft Windows OS, go to the directory whereyou extracted the installation kit and double-click Start.bat.

b. If you are installing on a Linux OS, open a terminal window, go to thedirectory where you extracted the installation kit, and type the followingcommand:./Start.sh

Remarque : The first time you run the start script, it automatically installs theDocker images. The next time you run the start script, you can skip installingor updating the Docker images and go straight into the administration tool.

2. Reply «y» when you are asked if you want to start the administration tool.

Remarque : Keep the command or terminal window open. Closing the windowstops the administration tool.

Results

The Outil d'administration IBM Planning Analytics Workspace opens in yourbrowser. If the administration tool doesn't open, copy and paste the address shownin the command or terminal window into a browser window.

Connecting Planning Analytics Workspace to Cognos TM1and authentication servers

Use the Outil d'administration IBM Planning Analytics Workspace to configure theCognos TM1 URIs that point to the Cognos TM1 servers and the servers that doauthentication.

About this task

Use fully qualified host names or IP addresses for the URIs. Do not use localhost.

If you are installing on a Microsoft Windows OS and Planning AnalyticsWorkspace is installed on the same computer as Cognos TM1, then you can use theIP address 192.168.40.1 in the URIs. For more information, see «Planning AnalyticsWorkspace and Cognos TM1 installed on one computer», à la page 168.

Here's a short video that shows how to do the configuration:

https://youtu.be/CipjgA4nc7I


https://youtu.be/8jOfrXapczM

https://youtu.be/CipjgA4nc7I

Procedure1. In the Outil d'administration IBM Planning Analytics Workspace on the

Configuration tab, enter the URIs for the following servers:v TM1 Admin Server URI (the default value is 5898 for the HTTPS REST API

port, and 5895 for the HTTP REST API port)v TM1 Application Server Gateway URI

2. Under Authentication Mode, select TM1 or CAM. Choose TM1 if you're usingstandard TM1 authentication. Choose CAM if you're using sécurité IBMCognos for authentication.a. If you selected TM1, enter the value for the TM1 Login Server URI.

Planning Analytics Workspace users authenticate to the system by logginginto the TM1 Login Server. Users must have the same credentials on anyother TM1 server they access.

b. If you selected CAM, enter the following values:v IBM Cognos BI Gateway URI

v IBM Cognos BI Dispatcher URI

v IBM Cognos BI Authentication Namespace ID

3. Click Validate. Planning Analytics Workspace verifies that it can communicatewith the servers and that they are configured for use with it. If a server is notsuccessfully validated, an error message is displayed.

4. Click OK.5. Click Update and OK to save your configuration settings.

What to do next

Verify that the Planning Analytics Workspace services started. For moreinformation about the services, see «Checking the status of the services».

Access Planning Analytics Workspace by entering http://<host-name>/ where<host-name> is the host name or IP address of your computer, in the address fieldof your browser. For information on how to use Planning Analytics Workspace, seethe Planning Analytics Workspace guide.

Read «Planning Analytics Workspace and Cognos TM1 installed on one computer»,à la page 168 for special considerations if you have Planning Analytics Workspaceand Cognos TM1 installed on one computer.

Checking the status of the servicesThe Status tab in the Outil d'administration IBM Planning Analytics Workspacedisplays the status, up time, CPU usage, memory usage, and percentage ofmemory used for each service.

About this task

Here's a short video overview of the Status tab:

https://youtu.be/AlsSZ4m52u0

Procedure1. Run the Start.bat or Start.sh script.2. Reply «n» when you are prompted to install the Docker images.


https://youtu.be/AlsSZ4m52u0

3. Reply «y» when you are prompted to start the administration tool. If theadministration tool doesn't open, copy and paste the address shown in thecommand or terminal window into a browser window.

4. In the Outil d'administration IBM Planning Analytics Workspace, click theStatus tab.

5. Click Refresh and then verify that all services in the list have a status of«running». When you are installing, wait until all services have started (theCPU % for services drops) before accessing Planning Analytics Workspace.

6. To stop, start, or restart one service, select (highlight) it in the list, and thenclick Stop, Start, or Restart.

7. To stop, start, or restart all services, make sure that no services are selected inthe list, and then click Stop, Start, or Restart.

Planning Analytics Workspace and Cognos TM1 installed onone computer

There are some things to be aware of when IBM Planning Analytics Workspaceand Cognos TM1 are installed together on a Microsoft Windows OS.

The VM that contains Planning Analytics Workspace has an IP address of192.168.40.100 and it uses 192.168.40.1 to access Cognos TM1. 192.168.40.1 is theaddress of the VirtualBox Host-Only Network adapter on the Microsoft WindowsOS and provides a reliable connection in a standalone or demonstrationenvironment.

If you are physically logged in to the computer that has Planning AnalyticsWorkspace installed, you can access Planning Analytics Workspace by usinghttp://192.168.40.100/.

When you configure the TM1 URIs that Planning Analytics Workspace connects to,you can use the IP address 192.168.40.1 in the URI.

Configuring SSL for Planning Analytics WorkspaceTo configure Secure Sockets Layer (SSL) for IBM Planning Analytics Workspace,you create a privacy enhanced mail (pem) file that contains your securitycertificates.

Before you begin

You must have the private key, primary, intermediate, and root certificates fromyour certificate authority provider.

Procedure1. Open a text editor and paste the body of each certificate into the file in the

following order. Make sure you include the beginning and end tags on eachcertificate:

private key<your_domain_name>.key

primary certificate<your_domain_name>.crt

intermediate certificateIntermediateCA.crt


root certificateTrustedRoot.crt

Here is an example:-----BEGIN RSA PRIVATE KEY-----(Your Private Key: your_domain_name.key)-----END RSA PRIVATE KEY----------BEGIN CERTIFICATE-----(Your Server certificate: your_domain_name.crt)-----END CERTIFICATE----------BEGIN CERTIFICATE-----(Your Intermediate certificate: IntermediateCA.crt)-----END CERTIFICATE----------BEGIN CERTIFICATE-----(Your Root certificate: TrustedRoot.crt)-----END CERTIFICATE-----

2. Save the file as pa-workspace.pem and then copy or move it to the<paw_install_location>/config directory. If the pa-workspace.pem alreadyexists in the directory, overwrite it.

3. Open the <paw_install_location>/config/paw.env file and add the followinglines at the end:export EnableSSL=trueexport ServerName=<paw-server-name>

where <paw-server-name> is the name of the server on which Planning AnalyticsWorkspace is installed.

4. Save the <paw_install_location>/config/paw.env file.5. Open the Outil d'administration IBM Planning Analytics Workspace and restart

all services. For information about how to open the administration tool, see«Checking the status of the services», à la page 167.

Configuration du protocole SSL entre Planning AnalyticsWorkspace et d'autres serveurs

Si vous utilisez des certificats SSL autosignés pour les serveurs TM1 ou IBMCognos Analytics, il peut être nécessaire d'ajouter des certificats de l'autorité decertification pour ces certificats dans la liste des certificats de l'autorité decertification qui sont utilisés par IBM Planning Analytics Workspace.


Cette tâche crée un fichier appelé cacerts et qui contient vos certificats del'autorité de certification. Le fichier cacerts est utilisé par les services Java dansPlanning Analytics Workspace.

Si vous obtenez une erreur de chaînage de certificats Java lorsque vous vousconnectez à Cognos Analytics, procédez comme suit pour la résoudre.

Procédure1. Placez les fichiers des certificats de l'autorité de certification dans le répertoire

<emplacement_install_paw>/config/certs.2. Exécutez le script <emplacement_install_paw>/scripts/process_certs.ps1

(système d'exploitation Microsoft Windows) ou process_certs.sh (systèmed'exploitation Linux).


3. Ouvrez l'Outil d'administration IBM Planning Analytics Workspace etredémarrez tous les services. Pour des informations sur l'ouverture de l'outild'administration, voir «Checking the status of the services», à la page 167.

Résultats

Le fichier cacerts est créé dans le répertoire <emplacement_install_paw>/config.

Remarque : si vous devez changer l'ensemble de certificats de l'autorité decertification, placez les certificats de l'autorité de certification dans le répertoire<emplacement_install_paw>/config/certs et exécutez à nouveau le scriptprocess_certs.

Configuring a Linux virtual machine to start automaticallyIBM Planning Analytics Workspace that is installed on a Microsoft Windows OSrequires a Linux virtual machine (VM). You can configure the VM to startautomatically when you log in to the Microsoft Windows OS.

Procedure1. Open Oracle VM VirtualBox Manager, right-click the VM, and select Create

Shortcut on Desktop.2. Click Win-R, type shell:startup, and press Enter.3. Drag the shortcut icon into the Startup folder.


Chapitre 13. Administer Planning Analytics Workspace

This section explains how to perform administration tasks such as backup andrestore.

Viewing logsYou can use the Status tab of the Outil d'administration IBM Planning AnalyticsWorkspace to view logs.

About this task

The log directory in the installation directory contains a subdirectory for eachservice.

Procedure1. Run one of the following scripts from the <paw_install_location> folder:

Operating system Script to run

Microsoft Windows Start.bat

Linux Start.sh

2. Reply «n» when you are prompted to install the Docker images.3. Reply «y» when you are prompted to start the administration tool. If the

administration tool doesn't open, copy and paste the address shown in thecommand or terminal window into a browser window.

4. In the Outil d'administration IBM Planning Analytics Workspace, click theStatus tab.

5. To see the logs of one service, select (highlight) a service in the list by clickingit, and then clicking Logs. The last 1000 lines in the log file for the service aredisplayed. If you want to see more content, you can open the file from the logdirectory in a text editor.

Accessing the Outil d'administration Planning Analytics Workspaceremotely

By default you access the Outil d'administration IBM Planning AnalyticsWorkspace from the computer on which it is installed. To access the administrationtool from another computer, you can set an environment variable.

About this task

This task applies to IBM Planning Analytics Workspace installed on a Linux OSonly.

Important : Running the Outil d'administration Planning Analytics Workspace thisway is not secure so you may want to restrict access to specific remote IPaddresses using the OS firewall.


Procedure1. In a terminal window, enter the following command:

export ADMINTOOL_IP=<ip address>

where <ip address> is the IP address of the computer from which you want toaccess the administration tool.

2. Run the Start.sh script.3. Access the administration tool from the remote computer by copying and

pasting the address shown in the command or terminal window into a browserwindow on the remote computer.

Users in Planning Analytics WorkspaceThe first user that logs in to IBM Planning Analytics Workspace is given theadministrator role. Users that log in after the first user are given the analyst role.

For more information about managing users, see the Planning Analytics Workspaceguide.

Backing up or restoring Planning Analytics WorkspaceWhen you back up IBM Planning Analytics Workspace, you are saving userinformation such as preferences, book assets, chat history, recently visited sites, andbook marks.

Before you begin

You must perform this task during a system maintenance window because servicesare stopped and started.

About this task

All data is backed up or restored. You can't selectively back up or restore.

Procedure

To back up:1. Run one of the following scripts from the <paw_install_location> folder:

Operating system Script to run

Microsoft Windows Start.bat

Linux Start.sh

2. Answer n to the questions about installing Docker images and starting theadministration tool.

3. Enter the following command: ./backup.sh <folder-name> where <folder-name>is the file path and name of the folder to back up to. If you omit <folder-name>,a folder with the current time is created in the backup directory.

To restore:4. Open a command or terminal window and enter the following command:

scripts/restore.sh <folder-name> where <folder-name> is the path and nameof the folder that contains the data to restore.


Upgrading Planning Analytics WorkspaceTo upgrade IBM Planning Analytics Workspace, you install a new version ofPlanning Analytics Workspace.

Before you begin

Go to Fix Central (https://www.ibm.com/support/fixcentral/) and download theversion of Planning Analytics Workspace software that you want to upgrade to.Put the espace_travail_local_ipa_<version>.zip file in a directory that is separatefrom your current installation and extract it.

Important : You must perform this task during a system maintenance windowbecause services are stopped and started.

Procedure1. Copy the <paw_install_location>/config/paw.env file from your current

installation to the new installation location.2. Perform «Installing Planning Analytics Workspace», à la page 165. Reply «y»

when you are prompted to install the Docker images. Reply «y» when you areprompted to open the administration tool.

3. In the Outil d'administration IBM Planning Analytics Workspace, restart all theservices.

Uninstalling Planning Analytics WorkspaceWhen you uninstall IBM Planning Analytics Workspace, you delete all Dockercontainers, Planning Analytics Workspace databases, and all Docker images.

Procedure1. If you are uninstalling from a Microsoft Windows OS, in Oracle VM VirtualBox,

stop the «paw» VM and then delete it.2. If you are uninstalling from a Linux OS, open a terminal window, go to the

directory where you extracted the installation kit, and enter the followingcommands:scripts/paw.sh stopscripts/paw.sh rm -vdocker rm $(docker ps -a -q)docker rmi $(docker images -q)

3. Delete the files in the directory where you extracted the installation kit.

Chapitre 13. Administer Planning Analytics Workspace 173

https://www.ibm.com/support/fixcentral/

Chapitre 14. Installation du niveau riche TM1

Vous pouvez installer les composants du niveau riche TM1 à l'aide du programmed'installation du serveur TM1 ou du programme d'installation du client TM1.

Vous pouvez installer les composants du niveau riche suivant :v TM1 Architectv Performance Modelerv TM1 Perspectivesv Cognos Insightv API Cognos TM1

Pour obtenir des informations sur l'utilisation des API TM1 pour implémenter lagénération de rapports Cognos Analytics à partir de sources de données CognosTM1, consultez les rubriques «Cognos TM1 en tant que source de données avecCognos Analytics», à la page 63 et «Activation de la génération de rapportsCognos Analytics à partir de sources de données Cognos TM1», à la page 63.Concepts associés:«Mise à niveau des clients Cognos TM1 Architect et Perspectives», à la page 50Vous pouvez mettre à niveau les composants client d'IBM Cognos TM1 à l'aide duprogramme d'installation du serveur Cognos TM1 ou des clients Cognos TM1.

Installation de Cognos TM1 PerspectivesVous pouvez installer IBM Cognos TM1 Perspectives, un module d'extension pourMicrosoft Excel.

Avant de commencer

Avant d'installer IBM Cognos TM1 Perspectives, effectuez les tâches suivantes :1. Installez les logiciels nécessaires pour vous permettre d'exécuter Cognos TM1

Perspectives. Pour plus d'informations, voir «Installation des logicielsprérequis», à la page 67.

2. Vérifiez que l'instance de Cognos TM1 Admin Server et celle de Cognos TM1Server auxquelles vous voulez vous connecter s'exécutent sur un ordinateuraccessible dans votre réseau. Pour plus d'informations, voir Chapitre 8,«Installation de Cognos TM1 Server», à la page 77.

3. Vérifiez que les utilisateurs ont accès aux serveurs Cognos TM1 dont ils ontbesoin et qui s'exécutent sous ce serveur Cognos TM1 Admin Server. En tantqu'administrateur de Cognos TM1, vous devez configurer un nom d'utilisateuret un mot de passe pour chaque utilisateur avant que celui-ci puisse accéder àce serveur.


La procédure suivante installe Cognos TM1 Perspectives sur un seul ordinateur, leconfigurent de façon à localiser un serveur Admin Cognos TM1 sur votre réseau,puis le connectent à un serveur. Vous pouvez également créer une installation sanssurveillance.


Utilisez les mêmes versions 32 ou 64 bits de TM1 Perspectives et Microsoft Excel.Ne mélangez pas les différentes versions de plateformes. Par exemple, si vousutilisez la version 64 bits de Microsoft Excel, utilisez la version 64 bits de TM1Perspectives.

Avertissement : Si vous effectuez une mise à niveau en conservant à la mêmeplace les anciens fichiers de configuration client Tm1p.ini, vous devrez peut-être ymodifier le chemin du répertoire défini pour le paramètreAdminSvrSSLCertAuthority. Par exemple, si vous utilisez le certificat SSL par défautde Cognos TM1, remplacez manuellement la valeur de ce paramètre par lenouveau chemin d'installation C:\Program Files\IBM\cognos\tm1\bin\ssl\applixca.pem.

Procédure1. Installez Cognos TM1 Perspectives :

a. Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008,cliquez avec le bouton droit sur le fichier issetup.exe, puis cliquez surExécuter en tant qu'administrateur. Pour les autres systèmes d'exploitation,cliquez deux fois sur le fichier issetup.exe sur le disque d'installation duclient IBM Cognos TM1, ou à partir de l'emplacement dans lequel lesfichiers d'installation du client Cognos TM1 ont été téléchargés et extraits.

b. Dans la page Sélection des composants, développez Niveau riche TM1 etcochez la case TM1 Perspectives.Laissez toutes les autres cases désélectionnées.

c. Suivez la procédure et cliquez sur Terminer pour terminer l'installation.2. Lancez Cognos TM1 Perspectives :

a. Cliquez sur Démarrer > IBM Cognos TM1 > Perspectives for MS Excel. Sile composant ne démarre pas, vérifiez que les serveurs que vous avezlancés avec Cognos Configuration sont toujours en cours d'exécution.

b. Cliquez sur Activer les macros lorsque l'avertissement de sécurité s'affiche.3. Configurez Cognos TM1 Perspectives pour localiser un serveur Admin Cognos

TM1 :a. Dans Microsoft Excel, cliquez sur TM1 > Options. La boîte de dialogue

TM1 Options s'affiche.b. Dans la zone Hôte Admin, entrez le nom de l'ordinateur sur lequel le

serveur Admin Cognos TM1 s'exécute. Si vous souhaitez accéder à desserveurs enregistrés sur des serveurs Admin différents, séparez les nomsdes hôtes Admin par un point-virgule. Vous devez saisir un nom, et nonune adresse IP, dans la zone Hôte Admin.

c. Cliquez sur OK.d. Lorsque vous êtes invité à vous déconnecter des serveurs accédés, cliquez

sur Oui si vous voulez accéder à une nouvelle liste de serveurs. Lesserveurs disponibles via le serveur admin sur l'hôte Admin spécifiés'affichent. Pour conserver la liste actuelle de serveurs distants pendant cettesession, cliquez sur Non.

4. Lancez l'explorateur de serveur.5. Cliquez deux fois sur une instance de Cognos TM1 Server pour vous y

connecter.Pour Planning Sample ou SData, utilisez les données d'identification suivantes :v Nom d'utilisateur : admin



Conseil : Pour charger Cognos TM1 Perspectives automatiquement lors dudémarrage de Microsoft Excel, ajoutez répertoire_TM1/Tm1p.xla à la liste desoutils d'extension de Microsoft Excel. Si vous utilisez une version 32 bits deMicrosoft Excel, l'emplacement par défaut est C:\Program Files\ibm\cognos\tm1_64\bin\. Si vous utilisez une version 64 bits de Microsoft Excel,l'emplacement par défaut est C:\Program Files\ibm\cognos\tm1_64\bin64\.Une fois cette étape terminée, "TM1" s'affiche dans la barre de menus deMicrosoft Excel.

6. Pour installer Cognos TM1 Perspectives sur plusieurs ordinateurs, créez uneinstallation sans surveillance à partir des étapes précédentes. Pour plusd'informations, voir Annexe C, «Définitions d'installations et de configurationssans surveillance», à la page 389.

Installation de Cognos TM1 ArchitectVous pouvez installer IBM Cognos TM1 Architect en procédant comme suit.

Avant de commencer

Avant d'installer Cognos TM1 Architect, effectuez les tâches suivantes :v Installez les logiciels nécessaires pour vous permettre d'exécuter Cognos TM1

Architect. Pour plus d'informations, voir «Installation des logiciels prérequis», àla page 67.

v Vérifiez que l'instance de Cognos TM1 Admin Server et celle de Cognos TM1Server auxquelles vous voulez vous connecter s'exécutent sur un ordinateuraccessible dans votre réseau. Pour plus d'informations, voir Chapitre 8,«Installation de Cognos TM1 Server», à la page 77.

v Vérifiez que les utilisateurs ont accès aux serveurs Cognos TM1 dont ils ontbesoin et qui s'exécutent sous ce serveur Cognos TM1 Admin Server. En tantqu'administrateur de Cognos TM1, vous devez configurer un nom d'utilisateuret un mot de passe pour chaque utilisateur avant que celui-ci puisse accéder à ceserveur.


Vous pouvez configurer IBM Cognos TM1 Architect de façon qu'il localise unserveur Admin Cognos TM1 sur le réseau, puis qu'il s'y connecte. Vous pouvezégalement créer une installation sans surveillance.

Avertissement : Si vous effectuez une mise à niveau en conservant à la mêmeplace les anciens fichiers de configuration client Tm1p.ini, vous devrez peut-être ymodifier le chemin du répertoire défini pour le paramètreAdminSvrSSLCertAuthority. Par exemple, si vous utilisez le certificat SSL par défautde Cognos TM1, remplacez manuellement la valeur de ce paramètre par lenouveau chemin d'installation C:\Program Files\IBM\cognos\tm1\bin\ssl\applixca.pem.

Procédure1. Installez Cognos TM1 Architect :

a. Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008,cliquez avec le bouton droit sur le fichier issetup.exe, puis cliquez surExécuter en tant qu'administrateur. Pour les autres systèmes d'exploitation,cliquez deux fois sur le fichier issetup.exe sur le disque d'installation du

Chapitre 14. Installation du niveau riche TM1 177

client IBM Cognos TM1, ou à partir de l'emplacement dans lequel lesfichiers d'installation du client IBM Cognos TM1 ont été téléchargés etextraits.

b. Dans la page Sélection des composants, développez Niveau riche TM1 etcochez la case TM1 Architect. Laissez toutes les autres casesdésélectionnées.

c. Suivez la procédure et cliquez sur Terminer pour terminer l'installation.2. Lancez Cognos TM1 Architect :

a. Cliquez sur Démarrer > IBM Cognos TM1 > Architect. Si le composant nedémarre pas, vérifiez que les serveurs que vous avez lancés avec CognosConfiguration sont toujours en cours d'exécution.

3. Configurez Cognos TM1 Architect pour localiser un serveur Admin CognosTM1 :a. Ouvrez l'explorateur de serveur.b. Sélectionnez TM1.c. Cliquez sur Fichier > Options TM1.d. Dans la zone Hôte Admin, entrez le nom de l'ordinateur sur lequel le

serveur Admin TM1 s'exécute. Vous devez saisir un nom, et non uneadresse IP, dans la zone Hôte Admin.

Conseil : Si vous souhaitez accéder à des serveurs enregistrés sur desserveurs Admin différents, séparez les noms des hôtes Admin par unpoint-virgule.

e. Cliquez sur OK.f. Lorsque vous êtes invité à vous déconnecter des serveurs accédés, cliquez

sur Oui si vous voulez accéder à une nouvelle liste de serveurs. Les serveursdisponibles via le serveur admin sur l'hôte Admin spécifié s'affichent. Pourconserver la liste actuelle de serveurs distants pendant cette session, cliquezsur Non.

4. Cliquez deux fois sur une instance de Cognos TM1 Server pour vous yconnecter.Pour Planning Sample ou SData, utilisez les données d'identification suivantes :v Nom d'utilisateur : admin


5. Pour installer Cognos TM1 Architect sur plusieurs ordinateurs, créez uneinstallation sans surveillance à partir des étapes précédentes. Pour plusd'informations, voir Annexe C, «Définitions d'installations et de configurationssans surveillance», à la page 389.

Installation de Cognos TM1 Performance ModelerVous pouvez distribuer et installer IBM Cognos TM1 Performance Modeler surplusieurs ordinateurs de diverses façons.

Le tableau ci-dessous récapitule les différentes façons de distribuer et d'installerCognos TM1 Performance Modeler sur plusieurs ordinateurs.


Tableau 18. Options d'installation sur plusieurs ordinateurs pour Cognos TM1 PerformanceModeler

Option d'installation Description

«Installation de Cognos TM1Performance Modeler à l'aidedu programme d'installation»

Les administrateurs ou les utilisateurs finals peuventinstaller Cognos TM1 Performance Modeler sur unordinateur unique à l'aide du programme d'installationd'IBM Cognos TM1 Client-only.

Si vous le souhaitez, suivez ces étapes pour créer uneinstallation automatisée afin d'installer Cognos TM1Performance Modeler sur plusieurs ordinateurs.

«Installation de Cognos TM1Performance Modeler depuis leportail Cognos TM1Applications», à la page 180

Au préalable, l'administrateur doit installer PlanningAnalytics Applications.

Ainsi, les utilisateurs de Planning Analytics peuventinstaller Cognos TM1 Performance Modeler sur leursordinateurs au premier démarrage depuis IBM CognosApplications Portal. On parle alors de distribution delogiciels.

Pour plus d'informations sur la publication d'espaces detravail, voir IBM Cognos TM1 Performance Modeler.

«Installation multiposte distantede Cognos TM1 PerformanceModeler», à la page 180

Un administrateur peut utiliser des outils d'installationde réseau tiers pour envoyer Cognos TM1 PerformanceModeler vers plusieurs systèmes client distants.

Installation de Cognos TM1 Performance Modeler à l'aide duprogramme d'installation

Vous pouvez installer en mode interactif une version autonome d'IBM CognosTM1 Performance Modeler sur un ou plusieurs ordinateurs.

Procédure1. Exécutez le programme d'installation :v Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008, cliquez


v Pour les autres systèmes d'exploitation, cliquez deux fois sur le fichierissetup.exe sur le disque d'installation du client IBM Cognos TM1, ou àpartir de l'emplacement dans lequel les fichiers d'installation du client IBMCognos TM1 ont été téléchargés et extraits.

2. Dans la page Sélection des composants, développez Niveau riche TM1 etcochez la case Performance Modeler. Laissez toutes les autres casesdésélectionnées.

3. Suivez la procédure et cliquez sur Terminer pour terminer l'installation.4. Pour tester l'installation, ouvrez Cognos TM1 Performance Modeler depuis la

barre d'outils de la page du portail Cognos TM1 Applications.a. Dans un navigateur Web, entrez l'URI de Cognos TM1 Applications :

Par exemple, http://localhost:9510/pmpsvcv Remplacez localhost par le nom de l'ordinateur sur lequel est installé le

serveur Cognos TM1 Applications.


v Si nécessaire, modifiez le numéro de port si vous avez utilisé une valeurdifférente dans IBM Cognos Configuration pour la propriété URI de lapasserelle du serveur d'applications TM1.

b. Dans le portail de Cognos TM1 Applications, cliquez sur l'icône Ouvrir

Performance Modeler .5. Pour installer le programme sur plusieurs ordinateurs, créez une installation

sans surveillance à partir des étapes précédentes. Pour plus d'informations, voirAnnexe C, «Définitions d'installations et de configurations sans surveillance», àla page 389.

Installation de Cognos TM1 Performance Modeler depuis leportail Cognos TM1 Applications

Vous pouvez installer IBM Cognos TM1 Performance Modeler à la premièreexécution de ce composant depuis le portail d'IBM Cognos TM1 Applications.

Avant de commencer

Avant d'installer Cognos TM1 Performance Modeler depuis le portail Cognos TM1Applications, l'administrateur doit installer Cognos TM1 Applications.

Procédure1. Dans un navigateur Web, entrez l'URI du portail de Cognos TM1 Applications :

Par exemple, http://localhost:9510/pmpsvca. Remplacez localhost par le nom de l'ordinateur sur lequel est installé le

serveur Cognos TM1 Applications.b. Si nécessaire, modifiez le numéro de port si vous avez utilisé une valeur

différente dans IBM Cognos Configuration pour la propriété URI de lapasserelle du serveur d'applications TM1.

2. Dans le portail de Cognos TM1 Applications, cliquez sur l'icône Ouvrir

Performance Modeler .Si vous utilisez Cognos TM1 Performance Modeler pour la première fois, l'icôneInstaller maintenant s'affiche pour indiquer que vous êtes sur le pointd'installer le client Cognos TM1 Performance Modeler sur votre ordinateur.

3. Cliquez sur Installer maintenant.4. Cliquez sur Terminer pour achever la procédure.

Que faire ensuite

Pour plus d'informations sur l'utilisation d'IBM Cognos TM1 Performance Modeler,reportez-vous à la documentation TM1 Performance Modeler.

Installation multiposte distante de Cognos TM1 PerformanceModeler

En tant qu'administrateur, vous pouvez pousser automatiquement l'installationd'IBM Cognos TM1 Performance Modeler vers les utilisateurs. Vous devez d'abordrendre le fichier d'installation de Cognos TM1 Performance Modeler disponibledans un dossier partagé du réseau. Puis, vous utilisez une application telle queMicrosoft Active Directory pour installer automatiquement l'application client surles postes d'utilisateurs authentifiés.



Cognos TM1 Performance Modeler est installé à l'aide d'un fichier d'installationque vous placez dans un répertoire partagé. Vous pouvez utiliser Active Directorypour installer Cognos TM1 Performance Modeler directement sur l'ordinateur desutilisateurs.

Utilisez le fichier PerformanceModeler.msi pour installer Cognos TM1 PerformanceModeler. Ce fichier est installé dans le répertoire suivant lorsque vous installez lecomposant Cognos TM1 Application Gateway :

répertoire_TM1\webapps\pmpsvc\rcp_installs

Vous pouvez utiliser le fichier PerformanceModeler.msi avec les options de ligne decommande de Windows Installer, et utiliser Active Directory ou d'autres outils degestion de logiciels pour pousser l'installation vers des ordinateurs distants.

Le fichier PerformanceModeler.msi est un fichier d'installation Microsoft Windowsstandard. Vous pouvez utiliser le fichier PerformanceModeler.msi avec les optionsde ligne de commande de Windows Installer, et utiliser Active Directory oud'autres outils de gestion de logiciels pour pousser l'installation vers desordinateurs distants.

Le tableau suivant répertorie certaines des valeurs de propriété utilisables par lesadministrateurs pour installer le fichier PerformanceModeler.msi. Pour plus dedétails, consultez sur le site Web Microsoft destiné aux développeurs ladocumentation relative au sujets «Windows Installer Guide» et «Windows InstallerProperty Reference».

Tableau 19. Valeurs de quelques propriétés pour Cognos TM1 Performance Modeler

PropriétéValeur de lapropriété Description

ALLUSERS 1 Installe Cognos TM1 Performance Modelerpour tous les utilisateurs.

Cette propriété signifie que les entrées deregistre de Cognos TM1 PerformanceModeler se trouvent sousHKEY_LOCAL_MACHINE.Remarque : Vous devez utiliser cettepropriété avec la propriété TARGETDIR.

ALLUSERS "" (valeur par défaut) Installe Cognos TM1 Performance Modelerpour l'utilisateur qui exécute l'installationuniquement. Seul cet utilisateur aura accèsà l'application.

TARGETDIR "répertoire_installation_Performance Modeler"

Spécifie l'emplacement d'installation deCognos TM1 Performance Modeler.

Par exemple, TARGETDIR="C:\ProgramFiles"


Tableau 19. Valeurs de quelques propriétés pour Cognos TM1 Performance Modeler (suite)


TARGETDIR "" (valeur par défaut) Définit l'emplacement d'installation pourCognos TM1 Performance Modeler siTARGETDIR n'est pas spécifié et lorsque lapropriété ALLUSERS est spécifiée commesuit :

Si ALLUSERS="" :

v Sous Windows XP, l'emplacementd'installation est C:\Documents andSettings\nom_utilisateur\ApplicationData\IBM\Cognos TM1 PerformanceModeler

v Sous Windows 7, l'emplacementd'installation est C:\Users\nom_utilisateur\AppData\Roaming\IBM\Cognos TM1 Performance Modeler

Si ALLUSERS=1 :

v Sous Windows XP, l'emplacementd'installation est C:\Documents andSettings\All Users\ApplicationData\IBM\Cognos TM1 PerformanceModeler

v Sous Windows 7, l'emplacementd'installation est C:\ProgramData\IBM\Cognos TM1 PerformanceModeler

NOUPDATE Oui Empêche les utilisateurs de Cognos TM1Performance Modeler de recevoir des misesà jour automatiques.

Cette valeur est recommandée lorsque lesutilisateurs finaux ne disposent pas del'accès en écriture à l'emplacementd'installation de l'application. Les mises àjour automatiques nécessitent que lesutilisateurs de Cognos TM1 PerformanceModeler puissent écrire dans le répertoirespécifié, ou dans le répertoire par défautdéfini par la propriété TARGETDIR.

NOUPDATE Non (valeur pardéfaut)

Permet aux utilisateurs de Cognos TM1Performance Modeler de recevoir des misesà jour automatiques.

La procédure qui suit présente un exemple.

Procédure1. Ouvrez une invite de commande et accédez au répertoire du fichier

PerformanceModeler.msi.2. Pour installer Cognos TM1 Performance Modeler pour tous les utilisateurs,

entrez la commande suivante :PerformanceModeler.msi TARGETDIR="install_location" ALLUSERS=1


Configuration de la journalisation de Cognos TM1Performance Modeler

La journalisation d'IBM Cognos TM1 Performance Modeler peut être activée àl'aide du même système de journalisation que les autres composants d'IBM CognosTM1.

Procédure1. Localisez le fichier provagent_NOT.ini et renommez-le provagent.ini.

Ce fichier se trouve dans le répertoire suivant :C:\Users\<nom d'utilisateur>\AppData\Roaming\IBM\Cognos PerformanceModeler

2. Editez provagent.ini et annulez la mise en commentaire de la ligne suivante.Remplacez #app-debug=true par app-debug=true.

3. Dans le même répertoire, ouvrez et éditez le fichier defaultLog.propertiespour configurer la journalisation.

Remarque : La configuration par défaut de la journalisation enregistre lesmessages de niveau ERROR, qui sont généralement suffisants pour les opérationscourantes. Elle a donc rarement besoin d'être modifiée. Néanmoins, les niveauxde journalisation configurables sont WARNING, INFO ou DEBUG. Contactez lesupport client IBM si vous devez modifier la configuration pour enregistrer desmessages plus spécifiques.

Résultats

Les fichiers journaux sont généralement enregistrés à l'emplacement suivant :

%appdata%/IBM/nom de l'application/logs

Installation de Cognos InsightIl existe différentes manières de distribuer et d'installer IBM Cognos Insight surplusieurs ordinateurs.

En fonction de votre environnement réseau et de vos besoins métier, vous pouvezinstaller l'application, autoriser les utilisateurs à l'installer s'ils en ont besoin, ou lapousser depuis une machine distante.

Le tableau qui suit récapitule les différents modes de distribution et d'installationd'IBM Cognos Insight sur plusieurs ordinateurs.

Tableau 20. Options d'installation de Cognos Insight sur plusieurs ordinateurs


«Installation de Cognos Insight àl'aide du programme d'installation», à la page 184

Les administrateurs ou les utilisateurs peuventinstaller Cognos Insight sur un seul ordinateur àl'aide du programme d'installation d'IBM CognosTM1 Client-only.

Vous pouvez également créer une installationautomatique pour installer Cognos Insight surplusieurs ordinateurs.


Tableau 20. Options d'installation de Cognos Insight sur plusieurs ordinateurs (suite)


«Installation de Cognos Insight àpartir du portail Cognos TM1Applications»

Au préalable, l'administrateur doit installer CognosTM1 Applications.

Cela permet aux utilisateurs de Cognos TM1d'installer Cognos Insight sur leurs ordinateurs aupremier lancement du produit sur le portail IBMCognos TM1. On parle alors de distribution delogiciels.

«Installation multiposte distante deCognos Insight», à la page 185

Un administrateur peut utiliser des outils réseaud'autres fournisseurs pour pousser Cognos Insightvers plusieurs systèmes client distants.

Installation de Cognos Insight à l'aide du programmed'installation

Vous pouvez installer en mode interactif une version autonome d'IBM CognosInsight sur un ou plusieurs ordinateurs.


avec le bouton droit sur le fichier issetup.exe, puis cliquez sur Exécuter entant qu'administrateur. Pour les autres systèmes d'exploitation, cliquez deuxfois sur le fichier issetup.exe sur le disque d'installation du client IBM CognosTM1, ou à partir de l'emplacement dans lequel les fichiers d'installation duclient IBM Cognos TM1 ont été téléchargés et extraits.

2. Dans la page Sélection des composants, développez Niveau riche TM1 etcochez la case Cognos Insight. Laissez toutes les autres cases désélectionnées.

3. Suivez la procédure et cliquez sur Terminer pour terminer l'installation.4. Pour tester l'installation, ouvrez Cognos Insight à partir de Démarrer > Tous

les programmes > IBM Cognos Insight > IBM Cognos Insight.5. Pour installer le programme sur plusieurs ordinateurs, créez une installation

sans surveillance à partir des étapes précédentes. Pour plus d'informations, voirAnnexe C, «Définitions d'installations et de configurations sans surveillance», àla page 389.

Installation de Cognos Insight à partir du portail Cognos TM1Applications

Vous pouvez installer IBM Cognos Insight lors de la première exécution de cecomposant depuis la barre d'outils du portail IBM Cognos TM1 Applications.

Avant de commencer

Avant d'installer Cognos Insight à partir de Cognos TM1 Applications,l'administrateur doit installer Cognos TM1 Applications.

Procédure1. Dans un navigateur Web, entrez l'URI du portail Cognos TM1 Applications :

Par exemple, http://localhost:9510/pmpsvca. Remplacez localhost par le nom de l'ordinateur sur lequel est installé le

portail Cognos TM1 Applications.


b. Si nécessaire, modifiez le numéro de port si vous avez utilisé une valeurdifférente dans IBM Cognos Configuration pour la propriété URI de lapasserelle de TM1 Applications.

2. Dans le portail Cognos TM1 Applications, cliquez sur l'icône Ouvrir IBM

Cognos Insight .Si vous utilisez Cognos Insight pour la première fois, l'icône Installermaintenant s'affiche pour indiquer que vous êtes sur le point d'installer leclient Cognos Insight sur votre ordinateur.

3. Cliquez sur Installer maintenant.4. Cliquez sur Terminer pour achever la procédure.

Que faire ensuite

Cognos Insight est maintenant installé dans un dossier de votre ordinateur. Vouspouvez lancer et utiliser Cognos Insight de l'une des manières suivantes :v Vous pouvez lancer Cognos Insight à l'aide de l'icône Ouvrir Cognos Insight

dans Cognos TM1 Applications.v Vous pouvez lancer le client Cognos Insight en cliquant avec le bouton droit sur

le noeud d'une application qui a été configurée pour utiliser Cognos Insight.Pour que Cognos Insight soit disponible comme client à partir d'une application,vous devez avoir configuré l'utilisation du client connecté ou réparti CognosInsight dans l'environnement client de Cognos TM1 Applications. Pour plusd'informations, voir «Configuration des environnements client et serveur deCognos TM1 Application Web», à la page 138.

v Vous pouvez lancer Cognos Insight en tant que produit autonome à partir dumenu Windows Démarrer > Tous les programmes > IBM Cognos Insight.

Installation multiposte distante de Cognos InsightEn tant qu'administrateur, vous pouvez pousser automatiquement l'installationd'IBM Cognos Insight vers les utilisateurs. Vous devez d'abord rendre le fichierd'installation de Cognos Insight disponible dans un dossier partagé du réseau.Puis, vous utilisez une application telle que Microsoft Active Directory pourinstaller directement l'application client sur les postes d'utilisateurs authentifiés.


Cognos Insight est installé à l'aide du fichier CognosInsight.msi que vous placezdans un répertoire partagé. Ce fichier est installé dans le répertoire suivant lorsquevous installez le composant IBM Cognos TM1 Application Gateway :

répertoire_TM1\webapps\pmpsvc\rcp_installs

Le fichier CognosInsight.msi est un fichier d'installation Microsoft Windowsstandard. Vous pouvez utiliser le fichier CognosInsight.msi avec les options deligne de commande de Windows Installer, et utiliser Active Directory ou d'autresoutils de gestion de logiciels pour pousser l'installation vers des ordinateursdistants.

Le format de la commande est le nom du fichier MSI de Cognos Insight suivi desvaleurs de propriété. Par exemple, vous pouvez entrer CognosInsight.msiTARGETDIR="C:\Program Files" USERDATADIR=%%USERNAME%%.


Vous pouvez utiliser les valeurs de propriété ci-après seules ou combinées entreelles.

Tableau 21. Valeurs de quelques propriétés pour Cognos Insight


ALLUSERS 1 Installe Cognos Insight pour tous lesutilisateurs.

Cette valeur de propriété définitl'emplacement d'installation par défaut surC:\Program Files.

ALLUSERS "" (valeur par défaut) Installe Cognos Insight pour l'utilisateur quiexécute l'installation uniquement. Seul cetutilisateur aura accès à l'application.

La définition de la propriété ALLUSERS=""ou l'omission de la propriété ALLUSERSinstalle Cognos Insight dans le contexte del'utilisateur et définit C:\Users\nom_utilisateur\AppData\Local\Programs\IBM\Cognos Insight pour la propriétéTARGETDIR.

TARGETDIR "répertoire_installation_ Cognos_Insight"

Spécifie l'emplacement d'installation deCognos Insight.

Par exemple, TARGETDIR="C:\ProgramFiles"

TARGETDIR (valeur par défaut) Définit l'emplacement d'installation pourCognos Insight lorsque TARGETDIR n'est passpécifié et si la propriété ALLUSERS estspécifiée comme suit :

Si ALLUSERS="" :

v Sur un système d'exploitation MicrosoftWindows XP, l'emplacement d'installationest C:\Documents\nom_utilisateur\Local\Application\Programs

v Sur un système d'exploitation MicrosoftWindows 7, l'emplacement d'installationest C:\Users\nom_utilisateur\AppData\Local\Programs

Si ALLUSERS="1" :

v Sur un système d'exploitation MicrosoftWindows 32 bits, l'emplacementd'installation est C:\Program Files

v Sur un système d'exploitationMicrosoftWindows 64 bits, l'emplacementd'installation est C:\Program Files (x86)


Tableau 21. Valeurs de quelques propriétés pour Cognos Insight (suite)


NOUPDATE Oui Empêche les utilisateurs de Cognos Insightde recevoir des mises à jour automatiques.

Cette valeur est recommandée lorsque lesutilisateurs ne disposent pas de l'accès enécriture à l'emplacement d'installation del'application. Les mises à jour automatiquesexigent des utilisateurs Cognos Insightqu'ils puissent accéder en écriture àl'emplacement d'installation spécifié par lapropriété TARGETDIR.

NOUPDATE Non (valeur pardéfaut)

Permet aux utilisateurs de Cognos Insightde recevoir des mises à jour automatiques.

USERDATADIR "location" Spécifie l'emplacement du dossier.CognosInsight. Le dossier .CognosInsightcontient les thèmes Cognos Insight, lesdonnées IBM Cognos TM1 qui sont copiéessur votre ordinateur lorsque vous travaillezdepuis un serveur Cognos TM1, ainsi queles images miniatures des espaces de travailqui figurent sur la page Mise en route deCognos Insight.

USERDATADIR "" (valeur par défaut) Si USERDATADIR n'est pas spécifié, le dossier.CognosInsight se trouve à l'un desemplacements suivants :

v Sur un système d'exploitation MicrosoftWindows XP : C:\Documents andSettings\nom_utilisateur\.CognosInsight.

v Sur un système d'exploitation MicrosoftWindows 7 : C:\Users\nom_utilisateur\.CognosInsight.

Lorsqu'ALLUSERS=1, et si vous voulezspécifier USERDATADIR, la propriétéUSERDATADIR doit inclure une variabled'environnement qui sera résoluedifféremment pour chaque utilisateur.

Par exemple, la commandeCognosInsight.msi ALLUSERS=1USERDATADIR=^%USERPROFILE^% indique queCognos Insight doit être installé dansC:\Program Files et que le dossier.CognosInsight doit être installé dans ledossier de profil utilisateur de chaqueutilisateur.

Pour plus de détails, consultez le site Web Microsoft destiné aux développeurs quicontient les documentations Microsoft Windows Installer Guide et MicrosoftWindows Installer Property Reference.

La procédure qui suit présente un exemple.


Procédure1. Ouvrez une invite de commande et accédez au répertoire du fichier

CognosInsight.msi.2. Pour installer Cognos Insight pour tous les utilisateurs, entrez la commande

suivante :CognosInsight.msi TARGETDIR="install_location" ALLUSERS=1

Configuration de la journalisation de Cognos InsightLa journalisation d'IBM Cognos Insight peut être activée à l'aide du même systèmede journalisation que les autres composants d'IBM Cognos TM1.

Procédure1. Localisez le fichier provagent_NOT.ini et renommez-le provagent.ini.

Ce fichier se trouve dans le répertoire suivant :C:\Users\<nom d'utilisateur>\AppData\Local\Programs\IBM\Cognos Insight

2. Editez provagent.ini et annulez la mise en commentaire de la ligne suivante :Remplacez #app-debug=true par app-debug=true.

3. Dans le même répertoire, ouvrez et éditez le fichier defaultLog.propertiespour configurer la journalisation.

Remarque : La configuration par défaut de la journalisation enregistre lesmessages de niveau ERROR, qui sont généralement suffisants pour les opérationscourantes. Elle a donc rarement besoin d'être modifiée. Néanmoins, les niveauxde journalisation configurables sont WARNING, INFO ou DEBUG. Contactez lesupport client IBM si vous devez modifier la configuration pour enregistrer desmessages plus spécifiques.

Résultats

Les fichiers journaux sont généralement enregistrés à l'emplacement suivant :

%appdata%/IBM/nom de l'application/logs

Installation des API de Cognos TM1Utilisez l'option d'installation API TM1 pour installer les fichiers qui permettrontaux programmeurs d'utiliser les API de Cognos TM1. Cette option d'installation estaussi disponible pour les serveurs Cognos Analytics pour permettre la générationde rapports Cognos Analytics à partir de sources de données Cognos TM1.


Cette option installe les fichiers des API Cognos TM1 suivantes :

API TM1Permet aux développeurs de créer des applications C, C++ et VBpersonnalisées qui interagissent avec TM1.

API TM1 JavaPermet aux développeurs de créer des applications Java personnalisées quiinteragissent avec TM1.

API TM1 .NETPermet aux développeurs de créer des applications Microsoft .NETpersonnalisées qui interagissent avec TM1.


Avertissement : Pour obtenir des informations sur l'utilisation des API TM1 pourimplémenter la génération de rapports Cognos Analytics à partir de sources dedonnées Cognos TM1, consultez la rubrique «Cognos TM1 en tant que source dedonnées avec Cognos Analytics», à la page 63.

Procédure1. Exécutez le programme d'installation complet d'IBM Planning Analytics ou le

programme d'installation du client :v Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008, cliquez

avec le bouton droit de la souris sur le fichier issetup.exe, puis cliquez surExécuter en tant qu'administrateur.

v Dans le cas des autres systèmes d'exploitation Windows, cliquez deux foissur le fichier issetup.exe.

2. Sélectionnez le répertoire d'installation dans la page Emplacementd'installation :v Si vous prévoyez d'utiliser les API TM1 dans le cadre de la programmation,

acceptez l'installation par défaut.v Si vous les utilisez pour permettre la génération de rapports Cognos

Analytics à partir de sources de données Cognos TM1, sélectionnez unrépertoire adjacent sur le serveur Cognos Analytics qui exécute les servicesde génération de rapports sous Microsoft Windows.

3. Dans la page Sélection des composants :a. Développez le niveau client TM1 et sélectionnez l'option API TM1.b. Désélectionnez toutes les cases à cocher des autres composants.

4. Suivez la procédure et cliquez sur Terminer pour terminer l'installation.

Configuration des postes client en vue de l'exportation des donnéesCognos TM1 au format PDF

Pour exporter des données IBM Cognos TM1 au format Adobe PDF depuis desapplications client IBM Cognos TM1 qui s'exécutent sous Microsoft Windows,définissez PDFCamp comme votre imprimante par défaut. Cette procédures'applique à IBM Cognos TM1 Perspectives, IBM Cognos TM1 Architect et IBMCognos TM1 Web.

Avant de commencer

Assurez-vous que PDFCamp est correctement installé en vérifiant que PDFCampPrinter Driver existe dans la configuration Windows, Imprimantes et télécopieurs.

Procédure1. Dans Windows, ouvrez la fenêtre de configuration Imprimantes et

télécopieurs.2. Cliquez avec le bouton droit sur PDFCamp Printer Driver et sélectionnez

Définir comme imprimante par défaut.


Chapitre 15. Installation et configuration d'IBM PlanningAnalytics for Microsoft Excel

IBM Planning Analytics for Microsoft Excel est un outil Microsoft Excel utilisé parles auteurs de rapports pour créer des rapports sophistiqués contenant plusieursfeuilles et plusieurs requêtes à partir de différentes bases de données.

L'utilisateur peut élaborer dans Excel des rapports complexes de plusieurs feuilles,contenant plusieurs requêtes, à partir de différents types de sources de données, etanalyser et explorer les données IBM Cognos modelées de façon dimensionnelle.L'application permet d'accéder aux données à partir de formules afin quel'utilisateur puisse résoudre des problèmes métier et présenter ses résultats de lafaçon la mieux adaptée.

Pour IBM Cognos TM1, elles est utilisée par les analystes financiers et lesplanificateurs qui planifient et mesurent les données métier et opérationnelles.

NouveautésCette section contient la liste des fonctions nouvelles ou modifiées pour cetteédition. Elle vous aide à planifier vos stratégies de mise à niveau et dedéploiement d'application, ainsi que les besoins de formation de vos utilisateurs.

Nouveautés de la version 2.0.0Les informations figurant dans cette section répertorient les fonctions qui ont étéintroduites depuis l'édition précédente.v IBM Planning Analytics for Microsoft Excel requiert l'installation de Microsoft

.NET Framework 4.6.1 ou d'une version ultérieure.v IBM Planning Analytics for Microsoft Excel prend en charge les modes

d'authentification de sécurité 1, 2, 3, 4 et 5. Les versions précédentes prenaienten charge les modes 1 et 5.Toutefois, lors d'une connexion à IBM Planning Analytics Workspace, seuls lesmodes d'authentification de sécurité 1 et 5 peuvent être utilisés.L'authentification par formulaire n'est plus prise en charge pour les serveursIBM Planning Analytics dans IBM Planning Analytics for Microsoft Excel.

Nouveautés de la version 10.3.0Les informations figurant dans cette section répertorient les fonctions qui ont étéintroduites depuis l'édition précédente.v Si vos serveurs utilisent le protocole TLS (Transport Layer Security), vous devez

utiliser Microsoft .NET Framework 4.5 ou ultérieur avec IBM Cognos Analysisfor Microsoft Excel. Les nouveaux serveurs ainsi que les serveurs qui ont étécorrigés pour remédier à la vulnérabilité en matière de sécurité de POODLEdans SSL, utilisent TLS.

Nouveautés de la version 10.2.0Les informations figurant dans cette section répertorient les fonctions qui ont étéintroduites depuis l'édition précédente. Elles peuvent contenir des liens vers desrubriques connexes.


v Les produits IBM Cognos Office, tels qu'IBM Cognos Analysis for MicrosoftExcel et IBM Cognos BI for Microsoft Office nécessitent désormais Microsoft.NET Framework 4.Cette condition a des conséquences sur la mise à niveau des systèmes. Si vousutilisez déjà un produit IBM Cognos Office et si vous n'avez installé que laversion 2 de Microsoft .NET Framework, vous devez installer .NET Framework4 avant d'installer des produits IBM Cognos Office. Les versions de Microsoft.NET Framework peuvent fonctionner concurremment. Il n'est pas nécessaire dedésinstaller les versions précédentes.

v Support de langue supplémentaireLes langues suivantes sont désormais disponibles pour les produits IBM CognosOffice : le croate, le danois, le kazakh, le slovène et le thaï.

Nouveautés de la version 10.1.1Les informations figurant dans cette section répertorient les fonctions qui ont étéintroduites depuis l'édition précédente. Elles peuvent contenir des liens vers desrubriques connexes.

Extension des plateformes et des environnements pris en chargeDes améliorations ont été apportées pour étendre la prise en charge de plusieursplateformes et environnements.

Prise en charge de l'installation 64 bits

IBM Planning Analytics for Microsoft Excel prend en charge un environnement 64bits. Les environnements 64 bits offrent une meilleure gestion de la mémoire, ainsiqu'une évolutivité et des performances améliorées. Vous avez désormais le choixentre l'installation et l'exécution des versions 32 et 64 bits d'IBM Planning Analyticsfor Microsoft Excel. L'application IBM Cognos peut s'exécuter dans une version 32ou 64 bits de Microsoft Office Excel, sur un système d'exploitation 64 bits.

Si vous effectuez une installation 64 bits, le chemin d'accès par défaut utilisé pourl'installation est différent du chemin d'accès par défaut pour une installation 32bits. Répertoire d'installation par défaut :v Pour une installation 32 bits, C:\Program Files\IBM\cognos\Cognos for

Microsoft Office

v Pour une installation 64 bits sur un système d'exploitation 64 bits, C:\ProgramFiles\IBM\cognos\Cognos for Microsoft Office

v Pour une installation 32 bits sur un système d'exploitation 64 bits, C:\ProgramFiles(X86)\IBM\cognos\Cognos for Microsoft Office

Prise en charge de Microsoft Office 2010

La version 2010 du logiciel Microsoft Excel est prise en charge pour IBM PlanningAnalytics for Microsoft Excel

Le nouveau format XML Office Open étant reconnu comme norme de l'industrieprise en charge par ECMA International, le nouveau format supporté par MicrosoftOffice 2010 simplifie l'extensibilité et l'interopérabilité en activant lesimplémentations sur plusieurs plateformes.


Prise en charge de Mozilla Firefox

La version 4 du navigateur Web Mozilla Firefox est prise en charge pour IBMPlanning Analytics for Microsoft Excel.

Prise en charge d'Internet Explorer

La version 9 du navigateur Web Microsoft Internet Explorer est prise en chargepour IBM Planning Analytics for Microsoft Excel.

Support de langue supplémentaireIBM Cognos Analysis for Microsoft Excel prend désormais en charge le norvégien.

Présentation de l'installationPour utiliser IBM Planning Analytics for Microsoft Excel, vous devez installerMicrosoft .NET Framework et les composants d'IBM Planning Analytics forMicrosoft Excel.

IBM Cognos TM1 inclut des exemples que vous pouvez utiliser avec IBM PlanningAnalytics for Microsoft Excel. Ces exemples illustrent les fonctions du produit,ainsi que les meilleures pratiques en termes techniques et professionnels à l'aide dedonnées fictives. Vous pouvez aussi les utiliser pour tester et partager destechniques de conception de rapports, ainsi que pour l'identification et larésolution des problèmes. Pour utiliser les exemples, votre administrateur doit lesdéfinir et les configurer. Contactez votre administrateur pour savoir où ils sontinstallés.

Désinstallez les versions antérieures d'IBM Planning Analytics for Microsoft Excelavant d'installer une nouvelle version.

Procédure1. Effectuez les tâches prérequises.

a. Installez Microsoft .NET Framework.Pour plus d'informations, voir Installation de Microsoft .NET Framework.

b. Installez les assemblages d'interopérabilité de base (PIA).Pour plus d'informations, voir Installation des assemblages d'interopérabilitéde base (PIA).

c. Désinstallez les versions précédentes d'IBM Planning Analytics for MicrosoftExcel.Pour plus d'informations, voir «Désinstallation des versions précédentesd'IBM Cognos for Microsoft Excel», à la page 196.

d. «Connexion à IBM Planning Analytics Workspace Local», à la page 196.e. Configurez votre logiciel antivirus pour autoriser les connexions de

Microsoft .NET Runtime et Microsoft Excel.f. «Assurez-vous de bien utiliser un ID IBM», à la page 197.

2. Installez les composants d'IBM Planning Analytics for Microsoft Excel.Pour plus d'informations, voir Installation des composants IBMCognos Analysis for Microsoft Excel.

3. Testez IBM Planning Analytics for Microsoft Excel.Pour plus d'informations, voir Test d'IBM Cognos Analysis for Microsoft Excel.

Chapitre 15. Installation et configuration d'IBM Planning Analytics for Microsoft Excel 193

Conditions préalables à l'installation de Planning Analytics forMicrosoft Excel

Vous devez effectuez les tâches de cette section avant d'installer Planning Analyticsfor Microsoft Excel.

Installation de Microsoft .NET FrameworkIBM Planning Analytics for Microsoft Excel requiert l'installation de Microsoft .NETFramework version 4.6.1 ou d'une version ultérieure sur tous les ordinateurs desutilisateurs.

Pour connaître la liste des versions de Microsoft .NET Framework prises en charge,voir IBM Software Product Compatibility Reports (http://www.ibm.com/software/reports/compatibility/clarity/index.jsp).

Lorsque vous installez Microsoft .NET Framework sur un système d'exploitationqui n'est pas en anglais, les messages d'erreur, les raccourcis et les utilitairesMicrosoft .NET s'affichent quand même en anglais.

Pour les langues autres que l'anglais, vous pouvez appliquer le pack linguistiqueMicrosoft .NET pour voir les messages d'erreurs, raccourcis et utilitaires dans lalangue de votre système d'exploitation. Par exemple, si votre systèmed'exploitation est français et que vous avez installé Microsoft .NET Framework,vous devez également appliquer le pack linguistique Microsoft .NET français.

Procédure1. Connectez-vous au site Web de téléchargement Microsoft.2. Recherchez .NET Framework 4.6.1 ou une version ultérieure, sélectionnez le

pack redistribuable et suivez les instructions pour le télécharger.3. Vérifiez s'il y a des mises à jour de sécurité concernant Microsoft

.NET Framework et téléchargez-les, le cas échéant.

Assemblages d'interopérabilité de base (PIA) pour MicrosoftExcel

Pour utiliser les fonctionnalités d'IBM Planning Analytics for Microsoft Excel, vousdevez avoir installé au préalable les assemblages d'interopérabilité de base (PIA -Primary Interop Assemblies) pour Excel. En principe, les PIA sont installésautomatiquement sur votre ordinateur lorsque vous installez Microsoft Office. Ilexiste néanmoins des cas où il est nécessaire de les installer séparément.

Les PIA doivent être installés et enregistrés dans le cache global des assemblagessur les postes de travail pour que ces derniers puissent exécuter des solutionsOffice qui ciblent .NET Framework.

Vous avez le choix entre deux méthodes pour installer le jeu complet de PIA dansle cache global des assemblages :v Modifier la configuration de Microsoft Office.

Si vous n'avez pas installé .NET Framework avant le système Office, ce dernierne comprend pas les PIA. Si vous avez installé .NET Framework après lesystème Office, vous pouvez installer les PIA en modifiant la configurationd'Office.

v Installer les PIA à partir du pack redistribuable.


http://www.ibm.com/software/reports/compatibility/clarity/index.jsp

Les PIA de Microsoft Office sont installés dans le cache global des assemblages, surunité:/WINDOWS/assembly ou unité:/WINNT/assembly.

Modification de la configuration de Microsoft Office en vue del'installation des assemblages d'interopérabilité de base (PIA)pour ExcelPour utiliser les fonctionnalités d'IBM Planning Analytics for Microsoft Excel, vousdevez avoir installé au préalable les assemblages d'interopérabilité de base (PIA -Primary Interop Assemblies) pour Excel. En principe, les PIA sont installésautomatiquement sur votre ordinateur lorsque vous installez Microsoft Office. Ilexiste néanmoins des cas où il est nécessaire de les installer séparément.

Les PIA doivent être installés et enregistrés dans le cache global des assemblagessur les postes de travail pour que ces derniers puissent exécuter des solutionsOffice qui ciblent .NET Framework 4.5.1 ou une version ultérieure.

Si vous n'avez pas installé .NET Framework avant le système Office, ce dernier necomprend pas les PIA. Si vous avez installé .NET Framework après le systèmeOffice, vous pouvez installer les PIA en modifiant la configuration d'Office.


Avant de commencer

Vous devez avoir le rôle d'administrateur pour installer .NET Framework et lesPIA Microsoft Office sur un ordinateur.

Procédure1. Dans le menu Démarrer, cliquez sur Panneau de configuration, puis cliquez

sur Programmes et fonctionnalités.2. Dans la liste des programmes, cliquez sur votre version de Microsoft Office,

puis cliquez sur Modifier.3. Dans l'assistant d'installation de Microsoft Office , sélectionnez Ajouter ou

supprimer des composants, puis cliquez sur Continuer.4. Dans la page Options d'installation, développez Microsoft Excel.5. Cliquez sur le symbole en regard de la fonctionnalité Prise en charge de la

programmabilité .Net, puis cliquez sur Exécuter à partir du disque dur.6. Cliquez sur Continuer.7. Cliquez sur Fermer.

Installation des PIA pour Microsoft ExcelPour utiliser les fonctionnalités d'IBM Planning Analytics for Microsoft Excel, vousdevez avoir installé au préalable les assemblages d'interopérabilité de base (PIA -Primary Interop Assemblies) pour Excel. En principe, les PIA sont installésautomatiquement sur votre ordinateur lorsque vous installez Microsoft Office. Ilexiste néanmoins des cas où il est nécessaire de les installer séparément. Si vousn'avez pas installé .NET Framework avant le système Office, ce dernier necomprend pas les PIA. Vous pouvez installer les PIA à partir du packredistribuable.

Les PIA doivent être installés et enregistrés dans le cache global des assemblagessur les postes de travail pour que ces derniers puissent exécuter des solutionsOffice qui ciblent .NET Framework 4.5 (ou une version ultérieure).



Avant de commencer

Vous devez avoir le rôle d'administrateur pour installer .NET Framework et lesPIA Microsoft Office sur un ordinateur.

Procédure1. Vérifiez que .NET Framework est installé. Pour plus d'informations, voir

«Installation de Microsoft .NET Framework», à la page 194.2. Connectez-vous au site Web de téléchargement Microsoft.3. Suivez les instructions fournies dans la page de téléchargement pour installer

les PIA.

Désinstallation des versions précédentes d'IBM Cognos forMicrosoft Excel

Les versions précédentes d'IBM Planning Analytics for Microsoft Excel s'intitulaientIBM Cognos for Microsoft Office. Si vous disposez d'une version précédente d'IBMCognos for Microsoft Office, vous devez la désinstaller avant d'installer la nouvelleversion d'IBM Planning Analytics for Microsoft Excel.

Le processus de désinstallation ne supprime pas complètement tous les fichiers etrépertoires d'application. Vous devez donc y remédier manuellement.

Si vous avez installé plusieurs composants dans le même emplacement, l'assistantde désinstallation vous permet de choisir les packs à désinstaller. Tous lescomposants du pack seront désinstallés.

Avant de commencer

Fermez toutes les applications Microsoft Office avant de procéder à ladésinstallation.

Procédure1. Dans le menu Démarrer, cliquez sur Programmes, IBM Cognos for Microsoft

Office, Désinstaller IBM Cognos, Désinstaller IBM Cognos.L'assistant de désinstallation s'affiche.Astuce : IBM Cognos for Microsoft Office était le nom par défaut du dossier deprogramme créé lors des installations précédentes. Si vous avez choisi un autrenom, ouvrez ce dossier pour trouver le programme.

2. Suivez les instructions de désinstallation du composant.Le fichier cognos_uninst_log.txt enregistre les activités effectuées par l'assistantdurant la désinstallation des fichiers.Astuce : Pour trouver le fichier journal, cherchez dans le répertoire Temp.

Connexion à IBM Planning Analytics Workspace LocalAvant d'exécuter Planning Analytics for Microsoft Excel, les utilisateurs dePlanning Analytics doivent se connecter à une instance de Planning AnalyticsWorkspace Local installée dans leur environnement.


Remarque : Un utilisateur n'a pas besoin d'installer Planning Analytics WorkspaceLocal sur son propre ordinateur. Il lui suffit de se connecter à une installationPlanning Analytics Workspace Local pour pouvoir utiliser l'éditeur d'ensemble ouCube Viewer.

Pour plus d'informations, voir Chapitre 12, «Planning Analytics Workspaceinstallation», à la page 163.

Configuration de connexions pour les API REST TM1IBM Planning Analytics for Microsoft Excel requiert l'utilisation d'API REST TM1.Pour activer ces APIs dans IBM TM1 Server, il se peut qu'un administrateur doiveconfigurer le numéro de port HTTP dans les fichiers de configuration d'IBM TM1Server pour chaque serveur TM1.

Avant de commencer

Lorsqu'un serveur IBM TM1 est créé, le numéro de port HTTP n'est pasobligatoirement défini par défaut. Cette tâche nécessite que vous éditiez le fichierde configuration de chaque serveur IBM TM1 et que vous définissiez le numéro deport HTTP. Contactez votre administrateur si vous n'avez pas accès au fichier deconfiguration.

Procédure1. Arrêtez le serveur TM1.2. Recherchez le fichier tm1s.cfg. L'emplacement de ce fichier peut varier en

fonction du type de serveur utilisé.3. Ouvrez le fichier tm1s.cfg dans un éditeur.4. Recherchez la ligne contenant ce qui suit : HTTPPortNumber = XXXX.5. Remplacez XXXX par un numéro de port valide qui n'est pas actuellement

utilisé.6. Enregistrez le fichier tm1s.cfg.7. Redémarrez IBM TM1 Server

Résultats

IBM Planning Analytics for Microsoft Excel aura accès aux données du serveurTM1 via les API REST TM1.

Configuration du logiciel antivirusPour pouvoir exécuter Planning Analytics for Microsoft Excel, vous devez aupréalable configurer votre logiciel antivirus pour autoriser les connexions deMicrosoft .NET Runtime et Microsoft Excel.

Si vous ne configurez pas votre logiciel antivirus pour autoriser ces deuxconnexions, un message d'erreur peut apparaître, comme décrit dans la rubrique«COI-ERR-2019 La connexion a échoué», à la page 207.

Assurez-vous de bien utiliser un ID IBMPour utiliser Planning Analytics for Microsoft Excel, vous devez entrer votre IDIBM afin de vous authentifier.

Conseil : Pour enregistrer votre ID IBM, accédez à la page d'enregistrement d'IDIBM (https://ibm.biz/BdHtLT).


https://ibm.biz/BdHtLT

https://ibm.biz/BdHtLT

Tâches d'installationEffectuez les tâches de cette section pour installer Planning Analytics for MicrosoftExcel.

Installation d'IBM Planning Analytics for Microsoft ExcelPour installer IBM Planning Analytics for Microsoft Excel, vous devez téléchargeret exécuter un programme d'installation.

IBM Cognos TM1 inclut des exemples de données que vous pouvez utiliser dansPlanning Analytics for Microsoft Excel. Si vous voulez utiliser les échantillons,votre administrateur IBM Cognos doit les installer sur le système IBM Cognos.

Avant de commencer

Planning Analytics for Microsoft Excel est disponible en installation 32 ou 64 bits.L'installation correspondante doit être installée sur la version 32 ou 64 bits deMicrosoft Office.

Avant de mettre à jour et d'installer les composants, vérifiez les éléments suivants :v Vous disposez des privilèges d'administrateur sur l'ordinateur.v Microsoft .NET Framework 4.6.1 ou une version ultérieure est installé.v Vous avez désinstallé toute version précédente d'IBM Planning Analytics for

Microsoft Excel.v Vous disposez de la licence d'utilisation de votre produit IBM Cognos for

Microsoft Officev Vous avez configuré votre logiciel antivirus pour autoriser ou débloquer les

connexions en provenance des deux applications suivantes :– Microsoft .NET Runtime– Microsoft Excel

Procédure1. Fermez toutes les fenêtres Microsoft Excel.2. Téléchargez et extrayez le programme d'installation.3. Si la version 32 bits de Microsoft Office est installée, accédez au dossier win32.

Si la version 64 bits de Microsoft Office est installée, accédez au dossierwinx64h.

4. Cliquez avec le bouton droit de la souris sur issetup.exe, puis sélectionnezExécuter en tant qu'administrateur. La page Bienvenue s'affiche dans unenouvelle fenêtre.

5. Sélectionnez la langue d'installationLa langue sélectionnée détermine la langue de l'interface utilisateurd'installation. La langue de l'interface utilisateur du produit est définie par lesparamètres de langue d'affichage/principaux de Microsoft Windows.

6. Dans la page Sélection des composants, sélectionnez Planning Analytics forMicrosoft Excel.

7. Suivez les instructions fournies par l'assistant d'installation pour copier lesfichiers nécessaires sur votre ordinateur.

Test d'IBM Planning Analytics for Microsoft ExcelVous pouvez tester l'installation des composants client en démarrant l'application.


Procédure1. Démarrez Microsoft Excel ou ouvrez une feuille de calcul Microsoft Excel.2. Vérifiez qu'IBM Planning Analytics apparaît sur le ruban.

Si l'onglet IBM Planning Analytics n'apparaît pas sur le ruban, voir «Echec del'initialisation de l'interface de Cognos Office dans Microsoft Office», à la page201.

3. Cliquez sur l'onglet IBM Planning Analytics, puis sur Sous-fenêtre des tâches.La sous-fenêtre IBM s'affiche.

Conseil : Vous pouvez ignorer le message suivant, s'il s'affiche :Microsoft Excel doit être redémarré pour terminer l'enregistrement et utiliser lesrapports personnalisés.

Que faire ensuite

Pour commencer à utiliser IBM Planning Analytics for Microsoft Excel, vous devezconfigurer des connexions à des serveurs IBM Planning Analytics. Reportez-vousau document IBM Planning Analytics for Microsoft Excel - Guide d'utilisation.

Désinstallation d'IBM Planning Analytics for Microsoft ExcelDésinstallez la version actuelle d'IBM Planning Analytics for Microsoft Excel.

Le processus de désinstallation ne supprime pas complètement tous les fichiers etrépertoires d'application. Vous devez donc y remédier manuellement.

Si vous avez installé plusieurs composants dans le même emplacement, l'assistantde désinstallation vous permet de choisir les packs à désinstaller. Tous lescomposants du pack seront désinstallés.

Avant de commencer

Fermez toutes les applications Microsoft Office avant de procéder à ladésinstallation.

Procédure1. Dans le menu Démarrer, cliquez sur Programmes, IBM Planning Analytics for

Microsoft Office, Désinstaller les modules d'extension IBM Office,Désinstaller les modules d'extension IBM Office.L'assistant de désinstallation s'affiche.Astuce : IBM Planning Analytics for Microsoft Office est le nom par défaut dudossier de programme créé lors de l'installation. Si vous avez choisi un autrenom, ouvrez ce dossier pour trouver le programme.

2. Suivez les instructions de désinstallation du composant.Les fichiers journaux qui enregistrent le processus de désinstallation se trouventdans le répertoire emplacement_installation/ibm/cognos/IBM for MicrosoftOffice/instlog/


Enregistrement de la macro complémentaire IBM CognosOffice Reporting TM1 à l'aide d'un script

Vous pouvez utiliser un script pour enregistrer la macro complémentaire IBMCognos Office Reporting TM1 (CognosOfficeTM1.xll) avec Microsoft Excel. Vouspouvez utiliser une commande de registre ou vous pouvez modifier puis utiliser lescript Register Cognos XLL.vbs.

Enregistrement de la macro complémentaire IBM Cognos OfficeReporting TM1 à l'aide d'une commande de registreVous pouvez utiliser une commande de registre pour enregistrer une macrocomplémentaire IBM Cognos Office Reporting TM1 (CognosOfficeTM1.xll) avecMicrosoft Excel.

Le script d'échantillon suivant montre la commande de registre de base permettantd'ajouter la référence CognosOfficeTM1.xll à Microsoft Excel.[HKEY_CURRENT_USER\Software\Microsoft\Office\15.0\Excel\Options]"OPEN"="/R \"C:\\Program Files\\IBM\\cognos\\Cognos for MicrosoftOffice\\CognosOfficeTM1.xll\""

Remarque : Il s'agit d'un exemple uniquement. Vous devez modifier la commandepour appliquer le chemin et la clé qui correspondent à votre environnement.

Enregistrement de la macro complémentaire IBM Cognos OfficeReporting TM1 à l'aide du script Register Cognos XLL.vbsCognos Analysis for Microsoft Excel fournit un script VBS appelé Register CognosXLL.vbs. Ce script est par défaut configuré pour enregistrer la macrocomplémentaire CognosOfficeBI.xll, qui correspond à Cognos for Microsoft Office.Vous pouvez modifier ce script pour enregistrer la macro complémentaire IBMCognos Office Reporting TM1. Vous pouvez ensuite exécuter le script directementou l'inclure dans un script de déploiement.

Procédure1. Accédez à l'emplacement d'installation de Cognos Analysis for Microsoft Excel.

Sur Windows 7, l'emplacement d'installation par défaut est C:\Program Files(x86)\IBM\cognos\Cognos for Microsoft Office.

2. Créez une copie de sauvegarde de Register Cognos XLL.vbs.3. Ouvrez le fichier Register Cognos XLL.vbs dans un éditeur de texte.4. A la ligne 19, indiquez le chemin du fichier CognosOfficeTM1.xll. Par

exemple :path = "C:\Program Files (x86)\IBM\cognos\Cognos for Microsoft Office\”

5. A la ligne 20, remplacez CognosOfficeBI.xll par CognosOfficeTM1.xll. Parexemple :file = "CognosOfficeTM1.xll "

6. Enregistrez le fichier.

Traitement des incidentsLes informations qui suivent constituent un outil pratique pour résoudre desproblèmes spécifiques pouvant survenir durant ou après l'installation d'IBMPlanning Analytics for Microsoft Excel.

Problèmes de configurationLes problèmes suivants sont liés à la configuration et à l'installation.


Aucune valeur affichée lors d'une conversion en formulesVous pouvez créer une Vue d'exploration sans aucune erreur. Cependant, lors de laconversion de cette feuille d'exploration en formules, les cellules n'affichent plusles valeurs correctement. Si vous cliquez sur une cellule ne comportant aucunevaleur, elle affiche la formule COGVAL, par exemple, =COGVAL($C$1, $C$2,$B10,C$8,$B$8). Les valeurs s'affichent pourtant correctement sur un autre poste detravail. Si un utilisateur muni des droits d'administration sur le poste de travailessaie de convertir une exploration en formules, les valeurs s'affichent correctementdans les cellules de la feuille de calcul.

L'utilisateur n'a pas utilisé Microsoft Excel avant d'installer IBM Planning Analyticsfor Microsoft Excel et ne s'est pas inscrit correctement. Ce problème peut êtrerésolu de deux façons. Vous pouvez octroyer les droits d'administration du postede travail à l'utilisateur concerné ou exécuter le fichier Register Cognos XLL.vbs,qui permet d'ajouter les entrées de registre correctes pour le nouvel utilisateur.

Pour que le fichier Register Cognos XLL.vbs soit traité correctement (lors del'installation du logiciel et lors de son exécution pour ajouter un nouvel utilisateur),les entrées de registre de Microsoft Excel doivent avoir été créées par MicrosoftExcel. Vous devez vous assurer que l'utilisateur exécute Microsoft Excel avantd'essayer d'ajouter des entrées de registre pour IBM Planning Analytics forMicrosoft Excel. Vous pouvez examiner le fichier ntuser.dat écrit par le script pourvérifier si l'utilisateur a bien été ajouté.

Echec de l'initialisation de l'interface de Cognos Office dansMicrosoft OfficeL'initialisation de IBM Cognos Office peut échouer si Microsoft .NET Frameworkn'est pas installé ou que la version est incorrecte. La version obligatoire deMicrosoft .NET Framework est la version 4.6.1 ou une version ultérieure. Ceproblème peut également se produire si l'extension n'est pas installée ouenregistrée.

Si la version de Microsoft .NET Framework que vous utilisez n'est pas la versionrequise, désinstallez-la, puis réinstallez Microsoft .NET Framework.

Pour installer l'extension IBM Cognos, exécutez le programme d'installation.

Avant de tenter d'installer le composant de prise en charge de laprogrammabilité de Microsoft .NET, vous devez avoir installé Microsoft .NETFramework.

Microsoft Office ne peut pas ouvrir un document Microsoft Officepublié à partir de Cognos OfficeSi vous constatez que Microsoft Office tente d'ouvrir deux fois un document publiélorsque vous cliquez deux fois sur un classeur, un document ou une présentationdans Microsoft Windows Explorer, il est possible que l'association de fichier soitendommagée ou qu'elle ne soit pas définie correctement.

Ce problème peut être résolu de deux façons. Vous pouvez commencer pardémarrer l'application Microsoft Office, puis ouvrir le document en utilisantl'option Ouvrir du menu Fichier, ou vous pouvez réinscrire le type de fichier.


Réenregistrement des types de fichier avec un programme Microsoft Office :

Lorsqu'il est impossible d'ouvrir un document Microsoft Office alors même qu'ilest associé au bon type de fichier, vous devez réenregistrer le type de fichier avecle programme Microsoft Office approprié, par exemple Excel, Word ou PowerPoint.


Dans cette procédure, program.exe est un programme fictif qui doit être remplacépar le programme Microsoft Office à réenregistrer. Si vous avez installé MicrosoftOffice dans un autre emplacement, utilisez le chemin réel.

Remarque : Si vous utilisez la ligne de commande de la version 7 du systèmed'exploitation Microsoft Windows, vous devez augmenter ses droits pour qu'ellepuisse effectuer certaines tâches, notamment le réenregistrement des types defichier. Pour ouvrir une invite de commande en mode élévation ou en modeadministrateur, cliquez avec le bouton droit sur son raccourci, et sélectionnezExécuter en tant qu'administrateur.

Procédure

1. Dans le menu Démarrer, cliquez sur l'option Exécuter.2. Pour annuler l'association avec la version du programme, dans la zone Ouvrir,

entrez la commande suivante, puis cliquez sur OK :program.exe/regserver

3. Pour définir la version par défaut, dans le menu Démarrer, cliquez surExécuter.

4. Dans la zone Ouvrir, entrez la commande suivante, puis cliquez sur OK :program.exe/regserver

Absence des messages .NET dans la langue de .NET FrameworkinstalléeLorsque vous installez une version non anglaise de .NET Framework sur unsystème d'exploitation non anglais, les messages d'erreur, le raccourci .NET et laconsole .NET sont en anglais.

Pour résoudre ce problème, vous devez appliquer le module linguistique de .NETFramework correspondant à votre langue.

Chaque numéro de sous-clé correspond à une langue. Par exemple, l'anglais, lefrançais, l'allemand et le japonais sont associés aux numéros suivants : 1033=en-en,1036=fr-fr, 1031=de-de et 1041=ja. Pour obtenir les numéros de sous-clé des autreslangues, reportez-vous au site de support Microsoft.

Si les sous-clés des modules de prise en charge linguistique sont absentes, vousdevez installer le module de prise en charge linguistique .NET, disponible à partirdu site Web de support technique Microsoft.

Fermeture inattendue d'un classeurSi vous installez le module complémentaire COM et que le nom de votre classeurMicrosoft Excel contient des crochets, Excel ne répond plus ou se ferme de façoninattendue.

Pour résoudre ce problème, renommez le classeur en supprimant les éventuelscrochets.


Problèmes de traitementLes problèmes suivants sont liés au traitement et à l'affichage des rapports.

Amélioration des performances des données Cognos TM1Si les performances ne sont pas bonnes lorsque vous utilisez des données CognosTM1, il est possible que l'administrateur du système Cognos TM1 puisse modifierles paramètres des cubes et du système pour améliorer les performances.

Pour aider l'administrateur de Cognos TM1 à évaluer le problème deperformances, fournissez-lui les détails des données que vous utilisez et desdescriptions des actions qui ont comme conséquence des performancesinacceptables.

Voici des exemples de paramètres Cognos TM1 qui affectent les performances.

VVM (}CubeProperties)Pour chaque cube, cette propriété détermine la quantité de RAM réservéesur le serveur pour le stockage des vues Stargate. Plus il y a de mémoiredisponible pour les vues Stargate, meilleure sont les performances. Lamémoire disponible doit être suffisante pour que le serveur Cognos TM1charge tous les cubes.

VMT (}CubeProperties)Si le temps nécessaire au calcul de vue de cube dépasse le seuil spécifié,TM1 tente de stocker une vue Stargate. Si la mémoire disponible estinsuffisante pour stocker la vue Stargate, TM1 purge la vue Stargate la plusancienne qui n'est pas actuellement utilisée et continue de purger les vuesde cette manière jusqu'à ce que la mémoire disponible soit suffisante.

Pour plus d'informations sur CubeProperties et les autres options de réglage,reportez-vous au document IBM Cognos TM1 Operation.

DPR-ERR-2079 Rejet du pare-feu de sécuritéSi vous exécutez un rapport alors que votre session a expiré, puis tentez de quitterla première page du rapport, une erreur peut survenir.

DPR-ERR-2079 Rejet du pare-feu de sécurité. Votre demande a été rejetée par lepare-feu de sécurité. Les détails relatifs au rejet CAF sont disponibles dans lefichier journal. Veuillez contacter l'administrateur.

Pour corriger l'erreur DPR-ERR-2079, vous devez vous reconnecter dès que votresession arrive à expiration.

Procédure1. Dans la liste des rapports, cliquez avec le bouton droit sur l'élément de noeud

qui s'affiche avant les autres éléments.2. Cliquez sur l'option Connexion.3. A l'invite, indiquez vos données d'authentification, puis cliquez sur le bouton

OK.

Impossibilité d'étendre l'élémentMicrosoft Excel a atteint le nombre maximal de lignes ou de colonnes pour cettefeuille de calcul. Dans Microsoft Excel, le nombre de lignes et de colonnes estlimité. Il est impossible de développer l'élément en cours, car cela ferait glisser des


lignes ou des colonnes en dehors des limites de cette feuille de calcul. MicrosoftExcel ne peut pas faire glisser des cellules non vides en dehors de la feuille decalcul.

Déplacez manuellement les éléments afin que l'élément de ligne ou de colonnepuisse se développer sans atteindre la limite ou déplacez votre Vue d'exploration,votre liste ou votre rapport sur une autre feuille de calcul. Vous pouvez aussidéplacer les données vers un nouvel emplacement et réessayer.

Les résultats ont dépassé la limite du nombre de lignes ou decolonnes ExcelMicrosoft Excel a atteint le nombre maximal de lignes ou de colonnes pour cettefeuille de calcul. Dans Microsoft Excel, le nombre de lignes et de colonnes estlimité. Les éléments sont tronqués.

Filtrez les éléments de telle sorte que les éléments de ligne ou de colonne puissentêtre affichés sans que la limite ne soit atteinte. Prévoyez de créer des Vuesd'exploration, des listes ou des rapports supplémentaires pour répartir les donnéessur plusieurs feuilles de travail. Utilisez une nouvelle version de Microsoft Excelqui autorise des limites plus élevées pour le nombre de lignes et de colonnes.

Erreur : Exception HRESULT:<emplacement>L'importation d'une donnée élémentaire dont le chemin comprend plus de 256caractères génère l'erreur : Exception HRESULT.

Vous devez créer des noms et des identificateurs de données qui respectent lalimite des 256 caractères dans Microsoft Excel.

Erreur lors de l'actualisation de l'exploration enregistrée sousune ancienne version de Microsoft ExcelCe classeur a peut-être été créé avec une ancienne version de Microsoft Excel dontle nombre maximal de lignes de colonnes est défini. Les lignes ou les colonnes audelà des limites maximales sont tronquées.

Bien que vous ne puissiez plus utiliser cette version, l'application fonctionne dansles limites de l'ancienne version d'Excel. Cette situation peut se produire lorsquevous étendez ou actualisez des éléments ayant été élargis depuis que le classeur aété créé.

Pour corriger le problème, vous devez enregistrer le classeur avec l'extension .xlsx.L'ouverture du classeur contenant l'exploration dans une version plus récented'Excel n'entraîne pas sa conversion au nouveau format. Le fait d'enregistrer leclasseur sous l'extension .xlsx permet de convertir le classeur au nouveau format.

Problèmes de sécuritéLes problèmes suivants sont liés à la configuration de la sécurité.

Cognos Office ne parvient pas à créer une relation d'approbationSi vous utilisez un lien HTTPS vers le service de génération de données derapports et que vous recevez un message d'erreur dans IBM Cognos Officeindiquant qu'une relation ne peut être approuvée, le certificat d'authentificationémis par le serveur Web n'est pas approuvé sur le poste de travail client.

Pour résoudre ce problème, vous devez vous assurer que l'autorité de certificationqui a émis le certificat du serveur Web est également approuvée sur le poste de


travail client. Si le certificat ne provient pas d'une autorité déjà approuvée par leclient, telle que Verisign, vous devez installer le certificat d'authentification dans lefichier de clés certifiées du client.

Procédure1. Extrayez le certificat d'authentification de l'autorité de certification.

Le fichier possède une extension .cer. Il ne s'agit pas du certificat utilisé par leserveur Web. Il s'agit plutôt du certificat de l'autorité de certification.

2. Cliquez deux fois sur le fichier .cer, cliquez sur Installer le certificat, puiscliquez sur Suivant.

3. Cliquez sur Placer tous les certificats dans le magasin suivant.4. Cliquez sur Parcourir, Organismes de certification des sources sûres, puis sur

Suivant.5. Cliquez sur Terminer.

Messages d'erreur numérotés de Cognos OfficeLes messages d'erreur suivants peuvent s'afficher dans une boîte de dialogue etsont enregistrés dans le journal IBM Cognos Office.

COI-ERR-2002 Type de bloc non valideUne erreur de traitement interne est survenue. L'objet bloc n'a pas pu être traité.

Contactez le centre de support technique IBM Cognos Resource Center. Ayez àdisposition tous les journaux et détails nécessaires concernant cette erreur.

COI-ERR-2003 Type inattendu : blocs superposésUne erreur de traitement interne est survenue. L'objet de données était de typeinattendu et n'a pas pu être traité.


COI-ERR-2005 Cette version de Microsoft Office n'est pas priseen charge.IBM Cognos Office prend uniquement en charge certaines versions spécifiques desapplications Microsoft Office.

Chargez le contenu du rapport dans une des applications et dans un desenvironnements pris en charge.

Pour consulter la liste à jour des environnements pris en charge par les produitsIBM Cognos Office, incluant les systèmes d'exploitation, les correctifs, lesnavigateurs, les serveurs Web, d'annuaire, de base de données et d'applications,visitez le portail de support IBM pour IBM Cognos Analysis for Microsoft Excel oule portail de support IBM pour IBM Cognos for Microsoft Office.

COI-ERR-2006 Ce produit Microsoft Office n'est pas pris enchargeIBM Cognos Office prend uniquement en charge des applications Microsoft Officespécifiques, telles que Microsoft Excel, Microsoft Word et Microsoft PowerPoint.Vous ne pouvez pas télécharger les documents IBM Cognos Office dans une autreapplication Microsoft Office, par exemple Microsoft Access, même si une extensionpermet l'interopérabilité entre ces applications.


https://www.ibm.com/support/entry/portal/product/cognos/cognos_analysis_for_microsoft_excel?productContext=-1540149255

https://www.ibm.com/support/entry/portal/product/cognos/cognos_for_microsoft_office?productContext=582901819

Chargez le contenu du rapport dans une des applications et dans un desenvironnements pris en charge.

Pour consulter la liste à jour des environnements pris en charge par les produitsIBM Cognos Office, incluant les systèmes d'exploitation, les correctifs, lesnavigateurs, les serveurs Web, d'annuaire, de base de données et d'applications,visitez le portail de support IBM pour IBM Cognos Analysis for Microsoft Excel oule portail de support IBM pour IBM Cognos for Microsoft Office.

COI-ERR-2008 Extraction à partir des ressources impossible.Tentative d'extraction de '{0}'.Une erreur de traitement interne est survenue.


COI-ERR-2009 Impossible d'effectuer cette opération, carMicrosoft Excel est en mode d'édition.Le contenu du rapport ne peut pas être actualisé lorsque l'une des cellules duclasseur est en cours d'édition.

Cliquez à l'extérieur de la cellule active pour quitter le mode d'édition et essayezde nouveau.

COI-ERR-2010 Le nom {0} n'est pas valide. Un nom ne peut pascontenir à la fois des guillemets (") et une apostrophe (')Lorsque vous créez un dossier, renommez un dossier ou publiez un document, lenom peut contenir soit une apostrophe, soit des guillemets, mais pas les deux à lafois.

Pour résoudre ce problème, renommez le dossier ou le document. Supprimezl'apostrophe ou les guillemets du nom.

COI-ERR-2013 Impossible de charger les métadonnéesIl est possible que vous ne puissiez pas charger les métadonnées parce que vous nedisposez pas des droits d'accès sécurisé à tous les éléments ou parce que leséléments ont été supprimés du serveur ou modifiés.

Assurez-vous que vous disposez des droits d'accès sécurisé à tous les éléments quevous essayez d'afficher. Si le problème persiste, vérifiez que les informations sur leserveur et sur le pack sont correctes et que tous les éléments supprimés de la basede données source sont également supprimés de la feuille de calcul.

COI-ERR-2015 Un problème est survenu lors de l'analysesyntaxique de la réponse du serveur à encodage MIME. Larecherche de la limite [{0}] a trouvé la limite [{1}] à la place.Une erreur s'est produite lorsque vous avez utilisé l'option de compression GZip,qui permet de compresser les données extraites du serveur. Les codes dedécompression des données sont manquants ou ne sont pas reconnus par IBMCognos Office.

Désactivez la compression. Bien que la compression soit activée par défaut, vouspouvez la désactiver en définissant la propriété UseGzipCompression sur falsedans le fichier CommManagerSettings.xml, qui se trouve par défaut dans lerépertoire Office Connection, par exemple, C:\Documents and Settings\nom


https://www.ibm.com/support/entry/portal/product/cognos/cognos_analysis_for_microsoft_excel?productContext=-1540149255

https://www.ibm.com/support/entry/portal/product/cognos/cognos_for_microsoft_office?productContext=582901819

d'utilisateur\Local Settings\Application Data\Cognos\Office Connection ouC:\Utilisateurs\nom d'utilisateur\AppData\Local\Cognos\Office Connection.

Désactivez la compression si vous devez exécuter des tests ou traiter des incidents.

Pour activer la compression gzip, définissez l'attribut suivant :

<setting name="UseGzipCompression">False</setting>

COI-ERR-2016 Feuille de calcul protégée, les styles d'IBMCognos Styles ne peuvent pas être remplisSi la feuille de calcul est protégée, les styles d'IBM Cognos ne peuvent pas êtreappliqués.

Vous devez déprotéger la feuille de calcul pour que les styles puissent êtreappliqués lors d'une actualisation des données.

COI-ERR-2019 La connexion a échouéDans Planning Analytics for Microsoft Excel, lorsque vous essayez de vousconnecter à un serveur Planning Analytics, le message d'erreur suivant apparaît :

COI-ERR-2019 La connexion a échoué. La connexion a renvoyé une erreur. Vérifiezsi la chaîne de connexion, y compris le nom du serveur et le numéro du port,contient des erreurs.

Pour résoudre ce problème, vous devez configurer votre logiciel antivirus pourautoriser les connexions de Microsoft .NET Runtime et Microsoft Excel.

Messages d'erreur IBM Planning Analytics for Microsoft Excelnumérotés

Les messages d'erreur suivants peuvent s'afficher dans une boîte de dialogue etsont enregistrés dans le journal IBM Cognos Office.

COR-ERR-2004 La spécification de l'axe n'est pas valideUne anomalie empêche la spécification du classeur d'être générée.

Pour résoudre le problème, vous pouvez essayer l'une des opérations suivantes :v Cliquez sur Annuler.v Cliquez sur le bouton Effacer toutes les données.v Fermez le classeur et ouvrez-le à nouveau.

Le classeur devrait normalement à présent accepter les données de l'arborescencesource.

COR-ERR-2007 Erreur lors de l'extraction à partir desressources. Tentative d'extraction de '{0}'.Un état incorrect a été détecté pour la feuille d'exploration.

Contactez le centre de support technique IBM Cognos Resource Center.

COR-ERR-2009 Nom de formule incorrectLa formule COGNAME n'a pas été analysée correctement. Elle a peut-être étémodifiée manuellement et il est possible qu'il manque un argument.


Vérifiez la formule COGNAME de la cellule active afin de vous assurer qu'elleutilise le bon format ou, éventuellement, insérez le membre depuis l'arborescencesource.

COR-ERR-2010 Formule incorrecteCe message d'erreur s'affiche si un argument d'une formule COGNAME ouCOGVAL fait référence à une cellule et que celle-ci ne contient pas la formule dechaîne attendue.

Vérifiez la cellule et ses dépendances. Recherchez la mention #REF ou #VALUEdans la cellule. Le contenu de la cellule a peut-être été supprimé par erreur.

COR-ERR-2011 Plage non valide : Veuillez indiquer une plage detableau croisé ou de liste valideLa plage n'est pas valide ou figure hors de la plage du type de données.

Afin d'éviter cette restriction, limitez vos sélections de données.

COR-ERR-2013 L'exploration ne peut être convertie en analysebasée sur une formule car au moins un élément de contextecontient une sélectionLorsque la zone d'insertion Contexte contient plusieurs éléments, il est impossibled'afficher ces derniers dans les cellules de la feuille de calcul.

Supprimez une dimension de la zone d'insertion Contexte. Vous devez avoir unélément par dimension pour pouvoir convertir l'exploration en analyse basée surune formule.

COR-ERR-2014 Les résultats risquent d'être tronqués en raisondes restrictions des feuilles de calcul d'ExcelSi la quantité de données que vous recevez dépasse les nombres maximaux delignes et de colonnes de Microsoft Excel, le résultat est tronqué. Ce message vousinforme de cette troncation.

Afin d'éviter cette restriction, limitez vos sélections de données.

COR-ERR-2015 Impossible d'afficher l'exploration actuelle à cetemplacement de la feuille de calculL'exploration ne peut pas écrire les données hors des limites de la feuille de calculactive. L'exploration est trop large pour Microsoft Excel ou l'emplacement dedépart indiqué est trop proche de la limite.

Essayez de déplacer l'emplacement de départ. Si le problème persiste, essayez decréer une Vue d'exploration comportant moins de lignes ou de colonnes.

COR-ERR-2016 Impossible d'extraire le pack <Nom>Après avoir sélectionné un pack à l'aide de la boîte de dialogue Ouvrir un pack,une erreur est survenue lors de la tentative de téléchargement de ce pack à partirdu serveur.

Il s'agit d'une erreur interne.

Contactez le centre de support technique IBM Cognos Resource Center.


COR-ERR-2017 La sélection en cours n'a retourné aucunedonnéeLes sélections que vous avez réalisées dans l'arborescence n'ont généré aucunedonnée. La feuille d'exploration est supprimée ou rétablie à l'état précédent.

Pour afficher des éléments dans la feuille de calcul, vous devez sélectionner desobjets de l'arborescence source qui se croisent au niveau de points de données.


Chapitre 16. Installation des bases de données d'exemple deCognos TM1

Les exemples fournis par IBM Cognos TM1 illustrent les fonctions du produit,ainsi que les meilleures pratiques en termes techniques et professionnels. Vouspouvez également les utiliser pour vous familiariser avec le produit, pour les testset le traitement des incidents.

Présentation des exemples fournis par Cognos TM1

Les exemples Cognos TM1 sont disponibles pour différentes utilisations et sontoptimisés pour différents clients. Certains de ces exemples sont prêts à l'emploiimmédiatement après l'installation, alors que d'autres nécessitent des opérationssupplémentaires pour être utilisables. Par défaut, les exemples Cognos TM1 sontinstallés dans deux emplacements différents. S'ils sont sélectionnés dans l'assistantd'installation, les exemples suivants fournis avec le produit sont installés :

SData, Planning Sample, GO_New_Stores, GO_Scorecards, Proven_Techniques et24Retail

Ces exemples sont installés par défaut dans le répertoire répertoireTM1\samples\tm1.

SData et Planning Sample ont été spécialement conçus pour être utilisésavec Cognos TM1.

Pour les utiliser, il suffit de démarrer ces bases de données d'exemple dansCognos Configuration après l'installation.

GO_New_Stores et Proven_Techniques sont conçus pour mettre en évidenceles fonctions de Cognos TM1 Performance Modeler, de TM1 Applicationset de Cognos Insight.

L'exemple Proven_Techniques met en lumière les fonctions et les calculsdes cubes. Vous pouvez également importer plusieurs applications dans leportail, et les visualiser dans le mode connecté de Cognos Insight.

L'exemple GO_Scorecards contient des données qui sont optimisées pourune utilisation avec les fonctions de scorecard d'IBM Cognos présentesdans Cognos TM1 Performance Modeler.

L'exemple 24Retail représente une société fictive, intitulée 24Retail, quicommercialise des téléphones portables, des ordinateurs et autres appareils.Ses données peuvent être utilisées par Planning Analytics Workspace,Planning Analytics for Microsoft Excel, Architect et TM1 Web.

Pour en savoir davantage, reportez-vous à la section «Utilisation des basesde données d'exemple installées par défaut», à la page 212.

PData, Rules_Guide_Data et TI_Data

Ces exemples sont également conçus spécifiquement pour Cognos TM1,mais pour les utiliser, vous devez d'abord ajouter chaque serveur dansCognos Configuration, puis les démarrer individuellement. Ils sontinstallés dans le répertoire répertoire TM1\samples\tm1.

GO_Contributor.zip, sample_outdoiors.zip, advanced_techniques.zip,greatoutdoors.zip et GreatOutdoorsSales.zip


Ces exemples sont installés dans le répertoire répertoireTM1\webcontent\samples\datasources\cubes\amdtool.

Les exemples GreatOutdoorsSales.zip impliquent la restauration d'unebase de données, puis la connexion à cette base de données à l'aide d'unesource de données OLAP. Les fichiers de base de données sont installésavec les exemples, et sont compatibles avec IBM DB2, Microsoft SQLServer et les bases de données Oracle.

Le contenu des autres exemples est basé sur des fichiers .csv et aucunerestauration de base de données n'est nécessaire. Pour en savoir davantage,reportez-vous à la section «Utilisation des bases de données d'exempleGO_Contributor et Outdoors Company», à la page 213.

HumanResources.cdd, Orders.cdd et Training.cdd.Un ensemble d'exemples sous forme de .cdd et de données a été conçuspécialement pour une utilisation avec le générateur d'espace de travailCognos Insight. Ces exemples et leurs versions traduites sont disponiblesdans le répertoire installation TM1\webcontent\samples\datasources\cubes\amdtool\Source_files\desktop.

Sous UNIX, utilisez la commande ./startup_tm1s.sh pour démarrer les serveursde base de données d'exemple. Pour plus d'informations, voir «Démarrage d'unserveur UNIX TM1» et «Arrêt d'un serveur UNIX TM1» dans IBM Cognos TM1Operations.

Utilisation des bases de données d'exemple installées par défautLes bases de données d'exemple suivantes sont installées par défaut et peuventêtre lancées depuis Cognos Configuration


Ces bases de données sont installées par défaut à l'emplacement des bases dedonnées d'exemple.

Par exemple C:/Program Files/IBM/cognos/tm1/samples/tm1/SData

SData Données conçues pour une utilisation avec TM1.

Planning SampleDonnées conçues pour une utilisation avec les clients de planification.

GO_New_StoresDonnées conçues pour une utilisation avec TM1 Applications, CognosInsight et Cognos TM1 Performance Modeler.

GO_ScorecardsDonnées conçues pour une utilisation avec TM1 Scorecarding dans TM1Performance Modeler.

Proven_TechniquesCette base de données d'exemple utilise des calculs de cube et desfonctions introduites dans les éditions récentes. Cette base de données estégalement conçue pour être utilisée avec les fonctions de scorecard de TM1dans Cognos TM1 Performance Modeler.

Procédure1. Dans Cognos Configuration, cliquez avec le bouton droit sur la base de

données que vous voulez démarrer, puis sélectionnez Démarrer.


2. Pour ouvrir les bases de données, dans TM1 Architect ou TM1 PerformanceModeler, cliquez deux fois sur la base de données et utiliser le nom d'utilisateuradmin et le mot de passe apple par défaut.

Utilisation des bases de données d'exemple GO_Contributor etOutdoors Company

Les exemples GO_Contributor et Outdoors Company sont installés sous la formede fichiers .zip que vous devez décompresser pour les utiliser.

Procédure1. Sur l'ordinateur sur lequel vous avez installé le composant serveur TM1,

accédez au dossier répertoire TM1\webcontent\samples\datasources\cubes\amdtool.

2. Décompressez le contenu du fichier GO_Contributor.zip ouOutdoors_Company.zip. Vous devez décompresser les fichiers dans un répertoireproche du répertoire racine, par exemple c:, pour que le chemin ne soit pastrop long.

3. Dans le dossier dans lequel vous avez extrait le fichier, accédez au dossier DataFiles, et ouvrez le fichier tm1s.cfg dans un éditeur de texte.a. Vérifiez que les paramètres DatabaseDirectory, LoggingDirectory et

DistributedPlanningOutputDir correspondent bien au chemin du répertoireData Files dans lequel vous avez décompressé les fichiersGo_Contributor.zip et Outdoors_Company.zip.

b. Enregistrez et fermez les fichiers.4. Ouvrez IBM Cognos Configuration.5. Dans le panneau Explorateur, sous Accès aux données, cliquez avec le bouton

droit sur TM1 Server, et cliquez sur Nouvelle ressource > Instances de TM1Server.a. Dans la zone Nom, entrez GO Contributor ou Outdoor Company.b. Comme chemin de configuration du serveur TM1, entrez le chemin du

dossier Data Files dans lequel vous avez décompressé les fichiers.Par exemple, répertoire_tm1\samples\GO_Contributor

c. Dans le panneau Explorateur, cliquez avec le bouton droit de la souris surGO Contributor ou Outdoor Company et cliquez sur Démarrer.

6. Vérifiez que les nouveaux serveurs sont disponibles pour Architect.a. Ouvrez Architect.b. Cliquez deux fois sur le serveur.c. Dans la zone Connexion au serveur, entrez admin dans la zone Nom

d'utilisateur et apple dans la zone Mot de passe.7. Pour tester la disponibilité des nouveaux serveurs dans le portail IBM Cognos

Applications :a. Ouvrez le portail en entrant : http://server_name:9510/pmpsvc.b. Cliquez sur l'icône Administrer IBM Cognos TM1 Applications.c. Sous Nom des serveurs, cliquez sur Ajouter.d. Entrez le nom du serveur dans Hôte Admin, puis cliquez sur le bouton

Actualiser.e. Sélectionnez l'exemple que vous venez d'ajouter, puis cliquez sur OK.

Chapitre 16. Installation des bases de données d'exemple de Cognos TM1 213

Utilisation des exemples de serveur Ventes Vacances etAventure avec la base de données d'exemple

L'exemple Ventes Vacances et Aventure utilise des données provenant d'une basede données. Pour utiliser cet exemple, vous devez restaurer la base de données,créer une connexion ODBC à celle-ci, puis ajouter le modèle de serveur à votresystème.

La base de données est compatible avec IBM DB2, Microsoft SQL Server, et Oracle.

La base de données d'exemple et le serveur Cognos TM1 qui l'utilise sont installésavec Cognos TM1 Server dans le dossier répertoire TM1/webcontent/samples/datasources.

Lorsque vous créez votre connexion ODBC, utilisez GOSALESDW comme nom desource de données. Sur les systèmes d'exploitation Microsoft Windows, créez laconnexion ODBC en tant que DSN système.

Restauration des fichiers de sauvegarde pour IBM DB2Utilisez le script fourni pour restaurer les bases de données d'exemple sur IBMDB2.

Pour configurer la base de données d'exemples, vous devez extraire le fichier GS_DBtar.gz, personnaliser un fichier de configuration, puis exécuter le script deconfiguration.

Procédure1. Accédez au dossier répertoire TM1/webcontent/samples/datasources.2. Procédez à l'extraction du fichier GS_DB.tar.gz et conservez la structure des

répertoires d'origine.Si vous utilisez WinZip pour extraire le fichier GS_DB.tar.gz sur un systèmeMicrosoft Windows, vérifiez que l'option TAR file smart CR/LF conversionn'est pas sélectionnée.

3. Sur les systèmes d'exploitation Linux et UNIX, modifiez les droits d'accès aufichier setupGSDB.sh de sorte qu'il soit exécutable.Par exemple,chmod u+x setupGSDB.sh

4. Si vous souhaitez modifier le fichier de configuration de l'exemple pour qu'ilutilise des paramètres autres que les valeurs par défaut, éditez le fichierGOSalesConfig.Le fichier de configuration sur Windows est GOSalesConfig.bat. Le fichier deconfiguration sur Linux et UNIX est GOSalesConfig.sh.Le fichier de configuration GOSalesConfig contient les options de configurationpar défaut utilisées lors de la création de la base de données GOSALES. Lesparamètres de configuration par défaut sont répertoriés dans le tableau suivant.

Tableau 22. Paramètres de configuration par défaut pour les données GOSALES

Paramètre de configuration Valeur par défaut Description

GOSALES_INST GS_DB Définit le nom ou l'alias dela base de données.


Tableau 22. Paramètres de configuration par défaut pour les données GOSALES (suite)


GOSALES_CREATEDB Facultatif : Entraîne lasuppression d'une base dedonnées existante portant unnom identique.

GOSALES_DB_TERRITORY US Lors de la création d'unebase de données, il s'agit duterritoire de la base dedonnées UTF-8 qui est créée.

GOSALES_BP

GOSALES_TS

GOSALES_BP

GOSALES_TS

Facultatif : Saisissez le nomdu groupe de mémoiretampon et de l'espace detable, si ceux-ci doivent êtrecréés par le script.

GOSALES_GRANTEES GOSALES, DB2ADMIN Saisissez la liste desutilisateurs, des groupes oudu PUBLIC titulaire desdroits CONTROL sur lesschémas GOSALES,GOSALESHR, GOSALESMRet GOSALESRT. Cette chaînedoit être conforme à lasyntaxe de la commandeGRANT.

GOSALESDW_GRANTEES GOSALESDW

DB2ADMIN

Saisissez la liste desutilisateurs, des groupes oudu PUBLIC titulaire desdroits CONTROL sur leschéma GOSALESDW.

GOSALES_DPF N Sélectionnez la valeur 'Y' encas d'installation dans unenvironnement de base dedonnées partitionné (DPF)

GOSALES_SCHEMA

GOSALESHR_SCHEMA

GOSALESMR_SCHEMA

GOSALESRT_SCHEMA

GOSALESDW_SCHEMA

GOSALES

GOSALESHR

GOSALESMR

GOSALESRT

GOSALESDW

Saisissez les noms utiliséspour chaque schéma.

Par défaut, le nom de base de données GS_DB est utilisé et les droits sontaccordés aux utilisateurs DB2ADMIN (Linux, UNIX, Windows) et GOSALES.

5. Pour exécuter le script setupGSDB en mode interactif, exécutez la commandesuivante :v Sur les ordinateurs Windows, dans une fenêtre de commande IBM DB2,

accédez au répertoire GS_DB\win et exécutez le script setupGSDB.bat.v Sur les ordinateurs UNIX, dans une invite shell, placez db2profile dans le

répertoire GS_DB/unix, puis exécutez le script setupGSDB.sh.Le script affiche un récapitulatif de vos choix avant que vous ne validiez lesmodifications dans votre environnement. Si vous approuvez les choix, appuyezsur Entrée.


6. Pour exécuter le script setupGSDB depuis la ligne de commande, exécutez lacommande suivante :v Sur les ordinateurs Windows, exécutez le script setupGSDB.bat.v Sur les ordinateurs UNIX, exécutez le script setupGSDB.sh.Vous pouvez exécuter le script setupGSDB en indiquant les options ci-dessous :

Option Description

-createdb Crée la base de données. Cette optionentraîne la suppression d'une base dedonnées existante portant un nom identique.Elle crée le groupe de mémoire tampon etl'espace de table requis.

-database nom_base_de_données Indique le nom de la base de données. Cettevaleur remplace la valeur par défaut GS_DB.

-userid ID_utilisateur_administration Spécifie le nom de l'ID d'administrateur DB2servant à créer la base de données.

-password ID_utilisateur_administration Indique le mot de passe de l'IDd'administrateur DB2.

-noprompt Indique qu'aucune invite ne sera affichée.Cette option exécute le script en modesilencieux. Toute information manquanteprovoque l'échec de l'exécution du script.Aucune confirmation ne vous serademandée.

Par exemple, si vous êtes un administrateur IBM DB2 et vous souhaitez créer labase de données par défaut GS_DB sur le noeud local, utilisez la commandesuivante :setupGSDB -createDB -noprompt

Si vous souhaitez créer les tables dans une base de données existante appeléeSAMPLE en utilisant l'ID d'administrateur db2admin, utilisez la commandesuivante :setupGSDB -database SAMPLE -userid db2admin

Le script vous invite à saisir le mot de passe lors de la connexion à la base dedonnées. Le script remplace toutes les tables déjà existantes dans la base dedonnées, sauf si vous choisissez de supprimer la base de données.

7. Si la base de données d'exemples GS_DB est installée sur un serveur distantdans votre environnement, vous pouvez vous y connecter en cataloguant labase de données distante sur votre ordinateur local, puis en exécutant le scriptd'installation localement.a. Si la base de données d'exemples n'existe pas encore sur le serveur distant,

créez-la avec la commande CREATE DATABASE.La base de données requiert le jeu de caractères UTF-8 ainsi qu'un espacede table par défaut ayant une taille de pagination de 16 Ko ou supérieure.Par exemple, sur le serveur distant, créez la base de données en exécutant lacommande suivante :CREATEDATABASE GS_DB USING CODESET UTF-8 TERRITORY US PAGESIZE 16k

b. Sur votre ordinateur local, cataloguez la base de données distante enutilisant la commande suivante :db2catalog tcpip node nodename remote ipaddr server port_numberdb2 catalog database GS_DB as GS_DB at node nodename


c. Sur votre ordinateur local, exécutez la commande suivante :setupGSDB -database GS_DB -userid administration_user_ID

Vous êtes invité à indiquer un mot de passe pour vous connecter à la basede données.

Restauration des fichiers de sauvegarde pour OracleUtilisez les scripts qui sont installés avec TM1 pour restaurer rapidement etfacilement les fichiers de sauvegarde des bases de données d'exemple dans Oracle.


Pour configurer la base de données d'exemples, vous devez extraire le fichierGS_DB_ORA.tar.gz,, personnaliser un fichier de configuration, puis exécuter lescript de configuration.

Procédure1. Accédez au répertoire répertoire TM1/webcontent/samples/datasources.2. Décompressez le fichier GS_DB_ORA.tar.gz et conservez la structure des

répertoires d'origine.3. Sur les systèmes d'exploitation Linux et UNIX, modifiez les droits d'accès au

fichier setupGSDB.sh de sorte qu'il soit exécutable :chmod u+x setupGSDB.sh

4. Assurez-vous que l'ID utilisateur servant à configurer la base de donnéesOracle dispose des droits appropriés pour créer des utilisateurs et exécuterl'utilitaire d'importation.

5. Facultatif - Si vous souhaitez modifier le fichier de configuration de l'exemplepour qu'il utilise des paramètres autres que les valeurs par défaut, éditez lefichier GOSalesConfig.Le fichier de configuration sur Windows est GOSalesConfig.bat. Le fichier deconfiguration sur UNIX est GOSalesConfig.sh.Le fichier de configuration GOSalesConfig contient les options de configurationpar défaut utilisées lors de la création de la base de données GOSALES. Lesparamètres de configuration par défaut sont répertoriés dans le tableau suivant.

Tableau 23. Paramètres de configuration par défaut pour les données GOSALES


GOSALES_IMP_CMD imp Peut être modifié sinécessaire pour indiquer lechemin d'accès complet à laversion correcte del'utilitaire d'importation.

GOSALES_INST Chaîne de l'hôte Oracle.

GOSALES_TS GOSALES_TS Si des utilisateurs sontcréés au moyen de scripts,sert à saisir le nom del'espace de table à assigneraux utilisateurs.

GOSALES_CREATE_TS Facultatif : Utilisé pourcréer l'espace de table pardéfaut pour les utilisateurs.




GOSALES_TEMP_TS Si des utilisateurs sontcréés au moyen de scripts,sert à nommer un espacede table temporaire àassigner aux utilisateurs.N'indiquez aucune valeurpour utiliser l'espace detable temporaire pardéfaut.

GOSALES_SCHEMA

GOSALES_SCHEMA_PW

GOSALES

GOSALESPW

Permet de saisir le nomd'utilisateur et le mot depasse de l'utilisateurGOSALES. Vous êtes invitéà saisir un mot de passe sicelui-ci n'a pas été indiqué.

GOSALESHR_SCHEMA

GOSALESHR_SCHEMA_PW

GOSALESHR

GOSALESHRPW

Permet de saisir le nomd'utilisateur et le mot depasse de l'utilisateurGOSALESHR. Vous êtesinvité à saisir un mot depasse si celui-ci n'a pas étéindiqué.

GOSALESMR_SCHEMA

GOSALESMR_SCHEMA_PW

GOSALESMR

GOSALESMRPW

Permet de saisir le nomd'utilisateur et le mot depasse de l'utilisateurGOSALESMR. Vous êtesinvité à saisir un mot depasse si celui-ci n'a pas étéindiqué.

GOSALESSRT_SCHEMA

GOSALESRT_SCHEMA_PW

GOSALESRT

GOSALESRTPW

Permet de saisir le nomd'utilisateur et le mot depasse de l'utilisateurGOSALESRT. Vous êtesinvité à saisir un mot depasse si celui-ci n'a pas étéindiqué.

GOSALESDW_SCHEMA

GOSALESDW_SCHEMA_PW

GOSALESDW

GOSALESDWPW

Permet de saisir le nomd'utilisateur et le mot depasse de l'utilisateurGOSALESDW. Vous êtesinvité à saisir un mot depasse si celui-ci n'a pas étéindiqué.




GOSALES_GRANTEES GOSALES Utilisé pour indiquer lesutilisateurs qui disposerontdes droits SELECT,INSERT, DELETE, UPDATEet ALTER pour les schémasGOSALES, GOSALESHR,GOSALESMR etGOSALESRT.

Remarque : Le propriétairede GOSALES_SCHEMA esttoujours titulaire desprivilèges SELECT,INSERT, DELETE, UPDATEet ALTER sur tous lesschémas.

GOSALESDW_GRANTEES GOSALESDW Utilisé pour indiquer lesutilisateurs qui disposerontdes droits SELECT,INSERT, DELETE, UPDATEet ALTER pour le schémaGOSALESDW.

6. Pour exécuter le script setupGSDB en mode interactif, exécutez la commandesuivante :v Sous Windows, dans une fenêtre de commande DOS, accédez au répertoire

GS_DB_ORA\win et exécutez le script setupGSDB.bat.v Sous UNIX, dans une invite shell, accédez au répertoire GS_DB_ORA/unix, puis

exécutez le script setupGSDB.sh.Appuyez sur Entrée pour continuer. Le script affiche un récapitulatif de voschoix avant que vous ne validiez les modifications dans votre environnement.Si vous approuvez les choix, appuyez sur Entrée pour que le script applique lesmodifications.

7. Pour exécuter le script setupGSDB depuis la ligne de commande, exécutez lacommande suivante :v Sur les ordinateurs Windows, exécutez le script setupGSDB.bat.v Sur les ordinateurs UNIX, exécutez le script setupGSDB.sh.Vous pouvez exécuter le script setupGSDB en indiquant les options ci-dessous :

Option Description

-createdb Crée la base de données. Cette optionentraîne la suppression d'une base dedonnées existante portant un nom identique.Elle crée le groupe de mémoire tampon etl'espace de table requis.

-database nom_base_de_données Indique le nom de la base de données. Cettevaleur remplace la valeur par défaut GS_DB.

-userid ID_utilisateur_administration Spécifie le nom de l'ID d'administrateur DB2servant à créer la base de données.

-password ID_utilisateur_administration Indique le mot de passe de l'IDd'administrateur DB2.


Option Description

-noprompt Indique qu'aucune invite ne sera affichée.Cette option exécute le script en modesilencieux. Toute information manquanteprovoque l'échec de l'exécution du script.Aucune confirmation ne vous serademandée.

Par exemple, si vous êtes un administrateur Oracle et vous souhaitez créer lesschémas de la base de données d'exemples par défaut, utilisez la commandesuivante :setupGSDB -createDB -noprompt

Vous souhaitez créer les tables dans les schémas existants indiqués dans lefichier de configuration en utilisant l'ID d'administrateur '"ys", utilisez lacommande suivante :setupGSDB -YourOracleInstance-userid sys -sysdba

Le script vous invite à saisir le mot de passe lors de la connexion à l'instanceOracle. Le script supprime toutes les tables ou vues existantes dans les schémasspécifiés et les remplace.

Restauration des fichiers de sauvegarde de Microsoft SQLServerUtilisez l'outil de gestion de base de données Microsoft SQL Server pour restaurerrapidement et facilement les fichiers de sauvegarde des bases de donnéesd'exemple.

Procédure1. Sur l'ordinateur sur lequel vous avez installé le serveur TM1, accédez au

répertoire suivant :répertoire TM1/webcontent/samples/datasource/Source files/sqlserver

2. Au besoin, copiez les fichiers de sauvegarde des exemples de bases de donnéesvers le répertoire de sauvegarde de base de données.

3. Restaurez la base de données à partir d'un périphérique et assurez-vous que lesemplacements de restauration sont adéquats pour les fichiers de base dedonnées .ldf et .mdf.

4. Créez au moins un utilisateur disposant de droits de sélection sur toutes lestables des bases de données restaurées.

Installation de l'exemple Ventes Vacances et AventureL'exemple Ventes Vacances et Aventure utilise des données provenant de la base dedonnées que vous avez restaurée.

Procédure1. Créez une connexion de source de données ODBC à la base de données

restaurée.Utilisez GOSALESDW comme nom de source de données. Sur les systèmesd'exploitation Windows, créez la connexion ODBC en tant que DSN système.

2. Sur l'ordinateur sur lequel vous avez installé le composant serveur TM1,accédez au dossier répertoire TM1\webcontent\samples\datasources\cubes\amdtool.

3. Décompressez le contenu du fichier GreatOutdoorsSales.zip. Vous devezdécompresser les fichiers dans un répertoire proche du répertoire racine, parexemple c:, pour que le chemin ne soit pas trop long.


4. Dans le dossier dans lequel vous avez extrait le fichier GreatOutdoorsSales.zip,accédez au dossier DataFiles, et ouvrez le fichier tm1s.cfg dans un éditeur detexte.a. Vérifiez que les paramètres DatabaseDirectory et LoggingDirectory

correspondent bien au chemin du répertoire dans lequel vous avezdécompressé le fichier GreatOutdoorsSales.zip.

b. Enregistrez et fermez le fichier.5. Ouvrez IBM Cognos Configuration.6. Dans le panneau Explorateur, sous Accès aux données, cliquez avec le bouton

droit sur TM1 Server, et cliquez sur Nouvelle ressource > Instances de TM1Server.a. Dans la zone Nom, entrez GreatOutdoorsSales.b. Comme chemin de configuration du serveur TM1, entrez le chemin du

dossier DataFiles dans lequel vous avez extrait le fichierGreatOutdoorsSales.zip.Par exemple, répertoire_TM1\webcontent\samples\datasources\cubes\amdtool\GreatOutdoorsSales\DataFiles

c. Dans le panneau Explorateur, cliquez avec le bouton droit de la souris surGreatOutdoorSales et cliquez sur Démarrer.

7. Vérifiez que le nouveau serveur GreatOutdoorsSales est disponible pourArchitect.a. Ouvrez Architect.b. Cliquez deux fois sur le serveur GreatOutdoorsSales.c. Dans la zone Connexion au serveur, entrez admin dans la zone Nom

d'utilisateur et apple dans la zone Mot de passe.8. Vérifiez que le nouveau serveur GreatOutdoorsSales est disponible dans le

portail des applications IBM Cognos.a. Ouvrez le portail en entrant : http://server_name:9510/pmpsvc.b. Cliquez sur l'icône Administrer une application IBM Cognos située à

l'extrémité droite du portail.c. Sous Nom des serveurs, cliquez sur Ajouter.d. Entrez le nom du serveur dans Hôte Admin, puis cliquez sur le bouton

Actualiser.e. Sélectionnez l'exemple GreatOutdoorsSales que vous venez d'ajouter, puis

cliquez sur OK.


Chapitre 17. Installation des outils Cognos TM1

Un ensemble d'outils et d'utilitaires Cognos sont installés lorsque le composantNiveau de données TM1 > Outils TM1 est sélectionné au cours de l'installation.

Ces outils sont des composants facultatifs que vous pouvez choisir de ne pasinstaller en désélectionnant la case à cocher du composant Outils TM1 au cours del'installation. Ces outils sont installés dans <emplacement_TM1>/bin.

Les outils installés dans ce groupe comprennent :

TM1RunTITM1RunTI est une interface de ligne de commande qui peut lancer unprocessus TM1 TurboIntegrator (TI) depuis toute application capabled'émettre des commandes de système d'exploitation.

Répertoire : <répertoire TM1>/bin

Nom de fichier : tm1runti.exe

Reportez-vous au chapitre «Edition des procédures avancées» dudocument TM1 TurboIntegrator.

tm1xferL'utilitaire tm1xfer compresse et déplace les objets serveur IBM CognosTM1 d'une plateforme à une autre, tout en conservant les noms d'objets encasse mixte à la fois sur les plateformes Microsoft Windows et UNIX.

Répertoire : <répertoire TM1>/bin

Nom de fichier : tm1xfer.cmd et tm1xfer.jar

Reportez-vous au chapitre «Outils et utilitaires» du document TM1Operations.

D'autres outils sont disponibles pour Cognos TM1 :

Cognos TM1 Operations ConsoleCognos TM1 Operations Console peut superviser plusieurs serveurs TM1et fournit des fonctionnalités de formatage étendues pour les fichiersjournaux. Cognos TM1 Operations Console a son propre composant, quipeut être sélectionnée dans l'installation. Reportez-vous au chapitre«Utilisation d'IBM Cognos TM1 Operations Console» du document TM1Operations pour des détails.

TM1TopTM1 Top supervise une seul serveur Cognos TM1. Installé par défaut.Reportez-vous au chapitre relatif aux «performances et à la surveillance dusystème» du document TM1 Operations pour des détails.

odbc_testL'outil odbc_test permet de diagnostiquer et tester une connexion ODBCIBM Cognos TM1 sous UNIX. Reportez-vous au chapitre «Outils etutilitaires» du document TM1 Operations pour des détails.


Chapitre 18. Configuration de la sécurité

Après l'installation d'IBM Cognos TM1, vous pouvez configurer les modesspécifiques d'authentification et de sécurité à utiliser.

Cette section décrit l'authentification et la sécurité de la transmission des données,qui font partie du processus global de configuration et d'installation. Lesopérations concernant la sécurité des utilisateurs, des groupes et des objets sontgénéralement réalisées après le processus d'installation et de configuration initial etsont décrites dans un document distinct.

Sécurité authentifiée

L'une des tâches de configuration des paramètres de l'authentification ou de lasécurité de la connexion consiste à sélectionner le type de sécurité qui vacommander l'accès des utilisateurs aux différents composants Cognos TM1 lors dela connexion.

Sécurité de la transmission des données

La configuration de la sécurité inclut la configuration facultative de l'utilisation deSSL dans Cognos TM1 pour sécuriser les transmissions de données.

Sécurité des utilisateurs et des groupes

Cognos TM1 gère la sécurité en organisant les utilisateurs TM1 en groupes. TM1comprend un ensemble de trois groupes d'administration prédéfinis et vous permetégalement de créer vos propres groupes personnalisés. Les utilisateurs peuventappartenir à un ou plusieurs groupes.

Pour obtenir des informations sur la configuration de la sécurité des utilisateurs etdes groupes, consultez le document IBM Cognos TM1 Operations.

Sécurité des objets

La sécurité des objets constitue un niveau supplémentaire de la sécurité de CognosTM1. Ce type de sécurité permet de contrôler l'accès à des objets TM1 spécifiquesde votre modèle de données, mais il n'est pas configuré pendant le processusinitial d'installation et de configuration.

Pour plus d'informations sur les procédures requises pour définir la sécurité desobjets Cognos TM1, voir IBM Cognos TM1 Developer.

Sécurité authentifiéeL'une des tâches de configuration des paramètres de l'authentification ou de lasécurité de la connexion consiste à sélectionner le type de sécurité qui vacommander l'accès des utilisateurs aux différents composants IBM Cognos TM1lors de la connexion.


Présentation de l'authentificationVous pouvez configurer le serveur IBM Cognos TM1 afin qu'il utilise un moded'authentification spécifique pour contrôler l'accès des noms de connexion.

Par défaut, lorsque vous installez le serveur Cognos TM1, celui-ci est configurépour utiliser l'authentification standard de Cognos TM1.

Après l'installation du serveur Cognos TM1, vous pouvez changer la méthoded'authentification en modifiant les paramètres dans les fichiers de configuration deTM1.

Tableau 24. Méthodes d'authentification du serveur Cognos TM1

Méthodesd'authentification Description

Authentification TM1 Le serveur Cognos TM1 vous demande un nom d'utilisateuret un mot de passe et vérifie ces informations de connexionen les comparant à celles du cube de sécurité.

Connexion intégrée Microsoft Windows procède à l'authentification de CognosTM1.

Authentification LDAP Le serveur Cognos TM1 vous demande un nom d'utilisateuret un mot de passe et vérifie ces informations de connexionen les comparant à celles d'un serveur LDAP externe.

Sécurité IBM Cognos Le serveur Cognos TM1 authentifie les utilisateurs à l'aide dela sécurité IBM Cognos.

Présentation de l'authentification standard de Cognos TM1Avec l'authentification IBM Cognos TM1, le serveur Cognos TM1 vérifie le nomd'utilisateur et le mot de passe en les comparant aux noms et aux mots de passefigurant dans la base de données Cognos TM1.

Présentation de la connexion intégréeAvec la connexion intégrée, IBM Cognos TM1 utilise l'authentification réseauMicrosoft Windows pour accéder à vos données Cognos TM1. Une fois connecté à

Figure 8. Processus d'authentification avec le serveur IBM Cognos TM1


un poste de travail Microsoft Windows, vous pouvez accéder à Cognos TM1 sansentrer à nouveau un nom d'utilisateur et un mot de passe.

La connexion intégrée est prise en charge sous Microsoft Windows uniquement.Vous ne pouvez pas utiliser la connexion intégrée pour accéder à un serveurCognos TM1 qui s'exécute sur un système d'exploitation UNIX.

Présentation de l'authentification LDAPAvec l'authentification LDAP, un service de sécurité LDAP externe à IBM CognosTM1 authentifie une connexion (à partir de Cognos TM1 version 8.2.2). Vouspouvez ajouter, modifier et supprimer des informations de sécurité utilisateur àpartir d'un emplacement unique : le serveur LDAP ou Microsoft Windows ActiveDirectory.

Figure 9. Processus d'authentification avec la connexion intégrée

Chapitre 18. Configuration de la sécurité 227

Sécurité CognosIBM Cognos TM1 Server peut authentifier les utilisateurs avec la sécurité IBMCognos.

La sécurité Cognos est un composant de la structure IBM Cognos qui gère l'accèsdes utilisateurs aux données. La sécurité Cognos gère les autorisations etl'authentification via des fournisseurs de sécurité tiers, tels que LDAP ou ActiveDirectory. Lorsqu'un utilisateur est authentifié par la sécurité Cognos, il reçoit un"passeport" de sécurité Cognos. Ce passeport est alors utilisé par les applicationsCognos TM1 pour déterminer les droits (rôle et affiliation à un groupe) et l'identitéde l'utilisateur.

Considérations relatives à la sécurité lors de l'utilisation deCognos TM1 ApplicationsVous pouvez choisir l'authentification de sécurité standard d'IBM Cognos TM1 oula sécurité IBM Cognos pour les serveurs Cognos TM1 utilisés avec Cognos TM1Applications.

N'utilisez pas des modes d'authentification de sécurité différents pour une mêmeinstallation de Cognos TM1 Applications.

Déterminez le mode de sécurité avant de configurer l'utilisation d'un serveurCognos TM1 dans Cognos TM1 Applications, et d'utiliser le même mode desécurité pour les serveurs que vous ajoutez.

Pour plus d'informations sur l'utilisation de la sécurité Cognos, reportez-vous à lasection «Utilisation de Cognos TM1 Applications avec la sécurité Cognos», à lapage 266.

Figure 10. Processus d'authentification avec LDAP


Utilisation du paramètre IntegratedSecurityMode avec Cognos TM1Applications

Pour définir le mode d'authentification de sécurité de Cognos TM1, utilisez leparamètre IntegratedSecurityMode dans le fichier Tm1s.cfg de chaque serveurCognos TM1 à utiliser.

Important : Le composant Cognos TM1 Applications est compatible uniquementavec les modes d'authentification de sécurité 1 et 5 de Cognos TM1.

Par exemple, pour utiliser l'authentification de sécurité standard de Cognos TM1,affectez la valeur 1 au paramètre IntegratedSecurityMode pour chaque serveur.


Pour utiliser la sécurité IBM Cognos, affectez la valeur 5 au paramètreIntegratedSecurityMode.


Pour plus d'informations sur le paramètre IntegratedSecurityMode, reportez-vous àla section relative à la configuration du système TM1 dans le document IBMCognos TM1 Operations.

Si le paramètre IntegratedSecurityMode=5 est utilisé pour IBM Cognos TM1Server et IBM Cognos TM1 Applications, il est impossible d'affecter des droits auxgroupes TM1 natifs dans la boîte de dialogue Gérer les droits. Seuls les groupesCognos importés dans le serveur TM1 sont disponibles. Cela signifie qu'il estimpossible d'utiliser des groupes TM1 et Cognos en parallèle car SecMode restreintles groupes utilisables.

Configuration de la sécurité de Cognos TM1 Applications en vue del'utilisation de plusieurs serveurs Cognos TM1

Si vous souhaitez exécuter plusieurs serveurs Cognos TM1 avec Cognos TM1Applications, ceux-ci doivent tous être configurés avec le même moded'authentification de sécurité (soit l'authentification standard de Cognos TM1, soitla sécurité Cognos). Ils doivent en outre avoir le même nom d'utilisateur et lemême mot de passe de connexion de l'administrateur.

Pour plus de détails, voir «Configuration de Cognos TM1 Application Web en vuede l'utilisation de plusieurs serveurs Cognos TM1», à la page 155.

Utilitaire ETLDAPL'utilitaire ETLDAP vous permet de transférer des informations de votre annuaireLDAP (Lightweight Directory Access Protocol) vers IBM Cognos TM1.

Vous pouvez utiliser ETLDAP pour ajouter des utilisateurs LDAP à Cognos TM1en cas d'utilisation de Cognos TM1 avec la connexion intégrée et l'authentificationLDAP.

Remarque : L'utilitaire ETLDAP vous permet uniquement d'ajouter de nouveauxutilisateurs LDAP à Cognos TM1. Il est impossible de modifier, mettre à jour ousupprimer des utilisateurs existants de Cognos TM1 avec ETLDAP.


L'outil de chargement LDAP ETLDAP offre les fonctionnalités suivantes :v Il extrait des informations utilisateur d'un serveur LDAP ou Active Directory.v Il crée l'élément UniqueID dans la dimension }ClientProperties.v Il ajoute des utilisateurs au cube }ClientProperties.v Il remplit la zone UniqueID du cube }ClientProperties à l'aide du nom qualifié

de domaine de l'utilisateur ajouté à la base de données IBM Cognos TM1. Parexemple, ETLDAP écrit le nom [email protected] dans le cube}ClientProperties.

En tant qu'administrateur de Cognos TM1, vous pouvez exécuter les tâchessuivantes à l'aide d'ETLDAP :v Ajout rapide de nombreux noms d'utilisateur d'un serveur LDAP à la base de

données Cognos TM1.v Migration des informations d'une base de données LDAP préexistante vers

Cognos TM1.v Exécution d'une ou de plusieurs requêtes pour spécifier les utilisateurs à créer

dans Cognos TM1, puis exportation des utilisateurs vers les cubes de sécuritéCognos TM1.

v Mise à jour de Cognos TM1 avec intégration des utilisateurs qui ont été ajoutésau serveur LDAP depuis le chargement initial des données dans Cognos TM1.

Remarque : l'utilitaire ETLDAP n'est pas disponible lorsque le serveur TM1Cognos est configuré en vue de l'utilisation de l'un des modes de sécurité intégréesuivants :v Mode de sécurité intégrée 3 - Connexion intégréev Mode de sécurité intégrée 5 - Authentification IBM Cognos Analytics

Pour plus d'informations, voir «IntegratedSecurityMode», à la page 332.

Modification des attributs LDAPla valeur d'un attribut extraite d'un annuaire LDAP ne correspond pas exactementà la valeur souhaitée dans le cube de sécurité IBM Cognos TM1.

Vous devez alors modifier certains attributs LDAP avant d'exécuter l'utilitaireETLDAP.

Vous pouvez par exemple combiner tous les utilisateurs des groupes LDAP R&D,Assurance qualité et Documentation en un groupe Cognos TM1 unique nomméIngénierie. Pour prendre en charge ces exigences, vous pouvez étendre une classeJava avec méthode unique que vous devez remplacer.

La classe stringFilter contient une méthode avec la signature suivante :String filterString(String attrName, String value)

A l'exécution, cette méthode reçoit le nom de chaque attribut LDAP correspondantà une entrée de mappage, ainsi que sa valeur. La chaîne renvoyée est ajoutée à labase de données Cognos TM1.

Le code suivant démontre l'implémentation de la classe stringFilter, qui combinetous les utilisateurs des groupes LDAP R&D, Assurance qualité et Documentationen un groupe Cognos TM1 unique nommé Ingénierie.


La classe stringFilter recherche des instances de l'attribut LDAP ou, qui représentela zone des noms de groupe Cognos TM1. Si la valeur est R&D, Assurance qualitéou Documentation, elle renvoie Ingénierie. Les utilisateurs des trois groupesLDAP sont ajoutés à un groupe Cognos TM1 unique nommé Ingénierie. La valeurdes autres groupes reste inchangée.// The stringFilter class provides the abilityto transformstrings

// which are read from the LDAP database before theyare inserted into // TM1’s datastore.

// To implement this feature, create a class which extendsstringFilter

// and contains a method ’filterString’ with the followingsignature:

//

// String filterString(String attrName, String value)

//

//

public class myStringFilter extends stringFilter

{

public String filterString(String attrName, String value)

{

if (attrName.equals("ou"))

{

if ( (attrName.equals("R&D")) ||

(attrName.equals("Quality Assurance")) ||

(attrName.equals("Documentation")) )

return "Engineering";

else

return value;

}

else

return value;

}

}

Après la rédaction et la compilation du code Java, placez la classe dans votrechemin Classpath. Puis cliquez sur Editer > Options et entrez son nom dans lazone Nom de classe.

Exécution d'ETLDAPVous pouvez exécuter ETLDAP depuis une fenêtre de commande MicrosoftWindows ou DOS, à l'aide de paramètres de ligne de commande.

Procédure1. Si vous souhaitez exécuter l'utilitaire ETLDAP depuis la fenêtre de commande

de Microsoft Windows, procédez comme suit :v Cliquez sur Démarrer > Tous les programmes > IBM Cognos > TM1 >

Administration > ETLDAP.v Définissez les éléments dont vous avez besoin.


Tableau 25. Eléments de la boîte de dialogue LDAP Load Tool (Outil de chargement LDAP).

Zone ou bouton Description

Search DN (Nom distinctde recherche) Affiche le noeud LDAP d'origine de la recherche. L'utilitaire

ETLDAP ne recherche pas d'entrées au-dessus de ce niveaud'arborescence.

Filter (Filtre)Affiche la chaîne de requête qui filtre les entrées dansl'annuaire et génère les enregistrements correspondants.

Attributes (Attributs)Affiche les valeurs d'attribut des entrées LDAP qui participentà la validation des enregistrements renvoyés par la recherche.Lorsque vous exportez les informations LDAP vers TM1,ETLDAP extrait les attributs nécessaires à la créationd'utilisateurs TM1 valides.

Remarque : Les attributs concernent l'affichage seulement.

Search Scope (Portée de larecherche) Spécifie le point de départ et le niveau de la recherche.

Sélectionnez One level (Un niveau) pour spécifier toutes lesentrées situées un niveau au-dessous du nom distinct derecherche de base, et non du nom distinct de base lui-même.Sélectionnez Sub-tree level (Niveau d'arborescencesecondaire) pour rechercher toutes les entrées situéesau-dessous du nom distinct de base, ce dernier étant inclus.

Results Table (Tableau desrésultats) Affiche les résultats de la recherche. Cliquez sur les en-têtes

de colonne pour trier les données, ou cliquez avec le boutondroit de la souris sur une ligne, et cliquez sur View Entry(Afficher l'entrée) pour examiner tous les attributs de cetteentrée.

Bouton Search (Rechercher)Exécute la recherche à l'aide des paramètres sélectionnés.

Bouton Export (Exporter)Exporte l'ensemble d'utilisateurs affiché vers TM1 d'après lesparamètres de la boîte de dialogue Options.

2. Si vous souhaitez exécuter l'utilitaire ETLDAP à partir de la fenêtre decommande DOS, procédez comme suit :v Cliquez sur Démarrer > Tous les programmes > Accessoires >Invite de

commande.v Entrez la ligne de commande suivante :

java etldap options

v Ajoutez les paramètres dont vous avez besoin.


Tableau 26. Paramètres de ligne de commande pris en charge


-f nom de fichier Transmet le nom d'un fichier de session enregistré afin decharger tous les paramètres de configuration d'une sessionprécédente.

Lorsque vous exécutez l'utilitaire ETLDAP en modeautomatique (traitement par lots), vous devez inclure le nomdu fichier de sauvegarde de session. Si ce fichier ne contientpas les mots de passe nécessaires à la connexion aux serveursLDAP et Cognos TM1, un message d'erreur est consigné dansle fichier journal et la session est interrompue.

-batch Exécute ETLDAP en mode ligne de commande sans interfaceutilisateur. Nécessite l'option -f.

-secure Lorsque vous exécutez l'utilitaire ETLDAP en mode detraitement par lots, la transmission de cet indicateur supprimetous les mots de passe du fichier de session référencé parl'indicateur -f après leur lecture.

Ce paramètre lit le fichier de sauvegarde en début de session,puis le réécrit en supprimant les mots de passe. En moded'utilisation normal, vous exécutez ETLDAP et indiquez lesmots de passe dans l'interface utilisateur. Vous quittez ensuiteETLDAP et exécutez la version de ligne de commande enajoutant l'option « -secure ». Les mots de passe ne sont ainsidisponibles que pendant la courte période d'initialisation del'utilitaire.

-help Affiche l'aide en ligne des paramètres de ligne de commande.

Configuration des paramètres de connexion LDAPVous pouvez configurer les paramètres de connexion LDAP

Procédure1. Dans la boîte de dialogue LDAP Load Tool, cliquez sur File > Connect.2. Entrez les données d'hôte et d'utilisateur suivantes.

Sous-fenêtre Zone Description

Host Info(Informationshôte)

Host (Hôte)Entrez le nom d'hôte ou l'adresse IP del'ordinateur d'exécution du serveur LDAP.

PortLe port d'exécution du serveur LDAP.Lorsqu'aucun port n'est spécifié, la valeur 636est utilisée. Cognos TM1 tente de se connecterà un serveur LDAP sur le port sécuriséspécifié. Si vous n'entrez pas de valeur pourLDAPPort, Cognos TM1 utilise par défaut leport 636.


Sous-fenêtre Zone Description

VersionETLDAP ignorera certainement le numéro deversion. La plupart des serveurs LDAPprennent en charge les connexions de typeversion 2 ou version 3. ETLDAP n'utiliseaucune des fonctionnalités spécifiques àchacune de ces versions.

Option SSLDétermine si la communication entre leserveur LDAP et ETLDAP s'effectue via uncanal chiffré sécurisé. Désactivez cette optionsauf si vous affichez des informationsprotégées sur un réseau non sécurisé.

Option Anonymous(Anonyme) La plupart des serveurs LDAP disposent

d'une couche de configuration de sécurité quivous oblige à vous authentifier en tantqu'utilisateur connu. Dans certains systèmes,les utilisateurs anonymes peuvent parcourirl'annuaire, sans pouvoir extraire le schéma.Dans d'autres, un utilisateur anonyme peutavoir accès à certaines zones non sécuriséesde l'annuaire.

User Info(Informationsutilisateur)

User DN (Nomdistinct d'utilisateur) Dans de nombreux cas, votre annuaire LDAP

empêche les utilisateurs anonymes d'accéderaux données ou de les modifier. Vous pouvezdonc avoir besoin d'un nom distinct (DN) etd'un mot de passe pour effectuer l'extractionde vos informations de sécurité LDAP.

Par exemple, le nom Norm Lodin peut faireréférence à une personne qui travaille àBlodget, Inc. Dans LDAP, elle a un nomdistinct (DN) qui la distingue de manièreunique des autres entités dans le réseau.

Norm peut entrer les informations suivantesdans la zone User Info (Informationsutilisateur) :

uid=nlodin, ou=People, o=Blodget.com

Password (Mot depasse) Entrez le mot de passe correspondant au nom

distinct d'utilisateur.

3. Pour savoir si la connexion a abouti, cliquez sur Test.4. Cliquez sur OK.

Vous avez établi une connexion avec le serveur LDAP à l'aide des paramètresspécifiés.

Création d'une requête LDAPUtilisez une requête LDAP pour ajouter des utilisateurs et des groupes LDAP àIBM Cognos TM1.


Avant de commencer

Une requête LDAP est constituée des principaux éléments suivants :v Search DN (Nom distinct de recherche) - Un annuaire LDAP est organisé en

arborescence, avec un noeud racine et un nombre de branches partant de cetteracine. Le nom distinct de recherche indique le noeud d'origine de la recherche.Les entrées au-dessus de ce niveau de l'arborescence sont inspectées. Vous devezindiquer le nom distinct de base correct pour obtenir les résultats souhaités.

v Filter (Filtre) - Chaîne de requête qui filtre les entrées de l'annuaire LDAP etgénère les enregistrements correspondants. Vous pouvez créer des filtrescomplexes en combinant les symboles suivants :& (ET)| (OU)! (NON)* caractère générique( ) parenthèses pour imbricationPour obtenir des instructions sur la création de chaînes de filtre LDAP,reportez-vous aux manuels et aux ressources en ligne LDAP, notamment à lanorme LDAP, RFC 2254, Représentation par chaîne des filtres de recherche LDAP.

v Scope (Portée) - Alors que le nom distinct de recherche spécifie le point dedépart de la recherche, l'attribut Scope indique le niveau de profondeur decelle-ci. Il existe deux niveaux de portée :One level (Un Niveau) - Spécifie que LDAP inspecte toutes les entrées situéesun niveau au-dessous du nom distinct de base, ce dernier étant exclu.Sub-Tree Level (Niveau d'arborescence secondaire) - Indique que LDAPinspecte tous les enregistrements à tous les niveaux, nom distinct de base inclus.Le diagramme suivant illustre l'effet du paramètre Scope sur une recherche.

v Attributes (Attributs) - Décrivent chaque entrée LDAP et ses valeurs. Inclut uneliste de valeurs séparées par des virgules à retourner pour les enregistrementscorrespondant à la chaîne de filtre. Il existe deux attributs LDAP :User attribute (Attribut utilisateur) - Vous ajoutez cet attribut à l'annuaireLDAP. Par exemple, cn ou mail.Operational attribute (Attribut opérationnel) - Le serveur LDAP crée et gère cetattribut. Par exemple, numSubordinates.Les attributs possibles d'une entrée sont les suivants :

Figure 11. Effet du paramètre Scope sur une recherche


Present with no value (Présent sans valeur)Present with one or more values (Présent avec une valeur au moins)Not present (Absent) Si un attribut est facultatif, il est possible qu'il n'existe paspour une entrée.

Remarque : Veillez à ne demander que les attributs nécessaires. Si vousdemandez tous les attributs, un ensemble important de résultats peut augmenterconsidérablement la durée du traitement sur le serveur LDAP et la mémoirerequise sur le serveur et le client.

Procédure1. Spécifiez le nom distinct de recherche, la chaîne de filtre, les attributs et la

portée de votre requête.2. Cliquez sur le bouton Rechercher.

La table contient une liste d'entrées, à moins qu'il existe des erreurs de syntaxe,ou si la chaîne de filtre ne correspond à aucun enregistrement de l'annuaire.

3. Examinez l'ensemble des résultats.v Comporte-t-il des noms que vous ne souhaitez pas inclure ?v Des entrées importantes sont-elles absentes ?v Devez-vous créer plusieurs requêtes pour capturer la liste des

enregistrements qui vous intéressent ?4. Modifiez la chaîne de filtre.5. Cliquez sur le bouton Rechercher.6. Examinez l'ensemble des résultats.7. Répétez les étapes 3 à 6 jusqu'à l'obtention d'une liste d'enregistrements

valables.8. Cliquez sur File (Fichier), Save As (Enregistrer sous) pour sauvegarder votre

requête LDAP dans un fichier texte.

Remarque : Vous pourrez l'utiliser ultérieurement. Pour cela, cliquez sur File >Open dans la boîte de dialogue LDAP Load Tool (Outil de chargement LDAP).ETLDAP spécifie le nom distinct de recherche, la chaîne de filtre, les attributs etla portée de votre requête.

Connexion à Cognos TM1 ServerProcédez comme suit pour vous connecter à IBM Cognos TM1 Server.

Procédure1. Cliquez sur Edit (Editer) > Login (Connexion) > TM1.2. Saisissez les informations de serveur suivantes :

Zone Description

HôteNom de la machine du serveur où s'exécute votre serveurd'administration TM1.

Port SSLEntrez le numéro de port que le serveur admin utilisera. Lavaleur par défaut est 5498.


Zone Description

ServeurNom du serveur TM1 auquel vous souhaitez vous connecter.

Cliquez sur Serveur, puis sur le bouton Parcourir poursélectionner un serveur dans la liste.

Nom d'utilisateurNom d'un utilisateur disposant des privilèges admin sur leserveur TM1 cible.

Mot de passeMot de passe de l'utilisateur Admin.

3. Pour savoir si la connexion a abouti, cliquez sur Test.4. Cliquez sur OK.

Mappage d'attributs LDAP à des zones Cognos TM1Les annuaires LDAP contiennent de nombreux attributs ; vous pouvez ennormaliser certains, et en ajouter ou en personnaliser d'autres pour votreenvironnement. Vous devez spécifier manuellement la relation entre les attributsLDAP et les zones IBM Cognos TM1 requises.

Avant de commencer

Vous devez connaître votre schéma LDAP.

Procédure1. Cliquez sur Editer > Mappage > TM1.2. Pour chaque zone Cognos TM1 obligatoire (en rouge), sélectionnez un attribut

de schéma LDAP.Pour chaque utilisateur, Cognos TM1 requiert un nom unique et un nom degroupe. Par exemple, vous pouvez mapper l'attribut de nom dans votre schémaLDAP à l'utilisateur Cognos TM1, et mapper l'attribut de département augroupe Cognos TM1.

3. Cliquez sur OK.

Définition des options d'exportation ETLDAPVous pouvez indiquer des options d'exportation ETLDAP.

Procédure1. Cliquez sur Editer > Options.2. Sélectionnez Enable Integrated Login.3. Entrez le nom du domaine contenant les utilisateurs à transférer.4. Désactivez la case Save Passwords.

Quand vous désactivez Save Passwords, ETLDAP retire alors tous les mots depasse nécessaires à la connexion aux serveurs avant l'écriture du fichier desauvegarde de session. A l'exécution suivante d'ETLDAP, vous devrez entrer ànouveau les mots de passe.

5. Définissez les zones Maximum Search Results et Search Time Limit sur 0.6. Cliquez sur OK.

Exportation d'informations LDAP dans Cognos TM1Vous pouvez exporter des informations LDAP dans IBM Cognos TM1.


Procédure1. Cliquez sur Exporter.

ETLDAP déplace les enregistrements extraits de l'annuaire LDAP dans TM1 etconsigne l'activité d'exportation des données dans un fichier journal.

Remarque : Vous pouvez ouvrir le journal avant d'exporter des enregistrementsafin de suivre la progression de l'opération.

2. Cliquez sur View (Affichage), Log (Journal) pour ouvrir le journal de session.Le journal de session présente, sous forme de synthèse, les utilisateurs LDAPque l'utilitaire ETLDAP a exportés et créés dans Cognos TM1. ETLDAP génèredes mots de passe utilisateur Cognos TM1 aléatoires et les insère dans la basede données Cognos TM1.

Remarque : Si vous utilisez la connexion intégrée, les utilisateurs de CognosTM1 n'utilisent pas les mots de passe Cognos TM1 et il n'est pas nécessaire decoordonner les mots de passe entre Cognos TM1 et Microsoft Windows. Si vousn'utilisez pas la connexion intégrée, les utilisateurs de Cognos TM1 doiventchanger leur mot de passe lors de leur première session de connexion. Pourplus d'informations, voir «Connexion intégrée», à la page 239.

Exécution de l'utilitaire ETLDAP en mode Mise à jour pourajouter de nouveaux utilisateurs LDAPVous pouvez exécuter ETLDAP en mode Mise à jour pour intégrer à IBM CognosTM1 les nouveaux utilisateurs LDAP qui n'existent pas encore dans Cognos TM1.Pour cela, spécifiez une date dans la section du filtre de votre requête LDAP.


Lors de la première exécution de l'utilitaire ETLDAP, vous devez extraire tous lesenregistrements du serveur LDAP qui répondent aux exigences de votreorganisation. Ces exigences sont définies à l'aide du paramètre Filtre. Une fois tousles enregistrements d'utilisateurs et de groupes extraits, vous les chargez dans labase de données IBM Cognos TM1.

Après avoir utilisé ETLDAP pour le chargement initial des utilisateurs LDAP dansCognos TM1, vous ne pouvez vous servir de l'outil que pour extraire et ajouter lesnouveaux utilisateurs LDAP qui n'existent pas encore dans Cognos TM1. Vous nepouvez pas vous en servir pour mettre à jour ou supprimer des utilisateursexistants de Cognos TM1 à la suite de modifications apportées dans l'annuaireLDAP.

Lorsque des nouveaux utilisateurs sont ajoutés sur le serveur LDAP, vous pouvezles ajouter à Cognos TM1 en entrant une date dans la section Filtre de votrerequête LDAP. Dès qu'une date est précisée dans la section du filtre, ETLDAPs'exécute en mode Mise à jour. Vous pouvez modifier votre filtre LDAP poursélectionner uniquement les nouveaux enregistrements utilisateurs répondant auxcritères d'origine depuis la dernière exécution de l'utilitaire ETLDAP.

Remarque : Lorsque vous exécutez ETLDAP en mode Mise à jour, vous ajoutezuniquement les utilisateurs LDAP qui n'existent pas encore dans Cognos TM1.ETLDAP ne permet pas de mettre à jour les attributs des utilisateurs, ni desupprimer des utilisateurs Cognos TM1 existants.


Procédure1. Déterminez l'attribut d'enregistrement de dernière modification pour spécifier

une date dans la section du filtre de votre requête LDAP.Tous les serveurs LDAP prennent en charge un attribut d'enregistrement dedernière modification, qui comprend les attributs d'horodatage suivants :v Standard LDAP - modifytimestampv Microsoft Active Directory - whenChangedLors d'une session d'exportation, ETLDAP examine tous les enregistrements aufur et à mesure de leur traitement et stocke la date du dernier enregistrementmodifié dans le fichier journal de session, comme l'indique l'exemple suivant :newest record modified: Thu Jan 23 07:00:42 EST 2003(20030123070042.0Z)

2. Repérez la ligne newest record dans le journal de session LDAP.3. Copier les informations d'horodatage de la chaîne entre parenthèses du journal

de session LDAP dans la section du filtre de votre requête LDAP.

Remarque : Veillez à respecter la syntaxe prise en charge par les filtres LDAP.Pour plus d'informations, voir le document sur les protocoles standardsInternet, RFC 2254, «Représentation par chaîne des filtres de recherche LDAP».Le tableau suivant présente un exemple de chaîne Filtre avant et aprèsmodification pour les serveurs LDAP et Active Directory.v Un serveur LDAP standard utilise l'attribut modifytimestamp.v Un serveur LDAP doté de Microsoft Active Directory utilise l'attribut

whenChanged.

Exemple de chaîne de filtre Chaîne de filtre après modification

Chaîne initiale(&(objectclass=person)(|(department=R&D)

(department=Documentation)))

Modifiée pour LDAP standard(&(objectclass=person)(modifytimestamp>

=20030515162433Z)(|(department=R&D*)

(department=QA)))

Modifiée pour Active Directory(&(objectclass=person)(whenChanged>

=20030515162433.0Z)(|(department=R&D*)

(department=QA)))

4. Une fois les modifications nécessaires apportées à la ligne Filtre, enregistrez lesdonnées de session sous un nom identifiant clairement qu'il s'agit d'une requêtede mise à jour incrémentielle.

5. Exécutez ETLDAP avec les nouvelles données de session.

Connexion intégréeLa connexion intégrée vous permet d'utiliser l'authentification de réseau MicrosoftWindows pour contrôler l'accès aux données IBM Cognos TM1.

Dans ce modèle de sécurité, vous pouvez vous servir de l'utilitaire ETLDAP (voirExécution d'ETLDAP) ou d'autres procédures pour transférer les informations deconnexion Microsoft Windows des utilisateurs et des groupes dans la base dedonnées Cognos TM1. Les utilisateurs qui veulent accéder aux données Cognos


TM1 via des clients Cognos TM1 doivent se connecter d'abord à MicrosoftWindows. Si la connexion à Microsoft Windows réussit, Cognos TM1 ne demandeaucune information de connexion.

La connexion intégrée compare le nom de domaine qualifié utilisé pour l'accès àMicrosoft Windows au contenu de la zone UniqueID du cube }ClientProperties. Encas de correspondance, Cognos TM1 vous autorise à vous connecter.

Par exemple, vous vous connectez au domaine company.com à l'aide du nomd'utilisateur Robert. Lorsque vous cliquez deux fois sur un serveur dansl'explorateur de serveur, Cognos TM1 inspecte le cube }ClientProperties et sa zoneUniqueID. Robert est associé au nom de domaine qualifié robert@company. SiRobert se connecte au domaine COMPANY sous le nom Robert, la connexionintégrée doit fonctionner pour cet utilisateur.

Si la connexion intégrée ne trouve pas de correspondance au nom de domainequalifié utilisé pour l'accès à Microsoft Windows dans la zone UniqueID du cube}ClientProperties, Cognos TM1 affiche un message d'erreur indiquant que le nomde client n'existe pas sur le serveur.

La connexion intégrée est prise en charge sous Microsoft Windows uniquement.Vous ne pouvez pas utiliser la connexion intégrée pour accéder à une versionUNIX du serveur Cognos TM1.

Configuration de Cognos TM1 pour utiliser la connexion intégréeUtilisez la liste de contrôle suivante afin de configurer les composants IBM CognosTM1 de sorte qu'ils utilisent la connexion intégrée comme méthoded'authentification à la connexion pour tous les utilisateurs.1. Installez le serveur Cognos TM1 et vérifiez que vous êtes en mesure de

l'exécuter et de vous y connecter.2. Exécutez l'utilitaire ETLDAP pour extraire les données de connexion

d'utilisateurs et de groupes de votre annuaire LDAP et les charger dans le cubede sécurité TM1. ETLDAP crée des utilisateurs Cognos TM1 à partir desdonnées LDAP que vous spécifiez. Ces utilisateurs sont membres du groupeauquel ils ont été affectés dans votre annuaire LDAP.Pour plus d'informations, voir «Exécution d'ETLDAP», à la page 231.

3. Configurez les composants serveur et client de Cognos TM1 pour qu'ilsutilisent la connexion intégrée.

Tableau 27. Récapitulatif de la connexion intégrée pour les composants Cognos TM1

Composant Configuration requise

Cognos TM1 Server Configurez les paramètres de connexion intégréedans le fichier Tm1s.cfg pour toutes les bases dedonnées TM1 que vous souhaitez utiliser avec laconnexion intégrée.

Pour plus d'informations, voir «Configuration de laconnexion intégrée pour le serveur Cognos TM1», àla page 242.


Tableau 27. Récapitulatif de la connexion intégrée pour les composants CognosTM1 (suite)

Composant Configuration requise

Cognos TM1 Clients Activez l'option Utiliser la connexion intégrée pourCognos TM1 Architect et Cognos TM1 Perspectives.

Pour plus d'informations, voir «Configuration deCognos TM1 Perspectives pour utiliser la connexionintégrée», à la page 250 et«Configuration de CognosTM1 Architect pour utiliser la connexion intégrée»,à la page 250.

Cognos TM1 Web Configurez les paramètres suivantes pour CognosTM1 Web :

Fichier tm1web_config.xml :configurez lesparamètres du fichier tm1web_config.xml quiactivent la connexion intégrée pour Cognos TM1Server Web.Remarque : Vous serez peut-être amené à vérifieret/ou configurer manuellement vos paramètres desécurité Kerberos.

4. Définissez les droits d'accès des utilisateurs Cognos TM1.Pour plus d'informations, voir «Configuration des droits d'accès des utilisateursCognos TM1.».

Configuration des droits d'accès des utilisateurs Cognos TM1.Pour permettre à un utilisateur IBM Cognos TM1 d'accéder aux données, vousdevez l'affecter à d'autres groupes Cognos TM1. Cette rubrique explique commentajouter un utilisateur au groupe Admin.

Par exemple, pour pouvoir publier des objets publics sur le Web via Cognos TM1Web, l'utilisateur doit être membre du groupe Admin de Cognos TM1.

Procédure1. Démarrez Cognos TM1 Architect.2. Cliquez sur Fichier > Options.3. Désélectionnez l'option Connexion intégrée.4. Cliquez sur OK.5. Dans la sous-fenêtre de navigation de l'explorateur de serveur, cliquez deux

fois sur TM1 pour ouvrir la liste de serveurs.6. Cliquez deux fois sur un nom de serveur.7. Connectez-vous à l'aide de vos ID et mot de passe de connexion

d'administrateur.v Nom d'administrateur (par défaut) - adminv Mot de passe administrateur (par défaut) - apple

8. Cliquez avec le bouton droit sur le nom du serveur, puis cliquez sur Sécurité> Clients et groupes.

9. Sélectionnez un utilisateur à ajouter au groupe Admin. A l'aide de la barre,faites défiler l'affichage vers la gauche où la liste de groupes apparaît.

10. Pour ajouter l'utilisateur au groupe Admin, cochez la case dans la colonneADMIN pour cet utilisateur.

11. Cliquez sur OK.


Configuration de la connexion intégrée pour le serveur CognosTM1Vous pouvez modifier une installation IBM Cognos TM1 de façon à utiliser laconnexion intégrée sans réinstaller Cognos TM1. Pour ce faire, vous devez exécuterETLDAP et modifier plusieurs fichiers de configuration de Cognos TM1.

Procédure1. Exécutez ETLDAP et importez les informations d'utilisateurs et de groupes du

serveur LDAP, comme décrit dans «Exécution d'ETLDAP», à la page 231.2. Arrêtez le serveur Cognos TM1.3. Modifiez les paramètres suivants du fichier Tm1s.cfg situé dans le répertoire de

données du serveur Cognos TM1 :v Définissez le paramètre IntegratedSecurityMode sur 2.v Définissez le paramètre SecurityPackageName sur le protocole de sécurité

que vous utilisez pour la connexion intégrée comme Kerberos (valeur pardéfaut).

Dans l'exemple suivant, le serveur est configuré pour l'emploi de Kerberos.[TM1S]

SecurityLogging=F

SecurityPackagename=Kerberos


Servername=myserver

DatabaseDirectory=C:\Program Files\

4. Enregistrez et fermez le fichier TM1S.cfg.5. Redémarrez le serveur Cognos TM1.6. Configurez les différents clients Cognos TM1 pour l'utilisation de la connexion

intégrée en activant l'option Utiliser la connexion intégrée dans l'interfaceutilisateur associée.v «Configuration de Cognos TM1 Architect pour utiliser la connexion intégrée»

, à la page 250.v «Configuration de Cognos TM1 Perspectives pour utiliser la connexion

intégrée», à la page 250.

Résultats

A présent, vous pouvez vous connecter à votre serveur Cognos TM1 à l'aide de laconnexion intégrée via Cognos TM1 Architect ou Cognos TM1 Perspectives.

Pour des informations sur la configuration de la connexion intégrée pour CognosTM1 Web, voir «Configuration de la connexion intégrée de Cognos TM1 Web àl'aide de Kerberos et JAAS».

Configuration de la connexion intégrée de Cognos TM1 Web àl'aide de Kerberos et JAASVous pouvez configurer l'utilisation de la connexion intégrée par IBM Cognos TM1Web à l'aide du protocole de sécurité Kerberos. C'est le type d'authentification quiest associé à TM1 IntegratedSecurityMode=3.


Dans Cognos TM1 Web version 10.2, vous devez saisir votre identifiantd'authentification Microsoft Windows dans la boîte de dialogue de connexion de


Cognos TM1 Web. La boîte de dialogue de connexion vous permet de choisir laconnexion TM1 native ou Microsoft Windows.

Pour pouvoir exécuter Cognos TM1 Web dans un environnement Kerberos, vousdevez configurer cet environnement pour permettre à Kerberos de fonctionner avecl'environnement Java Runtime qui exécute le service Cognos TM1 Web.

Procédure1. Définissez un fichier de configuration Kerberos.

Sur un système Windows, le fichier de configuration Kerberos est krb5.ini.Sous Linux, le fichier est krb5.conf.Exemple de fichier de configuration Windows Kerberos (krb5.ini) :[libdefaults]default_realm = <REALM_NAME>default_tkt_enctypes = rc4-hmac des-cbc-crcdefault_tgs_enctypes = rc4-hmac des-cbc-crcticket_lifetime = 1200[realms]<REALM_NAME> = {kdc = 9.24.213.202admin_server = <server_name.domain_name>default_domain = <DOMAIN_NAME>}[domain_realm].<domain_realm_name> = <DOMAIN_REALM_NAME>

[appdefaults]autologin=trueforward=trueforwardable=trueencrypt=true

2. Définissez la fonction de connexion JAAS dans le fichier java.security.Exemple de définition de la fonction de connexion JAAS dans le fichierjava.security :# Default login configuration file#login.config.url.1=file:${user.home}/.java.login.configlogin.config.url.1=file:${java.home}/lib/security/login.config

Exemple de contenu d'un fichier de configuration pour l'environnement IBMJava Runtime :TM1SignedOnUserLoginContext {

com.ibm.security.auth.module.Krb5LoginModule requireduseDefaultCcache=falsecredsType=initiator;

};

Exemple de contenu d'un fichier de configuration pour l'environnement SUNJava Runtime :TM1SignedOnUserLoginContext {

com.sun.security.auth.module.Krb5LoginModule requireduseTicketCache="true"useKeyTab="true" keyTab="krb5.keytab" ;

};

3. Définissez le fichier de configuration de la connexion.4. Configurez le paramètre IntegratedSecurityModuleName du fichier

tm1web_config.xml.Vérifiez que la valeur du paramètre IntegratedSecurityModuleName est le nomdu module de connexion associé à l'environnement Kerberos.<add key=“IntegratedSecurityModuleName” value=“name of theLoginModule”/>


5. Vérifiez que le service Windows de Cognos TM1 Server appartient à un comptede domaine autorisé.

6. Vérifiez que l'utilisateur qui se connecte dispose d'une ticket valide obtenu parla procédure kinit.

Configuration de la connexion intégrée de Cognos TM1 Web àl'aide de Kerberos et SPNEGOVous pouvez configurer le code d'accès unique pour IBM Cognos TM1 Web à l'aided'une connexion intégrée (Kerberos) et de la couche de sécurité du serveurd'applications. Le code d'accès unique permet aux utilisateurs qui utilisent desclients HTTP de ne se connecter qu'une seule fois à TM1 Web.

Présentation

IBM WebSphere Application Server doit être configuré pour que les clients puissents'authentifier à l'aide de Kerberos. Lorsqu'un client s'authentifie avec succès auprèsdu serveur d'applications qui utilise Kerberos, TM1 Web peut utiliser les donnéesd'identification Kerberos pour connecter cet utilisateur aux serveurs TM1configurés pour la connexion intégrée. La procédure d'installation requiert laconfiguration suivante :

Code d'accès unique du client au serveur d'applicationsPour WebSphere Liberty Profile, le code d'accès unique peut êtreimplémenté à l'aide du fournisseur d'authentification Web SPNEGO(Simple and Protected GSS-API Negotiation Mechanism). Ce fournisseurpermet aux clients compatibles Kerberos d'utiliser le code d'accès unique àWebSphere Liberty Profile. Sous Windows, cette approche permet auxutilisateurs de s'authentifier auprès d'un domaine Windows une seule foiset d'obtenir un code d'accès unique à WebSphere Liberty.

Code d'accès unique de TM1 Web déployé sur le serveur d'applicationsLe code d'accès unique de WebSphere Liberty aux serveurs TM1 configuréspour la connexion intégrée utilise l'API JGSS (Java Generic SecurityServices) et JAAS (Java Authentication and Authorization Services) pourdéléguer les données d'identification Kerberos reçues à TM1 Web.

Une fois que vous avez correctement implémenté cette configuration, lesutilisateurs peuvent s'authentifier auprès de TM1 Web configuré par rapport à unserveur TM1 qui exécute le mode de sécurité 2 ou 3 (connexion intégrée) avecleurs données d'identification utilisateur Windows.

Avant de commencer

Assurez-vous que les prérequis suivants sont configurés :v Tous les ordinateurs participant à l'installation fonctionnent sous Microsoft

Windows et sont associés à un domaine Windows. Il existe des cheminssécurisés entre les ordinateurs de l'installation.

v Tous les ordinateurs de l'installation peuvent résoudre le nom de domainecomplet de tous les autres ordinateurs et contrôleurs de domaine Windowsutilisés dans la configuration.

v Une instance de serveur TM1 est configurée pour la connexion intégrée avec lesparamètres suivants configurés :– Un nom principal de service (SPN) est enregistré dans un compte Windows

qui exécute le service Windows pour l'instance de TM1 Application Server.– Le nom SPN est configuré avec le paramètre ServicePrincipalName dans

tm1s.cfg.


– Le paramètre IntegratedSecurityMode du fichier tm1s.cfg est défini sur 2 ou.– Le paramètre SecurityPackageName est défini sur Kerberos.– Pour tous les utilisateurs qui accèdent au serveur TM1, la propriété UniqueID

de la dimension }ClientProperties correspond à une chaîne dont la syntaxeest <domain>/<sAMAccountName>.

v Une instance de TM1 Application Server est installée sur un ordinateur del'installation.

v Un utilisateur de domaine peut se connecter à un ordinateur client différent del'ordinateur sur lequel les composants de TM1 Application Server sont installés.L'utilisateur doit pouvoir exécuter un navigateur pris en charge pour accéder àTM1 Web. Pour plus d'informations, voir «Configuration des navigateurs Webpour la connexion intégrée», à la page 249.

Conventions

L'installation utilise les conventions suivantes :

<TM1APP_DOMAIN>Nom du domaine Microsoft Windows. Par exemple, mydomain.sample.com.

<TM1APP_REALM>Nom <TM1APP_DOMAIN> en majuscules. Par exemple,MYDOMAIN.SAMPLE.COM.

<TM1APP_HOST>Nom d'hôte complet de l'ordinateur sur lequel TM1 Application Server estinstallé. Par exemple, appsrv1.mydomain.sample.com.

<TM1APP_ACCOUNT>Compte utilisateur d'un domaine Windows utilisé pour exécuter TM1Application Server.

Configuration d'un compte pour TM1 Application Server1. En tant qu'administrateur de domaine, créez un compte utilisateur de domaine

ou recherchez un compte utilisateur de domaine existant utilisé pour exécuterle service TM1 Application Server. Ce compte utilisateur est appelé<TM1APP_ACCOUNT>. Par exemple, mydomain/pa11.

2. A l'aide de l'outil setspn de Microsoft, enregistrez un nom SPN de classe deservice HTTP auprès du compte <TM1APP_ACCOUNT> pour permettre àWebSphere Liberty de devenir un service Web compatible Kerberos. En tantqu'administrateur de domaine, ouvrez une fenêtre de commande et saisissez lacommande suivante :setspn -U -F -S HTTP/<TM1APP_HOST> <TM1APP_ACCOUNT>

Par exemple :setspn -U -F -S HTTP/appsrv1.mydomain.sample.com mydomain/pa11

Conseil : Utilisez setspn -l <TM1APP_ACCOUNT> pour vérifier que le nom SPNest correctement enregistré.

3. Si vous utilisez des noms NetBIOS, par exemple, appsrv1, au lieu de nomsqualifiés complets, répétez la commande setspn pour enregistrer un autre nomSPN à l'aide du nom NetBIOS du serveur.

4. Sur <TM1APP_HOST>, vérifiez que le service Windows qui exécute TM1Application Server est démarré par <TM1APP_ACCOUNT> (voir 1).


a. Dans le panneau de configuration des services Windows, cliquez sur leservice IBM Cognos TM1 à l'aide du bouton droit de la souris, puissélectionnez Propriétés.

b. Dans l'onglet Se connecter, ajoutez le compte <TM1APP_ACCOUNT> et le mot depasse.

c. Cliquez sur OK.5. Sur <TM1APP_HOST>, créez un fichier de clés Kerberos à l'aide de l'outil

ktpass de Microsoft.

Remarque : WebSphere Liberty requiert les données d'identification du serveurpour permettre l'authentification Kerberos à ce dernier. Ces données sontstockées dans un fichier de clés. Pour créer ce fichier, vous devez utiliser l'outilktpass de Microsoft.Dans une fenêtre CMD, entrez la commande suivante :ktpass -put <keytab_file> -princ <SPN>@<TM1APP_REALM> -mapuser <TM1APP_ACCOUNT>-pass <password> -mapOp set -ptype KRB5_NT_PRINCIPAL

Par exemple :ktpass -out krb5.keytab -princ HTTP/[email protected] mydomain\pa11 -pass pssw0rd -mapOp set -ptype KRB5_NT_PRINCIPAL

Cette commande crée un fichier krb5.keytab dans le dossier actuel qui contientles données d'identification du serveur Kerberos.

Conseil :

Vous pouvez utiliser l'outil klist de l'environnement d'exécution Java pourafficher le contenu du fichier de clés. Par exemple :<TM1_ROOT>/bin64/jre/7.0/bin/Klist -kt krb5.keytab

Configuration de l'authentification Web SPNEGO/Kerberos pourWebSphere Liberty1. Sur <TM1APP_HOST>, créez un fichier de configuration Kerberos pour

WebSphere Liberty.Dans un éditeur de texte, créez un fichier et collez-y le contenu suivant :[libdefaults]

default_realm = <TM1APP_REALM>default_keytab_name = FILE:<keytab_file>default_tkt_enctypes = aes128-cts-hmac-sha1-96default_tgs_enctypes = aes128-cts-hmac-sha1-96forwardable = truerenewable = truenoaddresses = trueclockskew = 300udp_preference_limit = 1

[realms] <TM1APP_REALM> ={

kdc = <TM1APP_DOMAIN>:88default_domain = <TM1APP_DOMAIN>

}[domain_realm]

.<TM1APP_DOMAIN> = <TM1APP_REALM>

Remplacez les variables par des valeurs réelles dans votre environnement etenregistrez le fichier sous le nom krb5.ini.

Remarque :

v L'entrée de default_keytab_name = doit faire référence au fichier de clés créédans 5.


v L'entrée pour default_tkt_enctypes = aes128-cts-hmac-sha1-96 est unexemple. Vous devez utiliser les types de chiffrement pris en charge dansvotre environnement.

v En fonction de la structure des arborescences de domaine de la forêt ActiveDirectory, le fichier de configuration Kerberos peut nécessiter des entréessupplémentaires dans les sections [realms] et [domain_realm]. Contactezvotre administrateur Active Directory pour qu'il vous indique votre structurede domaine. Pour plus d'informations sur le fichier de configurationKerberos, voir Fichier de configuration Kerberos dans la documentationWebSphere Application Server Network Deployment.

2. Utilisez l'outil kinit de l'environnement d'exécution Java afin de demander unticket Kerberos pour le nom SPN et vérifiez le fichier de configurationKerberos :<TM1_ROOT>/bin64/jre/7.0/bin/kinit/kinit -kt <keytab_file> HTTP/<TM1APP_HOST>

Par exemple :<TM1_ROOT>/bin64/jre/7.0/bin/kinit -k -t krb5.keytabHTTP/appsrv1.mydomain.sample.com

L'outil confirme qu'un ticket a été stocké dans le cache des tickets par défaut.3. Utilisez l'outil klist de l'environnement d'exécution Java pour afficher le ticket

Kerberos.Par exemple :<TM1_ROOT>/bin64/jre/7.0/bin/klist

Modification de la configuration du serveur WebSphere Liberty

Les étapes ci-après permettent de modifier manuellement le fichier deconfiguration du serveur WebSphere Liberty. Ces modifications manuelles sontannulées si vous effectuez d'autres modifications qui requièrent une régénérationdu fichier de configuration du serveur d'applications dans Cognos Configuration.Par conséquent, vous devez sauvegarder le fichier server.xml une fois cesmodifications de configuration manuelles terminées.1. Arrêtez TM1 Application Server.2. Dans un éditeur de texte, ouvrez le fichier <RACINE_TM1>/wlp/usr/server/tm1/

server.xml.3. Ajoutez les éléments de fonctionnalité suivant avant l'élément

</featureManager> :<feature>appSecurity-2.0</feature><feature>ldapRegistry-3.0</feature><feature>spnego-1.0</feature>

4. Avant la balise <application id=”tm1”...>, ajoutez l'élément suivant :<ldapRegistry

id="ldap"realm="<TM1APP_DOMAIN>"host="<TM1APP_DOMAIN>"port="389"ignoreCase="true"baseDN="<base_DN>"bindDN="<binduser_accountDN>"bindPassword="<binduser_password>"ldapType="Microsoft Active Directory"

/>

L'utilisation du nom de domaine de host entraîne l'utilisation de lafonctionnalité du localisateur de système de noms de domaine de Microsoft,qui empêche les points de défaillance uniques en cas de désactivation ducontrôleur de domaine référencé. Le paramètre baseDN est généralement


http://www.ibm.com/support/knowledgecenter/SSAW57_8.5.5/com.ibm.websphere.nd.doc/ae/rsec_SPNEGO_config_krb5.html

composé de la chaîne cn=Users et d'une liste d'éléments représentant chaqueportion du nom de domaine, séparés par des virgules.Par exemple :Domain: mydomain.sample.comBaseDN: cn=Users,dc=mydomain,dc=sample,dc=com

Le nom binduser_accountDN doit correspondre au nom distinctif d'un compteutilisateur du domaine référencé, qui dispose de droits de navigation pourtoutes les entrées utilisateur de ce domaine.Par exemple :cn=admin1,cn=Users,dc=mydomain,dc=sample,dc=com

L'élément de registre LDAP indique à WebSphere Liberty où rechercher lesinformation sur l'utilisateur qui tente de s'authentifier à l'aide de Kerberos. Parconséquent, le registre LDAP doit faire référence au domaine d'où provientl'utilisateur qui s'authentifie. Pour que les utilisateurs de plusieurs domainespuisse s'authentifier une seule fois, vous devez définir un registre LDAP pourchaque domaine. Plusieurs registres LDAP deviennent alors automatiquementfédérés.

Remarque : Pour plus d'informations, voir Configuration de registresd'utilisateurs LDAP dans Liberty dans le Knowledge Center.

5. Pour activer l'authentification Web SPNEGO/Kerberos pour WebSphere Liberty,ajoutez l'élément suivant après l'élément <ldapRegistry> :<spnego

id="mySpnego"krb5Config="<krb5.ini>"krb5Keytab=”<keytab_file>"servicePrincipalNames="HTTP/<TM1APP_HOST>@<TM1APP_REALM>"/>

Conseil : Vous pouvez utiliser l'outil securityUtility d'IBM WebSphere pourcoder les mots de passe dans le fichier server.xml.

6. Vous pouvez éventuellement éditer les paramètres de journalisation afind'inclure la sortie de trace pour l'authentification Web SPNEGO/Kerberos.Par exemple :<logging

consoleLogLevel="WARNING"traceSpecification="*=warn:com.ibm.ws.security.spnego.*:all"logDirectory="${wlp.user.dir}/../../logs"messageFileName="tm1_messages.log"maxFiles="2"maxFileSize="20"/>

Configuration de TM1 Web pour la sécurité WebSphere Liberty1. Dans le fichier server.xml, recherchez l'entrée TM1 Web application et

modifiez-la comme illustré dans l'exemple suivant :<application id="tm1web"

location="${wlp.user.dir}/../../webapps/tm1web"name="tm1web"type=”war” context-root=”tm1web”><application-bnd>

<security-role name="AllAuthenticated"><special-subject type="ALL_AUTHENTICATED_USERS" />

</security-role></application-bnd>

</application>

2. Enregistrez le fichier server.xml et faites-en une sauvegarde.


http://www.ibm.com/support/knowledgecenter/SSEQTP_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/twlp_sec_ldap.html

http://www.ibm.com/support/knowledgecenter/SSEQTP_liberty/com.ibm.websphere.wlp.nd.multiplatform.doc/ae/twlp_sec_ldap.html

Configuration du code d'accès unique avec SPNEGO1. Ajoutez des contraintes de sécurité dans le fichier web.xml de TM1 Web.

Sur <TM1APP_HOST>, éditez le fichier <Racine_TM1>/webapps/tm1web/WEB-INF/web.xml à l'aide d'un éditeur de texte. Avant le premier élément <filtre>,ajoutez le contenu suivant :<login-config>

<auth-method>BASIC</auth-method><realm-name>MYTM1SERVER.EXAMPLE.COM</realm-name>

</login-config><security-role>

<role-name>AllAuthenticated</role-name></security-role><security-constraint>

<web-resource-collection><web-resource-name>tm1web</web-resource-name><url-pattern>/*</url-pattern><url-pattern>/</url-pattern><http-method>POST</http-method><http-method>GET</http-method>

</web-resource-collection><auth-constraint>

<role-name>AllAuthenticated</role-name></auth-constraint>

</security-constraint>

2. Enregistrez le fichier.3. Démarrez le service TM1 Application Server.4. Dans le navigateur d'un ordinateur distant (autre que <TM1APP_HOST>),

ouvrez un navigateur compatible Kerberos et accédez à l'adresse suivante :HTTP://<TM1APP_HOST>:9510/tm1web

Une fois que l'instance de serveur TM1 a été sélectionnée, vous êtes authentifiésans y être invité.

Traitement des incidentsv Vérifiez que votre navigateur est correctement configuré pour

SPNEGO/Kerberos. Pour plus d'informations, voir «Configuration desnavigateurs Web pour la connexion intégrée» et Configuration du navigateurclient pour l'utilisation de SPNEGO.

v Vérifiez que l'utilisateur Windows que vous utilisez pour les tests n'est pas unadministrateur de domaine. Les administrateurs de domaine ne peuvent pas êtredélégués via Kerberos.

v Vérifiez que les tests sont effectués sur un ordinateur distant. Si le navigateur estexécuté sur le même ordinateur que TM1 Web, SPNEGO peut échouer.

v Vérifiez également que l'attribut disableFailOverToAppAuthType dans laconfiguration <spnego> est défini sur false.

Configuration des navigateurs Web pour la connexion intégréeAprès avoir configuré la connexion intégrée dans IBM Cognos TM1 Web, vousdevez configurer les navigateurs Web des systèmes clients qui accéderont à CognosTM1 Web.

Procédure1. Si vous utilisez Microsoft Internet Explorer, définissez l'URL Web de Cognos

TM1 comme un site sécurisé.Par exemple, activez les options Connexion automatique avec le nomd'utilisateur et le mot de passe actuel et Activer l'authentification Windowsintégrée dans Internet Explorer.


https://www.ibm.com/support/knowledgecenter/SSEQTP_8.0.0/com.ibm.websphere.base.doc/info/aes/ae/tsec_SPNEGO_configweb_new.html

https://www.ibm.com/support/knowledgecenter/SSEQTP_8.0.0/com.ibm.websphere.base.doc/info/aes/ae/tsec_SPNEGO_configweb_new.html

Pour en savoir davantage, reportez-vous à la documentation de MicrosoftInternet Explorer.

2. Si vous utilisez Mozilla Firefox, recherchez et modifiez les préférencessuivantes, de sorte qu'elles contiennent la liste des préfixes ou domaines d'URLséparés par une virgule qui correspondent à l'emplacement de votre serveurTM1 Web.network.automatic-ntlm-auth.trusted-uris

network.negotiate-auth.delegation-uris

network.negotiate-auth.trusted-uris

Par exemple, entrez localhost si vous exécutez Cognos TM1 Web localementou le nom de serveur si vous exécutez Cognos TM1 Web sur un serveur Webdédié.Pour en savoir davantage, reportez-vous à la documentation de Mozilla Firefox.

Configuration de Cognos TM1 Architect pour utiliser laconnexion intégréeAprès avoir configuré la connexion intégrée pour le serveur IBM Cognos TM1,vous pouvez l'utiliser pour accéder à vos données Cognos TM1 via Cognos TM1Architect.

Procédure1. Exécutez Cognos TM1 Architect.2. Cliquez sur Fichier > Options.3. Vérifiez que la case Connexion intégrée est sélectionnée.4. Cliquez sur OK.5. Dans l'arborescence de l'explorateur de serveur, cliquez deux fois pour ouvrir la

liste des serveurs.6. Cliquez deux fois sur le serveur vers lequel vous avez exporté les données

d'utilisateurs et de groupes LDAP.Vous devez être connecté sans être invité à entrer un nom d'utilisateur ou unmot de passe.

Configuration de Cognos TM1 Perspectives pour utiliser laconnexion intégréeAprès avoir configuré la connexion intégrée pour le serveur IBM Cognos TM1,vous pouvez l'utiliser pour accéder à vos données Cognos TM1 via Cognos TM1Perspectives.

Procédure1. Lancez Microsoft Excel.2. Cliquez sur TM1, Explorateur de serveur.

L'explorateur de serveur TM1 s'ouvre.3. Cliquez sur Fichier > Options.4. Vérifiez que la case Connexion intégrée est sélectionnée.5. Cliquez sur OK.6. Dans l'arborescence de l'explorateur de serveur, cliquez deux fois pour ouvrir la

liste des serveurs.7. Cliquez deux fois sur le serveur vers lequel vous avez exporté les données

d'utilisateurs et de groupes LDAP.TM1 Perspectives doit automatiquement vous connecter à Cognos TM1 sansdemander de nom d'utilisateur ni de mot de passe.


Connexion à Cognos TM1 Web avec la connexion intégréeAprès avoir configuré un serveur IBM Cognos TM1 et Cognos TM1 Web en vue del'utilisation de la connexion intégrée, vous pouvez utiliser ce moded'authentification pour vous connecter et accéder à vos données via Cognos TM1Web. Notez qu'à partir de TM1 10.2, TM1 Web ne prend pas en charge laconnexion unique. Vous devez entrer une combinaison nom d'utilisateur/mot depasse pour la connexion à TM1 Web.

Procédure1. Lancez Microsoft Internet Explorer.2. Entrez l'URL suivante dans la zone Adresse du navigateur :

http://web_server_name:port_number /tm1web/

Par exemple : http://localhost:9510/tm1web/3. Entrez le nom d'hôte du serveur d'administration de Cognos TM1 Server dans

la zone Hôte admin.4. Cliquez sur la flèche Serveur.5. Cliquez sur le bouton Connexion.6. Entrez votre nom d'utilisateur et votre mot de passe.

Authentification LDAPVous pouvez définir l'authentification IBM Cognos TM1 à l'aide d'un serveurLDAP.

Validation des utilisateurs à l'aide d'un serveur LDAPLa validation LDAP vous permet de centraliser tous vos mots de passe utilisateursur un serveur LDAP externe.

Lorsque vos utilisateurs IBM Cognos TM1 se connectent, le nom et le mot de passequ'ils fournissent sont validés à l'aide des informations figurant sur le serveurLDAP. Vous pouvez spécifier un mot de passe et une clé à utiliser avant laconnexion du serveur à des fins d'authentification LDAP, ou le serveur peut seconnecter directement sans mot de passe.

Avant de procéder à la configuration de l'authentification LDAP, vous devezmaîtriser LDAP et son rôle dans votre structure de sécurité de réseau. Si vousn'êtes pas chargé de l'administration LDAP de votre réseau, adressez-vous à votreadministrateur afin de configurer correctement Cognos TM1 pour l'authentificationLDAP.

Remarque : Votre serveur LDAP doit être configuré pour l'utilisation de SSL afinque la communication avec Cognos TM1 réussisse.

Paramètres d'authentification LDAPUtilisez les paramètres suivants dans le fichier tm1s.cfg pour configurer et prendreen charge l'authentification LDAP.

PasswordSource :

Compare le mot de passe entré par l'utilisateur à celui stocké dans la base dedonnées.

Type de paramètre : facultatif, statique


Cognos TM1 (valeur par défaut) : Compare le mot de passe entré par l'utilisateur àcelui stocké dans la base de données Cognos TM1.

LDAP : Compare le mot de passe entré par l'utilisateur à celui stocké sur leserveur LDAP.

LDAPHost :

Définit le nom de domaine ou la représentation sous forme de chaîne en pointilléde l'adresse IP de l'hôte de serveur LDAP.


Si vous n'entrez pas de valeur pour LDAPHost, IBM Cognos TM1 utilise la valeurpar défaut, localhost.

LDAPPasswordFile :

Définit le fichier de mot de passe utilisé si LDAPUseServerAccount n'est pasemployé. Il s'agit du chemin d'accès complet au fichier .dat, qui contient le mot depasse chiffré pour la clé privée du serveur Admin d'IBM Cognos TM1.

Type de paramètre : facultatif sauf si «LDAPUseServerAccount», à la page 253=F,statique

Ce paramètre utilise le chemin d'accès complet à un fichier .dat.

LDAPPasswordKeyFile :

Définit la clé de mot de passe utilisée si LDAPUseServerAccount n'est pasemployé.


Ce paramètre utilise le chemin d'accès complet au fichier .dat qui contient la cléutilisée pour chiffrer et déchiffrer le mot de passe pour la clé privée.

Ce fichier doit être généré à l'aide de l'utilitaire tm1crypt, comme décrit dans«Exécution de l'utilitaire TM1Crypt», à la page 290.

LDAPPort :

Port utilisé par IBM Cognos TM1 pour la liaison à un serveur LDAP.


Entrez un port sécurisé (SSL), par exemple, 636.

Valeur par défaut : 389 (port non sécurisé)

LDAPSearchBase :

Spécifie le noeud d'arborescence LDAP où IBM Cognos TM1 commence àrechercher des utilisateurs valides.



Un nom distinct (DN) de base dans le répertoire LDAP. Par exemple :ou=people,o=company.com

Par exemple, si les noms distincts (DN) ont la forme :uid-bjensen, ou-people, o=company.com

la base de recherche est :ou-people, o=company.com

LDAPSearchField :

Le nom de l'attribut LDAP qui doit contenir le nom de l'utilisateur IBM CognosTM1 à valider.


Si vous n'entrez pas une valeur LDAPSearchField, la valeur par défaut est cn, quiest également la valeur par défaut pour Microsoft Active Directory.

LDAPSkipSSLCertVerification :

Omet l'étape de vérification de la relation de confiance pour le certificat SSL utilisépour s'authentifier auprès d'un serveur LDAP. Ce paramètre n'est applicable que siLDAPVerifyServerSSLCert=T.


Si la vérification de la relation de confiance ne fonctionne pas, vous pouvezomettre cette étape en définissant LDAPSkipSSLCertVerification=T. Dans ce cas,TM1 ne vérifie pas du tout le certificat du serveur, mais se contente de l'accepter.

Remarque : Pour utiliser ce paramètre, vous devez connaître SSL et LDAP.

Valeur par défaut : F

LDAPSkipSSLCRLVerification :

Omet la vérification de la liste de révocation de certificats pour le certificat SSLutilisé pour s'authentifier auprès d'un serveur LDAP. Ce paramètre n'est applicableque si LDAPVerifyServerSSLCert=T.


Ce paramètre n'est pas nécessaire si LDAPVerifyServerSSLCert=F. L'API MicrosoftWindows peut tolérer une liste de révocation de certificats vide ou inexistence.



LDAPUseServerAccount :

Détermine si la connexion au serveur requiert un mot de passe si l'authentificationLDAP est utilisée.


Type de paramètre : facultatif, statiquev Pour une connexion directe au serveur LDAP à l'aide de l'authentification

intégrée, réglez ce paramètre sur T. Définissez ce paramètre sur T chaque foisque le serveur IBM Cognos TM1 et le serveur LDAP appartiennent au mêmedomaine.

v Pour utiliser un mot de passe avant la connexion, réglez ce paramètre sur F. Si leparamètre LDAPUseServerAccount est défini à F, vous devez également définirle «LDAPPasswordFile», à la page 252 et le «LDAPPasswordKeyFile», à la page252 pour permettre la connexion au serveur LDAP via SSL.

LDAPVerifyCertServerName :

Contient un serveur à utiliser lors du processus de validation du certificat SSLpour l'authentification du serveur LDAP. Ce paramètre n'est applicable que siLDAPVerifyServerSSLCert=T.



Utilisez ce paramètre pour définir les serveurs TM1 à utiliser pour la validation ducertificat SSL reçu.

Chaque nom de serveur à utiliser pour la validation des certificats doit figurerdans une entrée LDAPVerifyCertServerName distincte. Les entrées doiventcorrespondre exactement au nom (sujet) du certificat présenté à TM1 par le serveursitué à l'autre extrémité lors de l'établissement de la liaison SSL.

Définissez LDAPVerifyCertServerName dans le fichier tm1s.cfg de chaque serveurTM1 qui utilise LDAP.LDAPVerifyCertServerName=<server_cert_subject>

Remplacez server_cert_subject par un nom de serveur ou une adresse IP. Créezune entrée pour chaque serveur à utiliser. Par exemple :LDAPVerifyCertServerName=abc99.mydomain.comLDAPVerifyCertServerName=xyz99.mydomain.com


LDAPVerifyServerSSLCert :

Délègue la vérification du certificat SSL à TM1. Ce paramètre est utile, parexemple, lorsque vous utilisez LDAP avec un serveur proxy.



Généralement, TM1 utilise l'API Microsoft Windows pour vérifier les certificatsSSL. Pour que ce processus aboutisse, le nom du certificat et le nom d'hôte duserveur LDAP nom doivent correspondre. Cependant, si vous utilisez un proxy, cesnoms peuvent être différents et la vérification échoue. Dans ce cas, vous pouvezdéfinir LDAPVerifyServerSSLCert=T pour que TM1 effectue la vérification ducertificat.


Lorsque LDAPVerifyServerSSLCert=T, TM1 exécute les deux étapes de lavérification (vérification de la relation de confiance avec le certificat et vérificationde la liste de révocation de certificats) comme l'aurait fait l'API Windows, maisavec une méthode légèrement différente.1. Au lieu de vérifier le certificat reçu par rapport au nom d'hôte configuré, TM1

examine la liste des noms de serveur définie dans LDAPVerifyCertServerName.2. Si le nom du certificat correspond à l'un des serveurs de

LDAPVerifyCertServerName, TM1 appelle l'API Microsoft Windows et luidemande de vérifier uniquement ce certificat.

Remarque : L'autorité de certificat racine de confiance doit au préalable avoirété importée dans le magasin de certificats de Microsoft Windows.

Vous pouvez omettre l'étape de vérification de la relation de confiance endéfinissant LDAPSkipSSLCertVerification=T. Dans ce cas, TM1 ne vérifie pas dutout le certificat du serveur, mais se contente de l'accepter.

3. Une fois la vérification de la relation de confiance vérifiée (ou omise), TM1appelle l'API Microsoft Windows pour vérifier la liste de révocation decertificats.

Remarque : La liste de révocation de certificats de la racine de confiance doitau préalable avoir été importée dans le magasin de certificats de MicrosoftWindows.

Si la liste de révocation de certificats n'existe pas dans le magasin de certificatsde Microsoft Windows, le processus échoue. Vous pouvez omettre lavérification de la liste de révocation de certificats en définissantLDAPSkipSSLCRLVerification=T.

4. Si toutes les étapes précédentes se sont terminées avec succès, l'établissementde liaison SSL est terminé. TM1 tente maintenant de s'authentifier auprès duserveur LDAP.

Pour obtenir des informations relatives au traitement des incidents, voir«Traitement des incidents liés à l'authentification LDAP», à la page 257.

LDAPWellKnownUserName :

Non d'utilisateur utilisé par le serveur IBM Cognos TM1 pour se connecter àLDAP et rechercher le nom soumis par l'utilisateur.


La valeur de ce paramètre peut être n'importe quel nom distinctif LDAP.

Par exemple :uid=bjensen,ou=people,o=company.com

Configuration de la validation LDAPPour configurer la validation LDAP, vous allez modifier le mot de passe dans lefichier TM1s.cfg pour pouvoir ensuite importer les noms de votre annuaire LDAPet modifier les affectations de groupe des nouveaux utilisateurs. Vous devezensuite rétablir le mot de passe LDAP.


Avant de commencer

Pour configurer la validation LDAP, vous avez besoin des informations suivantes :v Un nom que le serveur Cognos TM1 peut utiliser pour la connexion à LDAP.

Vous pouvez tester la validité de ce nom à l'aide de l'utilitaire ETLDAP.v Le port SSL d'exécution du serveur LDAP. La valeur par défaut est 636.v Le nom ou l'adresse IP du serveur LDAP à utiliser pour la validation.

Procédure1. Pour utiliser vos donnée d'identification Cognos TM1 pour vous connecter,

modifiez le paramètre password dans le fichier TM1s.cfg de la manièresuivante :a. Ouvrez le fichier TM1s.cfg de votre répertoire de données de serveur IBM

Cognos TM1.b. Remplacez PasswordSource=LDAP par PasswordSource=TM1

c. Enregistrez et fermez le fichier TM1s.cfg.d. Redémarrez le serveur Cognos TM1.

2. Pour importer des noms du répertoire LDAP dans Cognos TM1, effectuez lesopérations suivantes :a. Suivez la procédure décrite dans «Utilitaire ETLDAP», à la page 229.b. Utilisez les informations de connexion Cognos TM1 suivantes :v Utilisateur Admin (par défaut) - adminv Mot de passe Admin (par défaut) - applePour vous connecter à LDAP, utilisez le nom spécifié au cours del'installation.

3. Pour modifier des affectations de groupe pour les nouveaux utilisateurs,procédez comme suit :a. Connectez-vous à Cognos TM1 en tant qu'administrateur.b. Cliquez avec le bouton droit de la souris sur le nom du serveur dans

l'explorateur et cliquez sur Sécurité, Clients et groupes.c. Le cas échéant, modifiez les affectations de groupe des nouveaux

utilisateurs.Vous devez affecter chaque utilisateur Cognos TM1 ajouté à la base dedonnées par ETLDAP au groupe dont il est membre dans le répertoireLDAP. Par exemple, si NadiaC appartient au groupe gymnastes de votrerépertoire LDAP, ETLDAP crée l'utilisateur NadiaC et le groupe gymnastesdans Cognos TM1. NadiaC apparaît dans la boîte de dialogueClients/groupes en tant que membre de gymnastes.

4. Pour rétablir le mot de passe LDAP, effectuez les opérations suivantes :a. Ouvrez le fichier TM1s.cfg de votre répertoire de données du serveur IBM

Cognos TM1.b. Remplacez PasswordSource=TM1 par PasswordSource=LDAP

c. Définissez le statut de connexion :v Pour une connexion directe au serveur, ajoutez la ligne suivante :

LDAPUseServerAccount=T

v Pour utiliser un mot de passe avant la connexion au serveur, ajoutez leslignes suivantes :LDAPPasswordFile= fichier

LDAPPasswordKey= clé


d. Enregistrez et fermez le fichier TM1s.cfg.e. Redémarrez le serveur Cognos TM1.

Vous devez maintenant être en mesure de vous connecter à Cognos TM1sous un nom ajouté à partir du répertoire LDAP.

Traitement des incidents liés à l'authentification LDAPCette rubrique décrit les messages susceptibles de figurer dans le journal deserreurs lorsque LDAPVerifyServerSSLCert=T dans le fichier tm1s.cfg.

Le message suivant indique que le certificat ne correspond à aucun des noms quisont listés dans LDAPVerifyCertServerName. Vérifiez le nom du certificat etassurez-vous qu'il ait une entrée LDAPVerifyCertServerName dans le fichiertm1s.cfg.LDAP ERROR: 0x800b0109 - Error verifying server certificate chain validityLDAP ERROR: Error verifying server certificate no match for <server>LDAP ERROR: 0x51 - ldap_connect failed.

Le message suivant indique qu'un problème s'est produit lors de la vérification parMicrosoft Windows de la relation de confiance avec le certificat du serveur LDAP.Vérifiez que le certificat a bien été importé dans le magasin de certificats deMicrosoft Windows.LDAP ERROR: 0x800b010f - Error verifying server certificate chain validityLDAP ERROR: Error verifying server certificate no match for <server>LDAP ERROR: 0x51 - ldap_connect failed.

Le message suivant indique que le certificat est révoqué, ou que TM1 n'a pastrouvé la liste de révocation de certificats dans le magasin de certificats deMicrosoft Windows. Pour corriger l'erreur, omettez la vérification de la liste derévocation de certificats (définissez LDAPSkipSSLCRLVerification=T) ou importezla liste de révocation de certificats de l'autorité de certification dans le magasin decertificats de Microsoft Windows.LDAP ERROR: 0x80092012 - Error verifying server certificate chain validityLDAP ERROR: Error verifying server certificate no match for <server>LDAP ERROR: 0x51 - ldap_connect failed.

Utilisation de la sécurité Cognos avec Cognos TM1Vous pouvez utiliser la sécurité IBM Cognos avec IBM Cognos TM1.

Pour des détails complets sur les concepts, la terminologie et la mise en oeuvre dela sécurité Cognos, reportez-vous au document Cognos - Administration et sécurité.

Présentation de la sécurité CognosIBM Cognos TM1 Server peut authentifier les utilisateurs avec la sécurité IBMCognos.

La sécurité Cognos est un composant de la structure IBM Cognos qui gère l'accèsdes utilisateurs aux données. La sécurité Cognos gère les autorisations etl'authentification via des fournisseurs de sécurité tiers, tels que LDAP ou ActiveDirectory. Lorsqu'un utilisateur est authentifié par la sécurité Cognos, il reçoit un"passeport" de sécurité Cognos. Ce passeport est alors utilisé par les applicationsCognos TM1 pour déterminer les droits (rôle et affiliation à un groupe) et l'identitéde l'utilisateur.

Lorsque la sécurité Cognos est utilisée, un passeport Cognos est requis pour laconnexion à Cognos TM1. Un écran de connexion s'affiche. L'utilisateur doit yentrer un espace-noms, un nom d'utilisateur et un mot de passe lorsqu'il se


connecte pour la première fois à Cognos TM1 ou à tout autre composant Cognossécurisé. Une fois l'authentification par la sécurité Cognos terminée, un passeportest délivré à l'utilisateur. Ce passeport fournit automatiquement les informations deconnexion de l'utilisateur lors de l'accès à n'importe quelle application Cognossécurisée (y compris Cognos TM1). Lorsqu'un utilisateur se connecte au serveurCognos TM1 via un serveur Cognos spécifique configuré pour une connexioncommune, aucune intervention directe de la part de l'utilisateur n'est requise pouraccéder à d'autres serveurs Cognos TM1 (ou d'autres applications Cognos)configurés pour référencer le même serveur Cognos.

Lorsqu'un utilisateur tente d'accéder au serveur Cognos TM1, le serveur valide lepasseport pour authentifier l'utilisateur. Il interroge pour cela un serveur Cognospour obtenir l'identité du passeport. Si le passeport est valide, la requête retourneun ensemble d'informations de sécurité et d'authentification pour l'utilisateur. Cesinformations contiennent les rôles et groupes auxquels l'utilisateur est affilié, ainsique le compte (nom d'utilisateur) associé au passeport. Si le nom d'utilisateurexiste déjà dans Cognos TM1, ses affiliations sont validées sur la base des groupesCognos TM1 existants. Si l'utilisateur n'existe pas, il est ajouté et affecté auxgroupes d'utilisateurs appropriés sur le serveur Cognos TM1.

Si un utilisateur exécute le programme client en tant qu'administrateur (en cliquantavec le bouton droit de la souris sur le nom de fichier du programme et ensélectionnant Exécuter en tant qu'administrateur), deux nouveaux dossiers sontcréés après la connexion du client à CAM :v répertoire_installation\configuration

Ce dossier contient le fichier C8ITK.ini.v répertoire_installation\logs

Ce dossier contient le fichier C8ITK.log, le cas échéant.

Par défaut, le fichier C8ITK.ini définit qu'aucun fichier journal n'est créé dans ledossier logs, sauf en cas d'erreur. Vous pouvez éditer le fichier C8ITK.ini si vousvoulez avoir des fichiers journaux. Vous pouvez également modifier le nom dufichier journal en éditant la section LogFilePath. Pour que vos modifications soientprises en compte, vous devez redémarrer les services Cognos.

Configuration de la sécurité Cognos dans TM1 ServerVous pouvez configurer l'utilisation de l'authentification fournie par la sécuritéIBM Cognos dans le serveur IBM Cognos TM1 à la place de l'authentification TM1standard utilisée par défaut.

Avant de commencer

Ces procédures ne pourront aboutir que si la configuration de votre serveur IBMCognos n'autorise pas l'accès anonyme. Si l'accès anonyme est activé sur le serveurIBM Cognos, la connexion à un espace-noms à partir de TM1 est impossible lorsde l'importation de groupes Cognos dans TM1.


Pour activer l'authentification de sécurité IBM Cognos sur le serveur IBM CognosTM1, vous devez ajouter ou modifier plusieurs paramètres de configuration dansle fichier de configuration du serveur Tm1s.cfg.

Remarque : Si vous voulez reconfigurer un serveur TM1 utilisant déjà la sécuritéCognos pour lui faire utiliser une autre instance de Cognos, vous devez retirer les


utilisateurs et les groupes Cognos existants qui ont été importés depuis la premièreinstance de Cognos, puis importer les groupes et les utilisateurs de la nouvelleinstance.

Procédure1. Ouvrez le fichier de configuration Tm1s.cfg dans un éditeur de texte.

Le fichier Tm1s.cfg se trouve dans le répertoire de données du serveur TM1.Pour plus d'informations, voir Annexe A, «Fichier de configuration du serveurtm1s.cfg», à la page 311.

2. Modifiez ou ajoutez les paramètres suivants dans le fichier de configuration.

Tableau 28. Paramètres de configuration du serveur TM1 pour la sécurité Cognos

Nom du paramètre Description

ServerCAMURI URI du distributeur interne que le serveur TM1 doit utiliserpour se connecter à la sécurité IBM Cognos. L'URI est indiquésous la forme

http[s]://host IP address:port/p2pd/servlet/dispatch

Exemples :

http://10.121.25.121:9300/p2pd/servlet/dispatch

https://10.121.25.121:9300/p2pd/servlet/dispatch

Remarque : Pour trouver l'URI, demandez à l'administrateurd'IBM Cognos de réaliser les opérations suivantes :

1. Sur le système qui héberge IBM Cognos, ouvrez IBM CognosConfiguration.

2. Cliquez pour développer le noeud Environnement.

3. Dans la sous-fenêtre Propriétés, localisez la sectionParamètres du répartiteur et utilisez la valeur de la propriétéURI externe du répartiteur ou URI interne du répartiteur.

ClientCAMURI URI d'IBM Cognos Server définie dans IBM Cognos Connectionet permettant d'authentifier les clients TM1. L'URI est indiquésous la forme :

http[s]://host/ibmcognos/cgi-bin/cognos.cgi

Remarque : Les valeurs de hôte, d'ibmcognos et de cognos.cgi sontvariables et dépendent des paramètres qui ont été utilisés.Contactez l'administrateur d'IBM Cognos pour plusd'informations sur ces paramètres.

Par exemple : http://10.121.25.121/ibmcognos/cgi-bin/cognos.cgi

Si le système Cognos utilise Microsoft Internet InformationServices (IIS):

http://10.121.25.121/ibmcognos/cgi-bin/cognosisapi.dll

CAMSSLCertificate Chemin d'accès complet et nom du certificat SSL à utiliser lorsde la connexion au distributeur interne.

Par exemple : C:\AxTM1\Install_Dir\ssl\CognosCert.cer

Ce paramètre n'est requis que si le serveur IBM Cognos estconfiguré pour utiliser SSL.


Tableau 28. Paramètres de configuration du serveur TM1 pour la sécurité Cognos (suite)


SkipSSLCAMHostCheck Indique si le processus de confirmation de l'ID du certificat SSLpeut être omis. La valeur par défaut est FALSE.

Important : Ce paramètre ne doit être défini sur TRUE que si uncertificat générique est utilisé à des fins de démonstration.

ClientPingCAMPassport Indique l'intervalle, en secondes, pendant lequel un client doitenvoyer une commande ping au serveur IBM Cognos pourmaintenir son passeport actif.

Si une erreur se produit ou si le passeport expire, l'utilisateur estdéconnecté du serveur TM1.

Exemple : ClientPingCAMPassport=900

CAMPortalVariableFile Chemin du fichier variables_TM1.xml dans l'installation Cognos.Dans la plupart des cas, ce chemin est :

CAMPortalVariableFile = portal\variables_TM1.xml

Le fichier variables_TM1.xml est inclus pour les iWidgets TM1.Pour obtenir des informations détaillées sur l'installation et laconfiguration des iWidgets, voir «iWidgets Cognos TM1 etCognos Workspace», à la page 64.

Le paramètre CAMPortalVariableFile n'est requis qu'en casd'exécution sur TM1 Web.

Le fichier Tm1s.cfg doit contenir des paramètres similaires à ceux-ci :ServerCAMURI=http://10.111.25.121:9300/p2pd/servlet/dispatchClientCAMURI=http://10.111.25.121/cognos_location/cgi-bin/cognos.cgiClientPingCAMPassport=900CAMPortalVariableFile=templates\ps\portal\variables_TM1.xml

3. Définissez le paramètre IntegratedSecurityMode sur son mode par défaut : 1.IntegratedSecurityMode=1

Remarque : La valeur 1 pour le paramètre IntegratedSecurityMode vouspermet d'effectuer des tâches de configuration supplémentaires dans TM1 avecla sécurité TM1 standard avant de passer à la sécurité Cognos. Une fois cestâches terminées, vous pouvez définir la valeur 4 ou 5 pour ce paramètre pourutiliser la sécurité Cognos.

4. Enregistrez et fermez le fichier Tm1s.cfg.5. Redémarrez le serveur Cognos TM1.6. Effectuez les opérations requises pour votre installation Cognos Analytics.v Définissez un utilisateur Cognos en tant qu'administrateur Planning

Analytics.v Importez les groupes Cognos dans Planning Analytics.Pour plus d'informations, voir «Gestion des utilisateurs, des groupes et desobjets TM1 lorsque la sécurité Cognos est utilisée», à la page 261.

7. Configurez le serveur Cognos TM1 pour qu'il démarre avec l'authentificationCognos.a. Arrêtez le serveur Cognos TM1.b. Ouvrez le fichier de configuration Tm1s.cfg dans un éditeur de texte.c. Définissez le paramètre IntegratedSecurityMode pour indiquer que le

serveur doit utiliser l'authentification Cognos.


La valeur exacte du paramètre dépend des composants Cognos TM1 quevous utilisez :v Si vous n'utilisez pas le composant Cognos TM1 Applications, définissez

ce paramètre sur 4.IntegratedSecurityMode=4

v Si vous utilisez Cognos TM1 Applications avec la sécurité Cognos,définissez ce paramètre sur 5 de façon à prendre en charge les groupesd'utilisateurs de Planning Analytics et Cognos.IntegratedSecurityMode=5

d. Enregistrez et fermez le fichier Tm1s.cfg.e. Redémarrez le serveur Cognos TM1.

Que faire ensuite

Consultez les rubriques suivantes pour terminer la configuration :v «Configuration de la sécurité Cognos dans les clients Cognos TM1», à la page

263v «Configuration de Cognos TM1 Web pour l'utilisation de la sécurité Cognos», à

la page 264v «Utilisation de Cognos TM1 Applications avec la sécurité Cognos», à la page 266

Accès anonyme sur le serveur Cognos TM1 et sécurité Cognos :

Pour pouvoir définir les paramètres et les procédures de configuration de manièreà activer l'authentification de sécurité IBM Cognos sur le serveur IBM CognosTM1, vous devez interdire l'accès anonyme sur le serveur Cognos.

Si l'accès anonyme est activé sur le serveur Cognos, la connexion à un espace-nomsà partir de Cognos TM1 est impossible lors de l'importation de groupes Cognosdans Cognos TM1.

Gestion des utilisateurs, des groupes et des objets TM1 lorsquela sécurité Cognos est utilisée

Définition d'un utilisateur Cognos en tant qu'administrateur Cognos TM1 :

Pour pouvoir administrer IBM Cognos TM1 tout en utilisant la sécurité IBMCognos Analytics pour l'authentification, vous devez ajouter un utilisateur Cognosexistant au groupe ADMIN de Cognos TM1.

Cet utilisateur Cognos sera utilisé pour importer des groupes Cognos dans CognosTM1.

Important : Les étapes initiales de cette configuration doivent être réalisées avec lavaleur 1 pour le paramètre IntegratedSecurityMode de Cognos TM1. Vousmodifierez ce paramètre à une étape ultérieure du processus pour utiliser lasécurité Cognos Analytics.

Procédure

1. Connectez-vous à Cognos TM1 en tant qu'administrateur.2. Dans l'explorateur de serveur, cliquez sur Serveur > Sécurité >

Clients/Groupes.


3. Dans la boîte de dialogue Clients/Groupes, cliquez sur Clients > Ajouter unnouveau client.La boîte de dialogue de connexion à Cognos s'affiche.

4. Entrez vos ID d'utilisateur Cognos et mot de passe, puis cliquez sur OK.5. Dans la zone Nom, cliquez sur l'espace-noms auquel vous êtes actuellement

connecté.

Remarque : Seuls les utilisateurs de l'espace-noms auquel vous êtes connectépeuvent être importés dans Cognos TM1. D'autres espaces-noms peuventapparaître dans la zone Nom, mais vous ne pouvez pas en importer lesutilisateurs.Le contenu de la zone Nom est actualisé pour afficher les répertoiresdisponibles sur l'espace-noms sélectionné.

6. Activez l'option Afficher les utilisateurs de la liste.7. Accédez au répertoire contenant l'utilisateur Cognos à définir comme

administrateur de Cognos TM1. Dans la plupart des cas, vous définirez votrepropre utilisateur Cognos comme administrateur de Cognos TM1, car vousdevez connaître l'ID utilisateur et le mot de passe Cognos pour pouvoireffectuer des tâches d'administration.

8. Sélectionnez l'utilisateur.

9. Cliquez sur l'icône pour placer l'utilisateur sélectionné dans la liste Entréessélectionnées.

10. Cliquez sur OK pour importer l'utilisateur Cognos dans Cognos TM1.L'utilisateur apparaît en tant que nouveau client dans la fenêtreClient/Groupes mais n'est affecté à aucun groupe Cognos TM1.

11. Affectez le nouvel utilisateur au groupe ADMIN et cliquez sur OK.12. Arrêtez le serveur Cognos TM1.13. Ouvrez le fichier de configuration Tm1s.cfg dans un éditeur de texte.14. Définissez le paramètre IntegratedSecurityMode pour indiquer que le serveur

doit utiliser l'authentification IBM Cognos. La valeur exacte du paramètredépend des composants Cognos TM1 que vous utilisez :v Si vous n'utilisez pas le composant Cognos TM1 Applications, définissez ce

paramètre sur 4.IntegratedSecurityMode=4

v Si vous utilisez Cognos TM1 Applications avec la sécurité Cognos,définissez ce paramètre sur 5 de façon à prendre en charge les groupesd'utilisateurs Cognos TM1 et Cognos.IntegratedSecurityMode=5

15. Enregistrez et fermez le fichier TM1s.cfg.16. Redémarrez le serveur Cognos TM1.

Importation de groupes Cognos dans Cognos TM1 :

Une fois qu'un utilisateur IBM Cognos est défini comme administrateur de CognosTM1, il peut importer des groupes Cognos dans Cognos TM1.

N'importez que les groupes Cognos auxquels vous souhaitez accorder l'accès auserveur Cognos TM1.


Procédure

1. Dans l'explorateur de serveur, cliquez deux fois sur votre serveur Cognos TM1.La boîte de dialogue de connexion à Cognos s'affiche.

2. Connectez-vous sous l'utilisateur Cognos que vous avez défini commeadministrateur de Cognos TM1.

3. Dans l'explorateur de serveur, cliquez sur Serveur, Sécurité, puis surClients/Groupes.

4. Dans la fenêtre Clients/Groupes, cliquez sur Groupes, puis sur Ajouter unnouveau groupe.

5. Dans la zone Noms, cliquez sur l'espace-noms auquel vous êtes actuellementconnecté.

Remarque : Seuls les groupes de l'espace-noms auquel vous êtes connectépeuvent être importés dans Cognos TM1. D'autres espaces-noms peuventapparaître dans la zone Nom, mais vous ne pouvez pas en importer lesgroupes.

6. Parcourez la structure de répertoires et sélectionnez les groupes Cognos quevous voulez importer dans Cognos TM1.

7. Cliquez sur l'icône pour placer l'utilisateur sélectionné dans la liste Entréessélectionnées.

8. Cliquez sur OK pour importer les groupes Cognos dans Cognos TM1.Si vous passez en revue la section Affectation de groupe d'utilisateur de lafenêtre Clients/Groupes, vous constatez que les groupes Cognos ont été ajoutésà votre serveur.

Création d'utilisateurs TM1 lors de l'utilisation de la sécurité Cognos :

Lorsque le serveur IBM Cognos TM1 est configuré en vue de l'utilisation del'authentification Cognos, vous ne pouvez pas créer de clients directement sur leserveur Cognos TM1.

Toute l'administration des clients s'effectue dans le cadre de la sécurité Cognos.

Lorsqu'un utilisateur Cognos accède à Cognos TM1, il est validé etautomatiquement affecté aux groupes Cognos TM1 appropriés. Il n'est pasnécessaire d'affecter manuellement des utilisateurs aux groupes dans Cognos TM1.

Administration de la sécurité des objets Cognos TM1 lorsque la sécuritéauthentifiée Cognos est utilisée :

Alors que l'authentification IBM Cognos gère automatiquement les utilisateurs surle serveur IBM Cognos TM1, l'administrateur de Cognos TM1 doit encore gérer lasécurité des objets pour permettre aux utilisateurs Cognos d'afficher et d'utiliserdes objets Cognos TM1.

Pour des détails sur l'administration de la sécurité des objets Cognos TM1, voir larubrique sur la sécurité Cognos dans la documentation TM1 Developer.

Configuration de la sécurité Cognos dans les clients CognosTM1Vous devez ajouter deux paramètres au fichier Tm1p.ini afin de pouvoir effectuerles tâches administratives relatives à la sécurité IBM Cognos depuis votre clientCognos TM1.


Procédure1. Ouvrez le fichier de configuration Tm1p.ini dans un éditeur de texte.

Pour connaître l'emplacement du fichier Tm1p.ini, voir «Emplacement dufichier Tm1p.ini», à la page 377.

2. Ajoutez les paramètres suivants au fichier Tm1p.ini.

Tableau 29. Paramètres du fichier Tm1p.ini


CognosGatewayURI URI de la passerelle Cognos Analytics. L'URI est indiqué sousla forme

http[s]://hôte/emplacement_cognos/cgi-bin/cognos.cgi

Par exemple : http://10.121.25.121/cognos_location/cgi-bin/cognos.cgi

AllowImportCAMClients Détermine si les clients Cognos peuvent être importés dansCognos TM1. Ce paramètre doit avoir pour valeur T lors de laconfiguration de la sécurité Cognos dans Cognos TM1.

Votre fichier Tm1p.ini doit inclure des paramètres similaires à ceux figurantci-après :AllowImportCAMClients = T

CognosGatewayURI = http://10.111.25.121/cognos_location/cgi-bin/cognos.cgi

3. Enregistrez et fermez le fichier Tm1p.ini.4. Redémarrez votre client Cognos TM1.

Configuration de Cognos TM1 Web pour l'utilisation de lasécurité CognosSuivez la procédure ci-dessous pour configurer la sécurité authentifiée d'IBMCognos dans IBM Cognos TM1 Web.

Avant de commencer

Remarque : Si vous avez appliqué un kit de mise à jour Cognos Analytics à votreinstallation Analytics, il se peut que vous deviez apporter des modificationsspécifiques au fichier tm1web.html.

Le fichier tm1web.html permet à Cognos TM1 Web d'utiliser la sécurité authentifiéeIBM Cognos. Cependant, il n'est pas mis à jour lorsque vous appliquez un kit demise à jour Cognos Analytics. A la place, un fichier mis à jour appelétm1web.html.new est placé dans le même répertoire Cognos Analytics...\webcontent\tm1\web que le fichier d'origine. Utilisez la dernière version dufichier tm1web.html et entrez-y les modifications que vous avez faites dans lefichier tm1web.html d'origine.


Les opérations suivantes consistent à éditer les fichiers de configuration sur lesystème Cognos TM1 Web et à les copier sur le système Cognos Analytics.

Procédure1. Localisez les fichiers passerelle Cognos TM1 Web et décompressez-les dans le

répertoire d'installation de Cognos TM1 Web.


variables_TM1.xmlCe fichier se trouve dans le répertoire templates\ps\portal.

tm1web.htmlCe fichier se trouve dans le répertoire webcontent\tm1\web.

Ces fichiers sont compressés dans le fichier bi_interop.zip qui se trouve àl'emplacement suivant :\<répertoire_installation_TM1>\bi_interop\

Exemple :C:\Program Files\IBM\cognos\tm1_64\bi_interop\

2. Copiez les fichiers dans votre installation d'IBM Cognos Analytics.

variables_TM1.xmlCopiez ce fichier dans <emplacement Cognos>\templates\ps\portal surchacun des serveurs sur lesquels le niveau TM1 Web s'exécute dansvotre système IBM Cognos Analytics.

tm1web.htmlCopiez ce fichier dans <emplacement Cognos>\webcontent\tm1\web surchacun des serveurs sur lesquels la passerelle Cognos Analyticss'exécute dans votre système IBM Cognos Analytics.

3. Editez le fichier tm1web.html et faites-le pointer vers l'emplacement dans lequelCognos TM1 Web s'exécute.var tm1webServices = ["http://SystemName:PortNumber"];

Exemple :var tm1webServices = ["http://mysystem:9510"];

Configuration de la sécurité Cognos dans Cognos TM1Operations ConsoleVous pouvez configurer IBM Cognos TM1 Operations Console pour qu'il utilise lasécurité IBM Cognos Analytics, également appelée authentification Cognos AccessManager (CAM).

Avant de commencer

La sécurité IBM Cognos Analytics doit être configurée sur au moins un serveurTM1. Ceci est nécessaire pour stocker les informations des groupes d'utilisateurd'Operations Console. Vous devez connaître le nom de ce serveur TM1 pourréaliser la procédure décrite dans cette rubrique. Pour obtenir plus de détails etconnaître la procédure de configuration, voir «Utilisation de la sécurité Cognosavec Cognos TM1», à la page 257 et «Configuration de la sécurité Cognos dansTM1 Server», à la page 258.


Pour configurer Operations Console afin qu'il utilise la sécurité IBM CognosAnalytics, utilisez les fichiers qui se trouvent sur les ordinateurs hébergant cesdeux composants.

Procédure1. Ouvrez Performance Management Hub en accédant à http://<hôte>:9510/

pmhub/pm/admin.2. Développez Configurations >

com.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor.


3. Cliquez surcom.ibm.ba.pm.opsconsole.monitor.tm1.TM1OpsConsoleMonitor.dictonary.

4. Vérifiez les valeurs des zones DefaultAdminHost, DefaultGroup etDefaultServer. Voir «Configuration de Cognos TM1 Operations Console», à lapage 104.

5. Développez com.ibm.ba.pm.resource.security.6. Cliquez sur com.ibm.ba.pm.resource.security.dictonary.7. Définissez CAMGatewayURL sur la passerelle du serveur Cognos Analytics.

Vous pouvez trouver cette valeur dans Cognos Configuration sousEnvironnement > URI de la passerelle. La valeur du paramètre ClientCAMURIdu fichier tm1s.cfg doit être identique. Par exemple : http://host.domain.com/ibmcognos/cgi-bin/cognos.cgi

8. Définissez CAMBIURL sur l'URL du répartiteur du serveur Cognos Analytics.Vous pouvez trouver cette valeur dans Cognos Configuration sousEnvironnement > URI externe du répartiteur. La valeur du paramètreServerCAMURI du fichier tm1s.cfg doit être identique. Par exemple :http://host.domain.com:9300/p2pd/servlet/dispatch

9. Copiez le fichier ..\tm1_64\bi_interop\bi_interop.zip situé dansl'emplacement d'installation de TM1 à la racine du répertoire d'installation duserveur Cognos Analytics (le répertoire ..\c10_64). Si vous utilisez unenvironnement de serveurs Cognos Analytics répartis, copiez ce fichier surl'ordinateur qui exécute le niveau de données TM1 ou le niveau Web TM1.

10. Décompressez bi_interop.zip en conservant la structure de répertoires. Lefichier pmhub.html doit se trouver dans le répertoire ..\c10_64\webcontent.

11. Editez la ligne 51 du fichier pmhub.html pour y inclure le nom de domainecomplet et le numéro de port du service IBM Cognos TM1 Applications quifonctionne sur TM1 Operations Console.v Si vous utilisez le serveur Web WebSphere Liberty Liberty Profile fourni

avec TM1, il s'agit du serveur sur lequel TM1 Application Server est encours d'exécution.

v Si vous utilisez votre propre serveur Web, il s'agit du serveur sur lequelvous avez déployé pmhub.war.

Par exemple :var pmhubURLs = ["http://tm1appshost.domain.com:9510"];

Vous pouvez également inclure plusieurs adresses URL si TM1 OperationsConsole est utilisé sur plusieurs systèmes. Par exemple :var pmhubURLs = ["http://tm1appshost1.domain.com:9510","http://tm1appshost2.domain.com:9510"];

Utilisation de Cognos TM1 Applications avec la sécurité CognosVous pouvez configurer IBM Cognos TM1 Applications de sorte qu'il utilise lasécurité IBM Cognos Analytics. Cette configuration nécessite que l'utilisateur seconnecte à Cognos TM1 Applications en tant qu'utilisateur valide existant sur leserveur Cognos Analytics. Cette configuration intègre également Cognos TM1Applications et Cognos Analytics en affichant des liens vers les applicationsCognos TM1 dans le portail IBM Cognos Connection.

Lorsque vous utilisez Cognos TM1 Applications avec la sécurité Cognos Analytics,le serveur d'applications Cognos TM1 peut être hébergé sur un serveurd'applications Web de l'une des manières suivantes :v Sur un autre ordinateur avec le serveur WebSphere Liberty fourni avec

l'installation Cognos TM1


v Sur un autre ordinateur avec votre propre installation d'Apache Tomcat oud'IBM Websphere.

Dans tous les cas, vous devez éditer le fichier planning.html et le copier sur leserveur Cognos Analytics pour que ce dernier connaisse l'emplacement du serveurCognos TM1 Application.

Remarque : La variable d'environnement TM1_PATH doit être définie avantl'établissement d'une connexion à Cognos TM1 dans un environnement UNIX.

Configuration de Cognos TM1 Applications de sorte qu'il utilise la sécuritéCognos Analytics :

Pour configurer IBM Cognos TM1 Applications afin qu'il utilise la sécurité IBMCognos Analytics, utilisez les fichiers qui se trouvent sur les ordinateurs hébergantces deux composants et sur l'ordinateur sur lequel Cognos TM1 Server est exécuté.Cette configuration active également, dans le portail IBM Cognos Connection,l'affichage de liens vers les applications qui permettent aux utilisateurs de seconnecter à celles-ci depuis le portail, selon les droits dont ils disposent.

Avant de commencer

Le serveur Cognos TM1 doit être configuré de manière à utiliser la sécurité CognosAnalytics.

Si vous voulez utiliser Cognos TM1 Applications avec la sécurité Cognos Analytics,vous devez affecter la valeur 5 au paramètre IntegratedSecurityMode du fichier deconfiguration Tm1s.cfg de Cognos TM1 pour qu'il prenne en charge les groupesd'utilisateurs de Cognos TM1 et de Cognos Analytics.

Pour obtenir plus de détails et connaître la procédure de configuration, voir«Utilisation de la sécurité Cognos avec Cognos TM1», à la page 257 et«Configuration de la sécurité Cognos dans TM1 Server», à la page 258.

Remarque : Vous devez configurer la variable d'environnement TM1_PATH avantd'établir une connexion à Cognos TM1 dans un environnement UNIX.

Procédure

1. Décompressez le contenu du fichier bi_interop.zip dans l'installation CognosAnalytics existante.

Remarque : A partir de Cognos TM1 version 10.2.2, le fichier bi_interop.zipremplace le fichier planning_gateway.zip qui était fourni avec les versionsprécédentes de Cognos TM1.a. Localisez le fichier bi_interop.zip livré avec l'installation Cognos TM1 à

l'emplacement suivant.installation Cognos TM1\bi_interop\

b. Décompressez et fusionnez le contenu du fichier bi_interop.zip dans lerépertoire racine de l'installation Cognos Analytics existante.Par exemple : C:\Program Files\IBM\cognos\c10_64\

Remarque : Le fichier bi_interop.zip contient une structure de répertoiresqui fusionne les fichiers dans les sous-répertoires \templates et\webcontent.


c. Pour extraire manuellement et copier les fichiers dans l'installation CognosAnalytics, suivez les consignes ci-dessous :Si vous utilisez un environnement de serveurs Cognos Analytics répartis,copiez ces fichiers sur l'ordinateur qui exécute le niveau de données TM1 oule niveau Web TM1, comme suit :

planning.htmlCopiez planning.html dans répertoire d'installationC10\webcontent sur la machine sur laquelle la passerelle CognosAnalytics est installée.

icon_active_application.gifCopiez icon_active_application.gif dans répertoired'installation C10\webcontent\ps\portal\images sur la machinesur laquelle la passerelle Cognos Analytics est installée.

variables_plan.xmlCopiez variables_plan.xml dans répertoire d'installationC10\templates\ps\portal sur les machines comportant un serveurCognos Analytics sur lequel s'exécute le service de présentation(groupe de serveurs d'applications).

Remarque : Ces fichiers sont également installés avec les installationsCognos Analytics récentes. Si les fichiers existent déjà sur le serveur CognosAnalytics, il vous suffit de les modifier comme indiqué ci-dessous.

2. Editez le fichier planning.html.

Important : Dans ce fichier, les valeurs du paramètre planningServicesgarantissent que le serveur Cognos Analytics réachemine les utilisateursuniquement vers des emplacements autorisés. L'emplacement du serveurd'applications Cognos TM1 à partir duquel l'utilisateur se connecte doit figurerdans ce fichier en tant qu'emplacement autorisé. Dans le cas contraire, leserveur Cognos Analytics ne redirige pas l'utilisateur.a. Ouvrez le fichier planning.html et localisez les lignes suivantes :

// Update the following to point to the location of the planningservice(s)

var planningServices = ["http://machine.company.com:9510"];

b. Entrez comme valeur du paramètre planningServices l'emplacement et lenuméro de port du serveur d'applications Cognos TM1.var planningServices = ["http://web_server_address:port_number"];

Remplacez web_server_address par le nom de domaine complet (FQDN) de lamachine sur laquelle Cognos TM1 Application Server s'exécute. Parexemple, myhost.example.comv Si vous exécutez Cognos TM1 Application Server avec le serveur

WebSphere Liberty fourni avec l'installation Cognos TM1 :var planningServices = ["http://web_server_address:9510"];

v Si vous exécutez Cognos TM1 Application Server avec votre propreserveur d'applications Web, utilisez l'emplacement et le numéro de portde ce système.

Conseil : Si vous utilisez le même serveur Cognos Analytics pourauthentifier différentes instances de Cognos TM1 Applications s'exécutantsur différents postes, utilisez la liste des noms de domaine complets(FQDN) de chaque ordinateur, séparés par des virgules. Par exemple :


var planningServices = ["http://machine1.example.com:port_number","http://machine2.example.com:port_number"];

Conseil : Si Cognos TM1 Application Server s'exécute sur un serveur Webappartenant à plusieurs domaines, utilisez la liste des noms de domainecomplets de chaque domaine, séparés par des virgules. Par exemple :

var planningServices = ["http://computer_A.domain_1:port_number","http://computer_A.domain_2:port_number","http://computer_A.domain_3:port_number"];

c. Enregistrez et fermez le fichier planning.html.3. Configurez les paramètres de délai d'attente de session de Cognos TM1

Applications et de la sécurité Cognos Analytics pour garantir la bonnedétection du dépassement.Pour plus d'informations, voir «Configuration des valeurs de délai d'attente desession pour Cognos TM1 Applications et la sécurité Cognos Analytics», à lapage 270.

4. Redémarrez le serveur Cognos Analytics.5. Configurez Cognos TM1 Applications en entrant des valeurs pour les

paramètresIBM Cognos Gateway URI et IBM Cognos Dispatcher URI .a. Ouvrez Cognos TM1 Applications en utilisant le format du lien suivant :

http://web_server_name:port_number/pmpsvc

Par exemple : http://localhost:9510/pmpsvcb. Connectez-vous et ouvrez la page Configuration de Cognos TM1

Applications :v Si vous exécutez Cognos TM1 Applications pour la première fois,

cette page s'ouvre dès que vous êtes connecté.v Si vous avez déjà configuré Cognos TM1 Applications, ouvrez la page

Configuration en cliquant sur l'icône Administrer IBM Cognos TM1

Applications dans la barre d'outils du portail TM1 Applications.c. Sur la page de Configuration de TM1 Applications, saisissez les valeurs des

paramètres Cognos TM1 et Cognos Analytics suivants :v Entrez des valeurs dans les zones Hôte Admin de TM1 et Nom du

serveur et configurez les options pour les clients de contribution dedonnées à utiliser. Pour plus d'informations, voir «Configuration desenvironnements client et serveur de Cognos TM1 Application Web», à lapage 138.

v Définissez le paramètre URI de la passerelle IBM Cognos. Par exemple :http://CognosServerName/ibmcognos/bi/v1/disp

v Définissez le paramètre URI du répartiteur IBM Cognos. Par exemple :http://CognosServerName:9300/p2pd/servlet/dispatch

Remplacez CognosServerName par le nom du système sur lequel le serveurWeb Cognos Analytics est exécuté.

6. Pour tester la configuration, connectez-vous à Cognos TM1 Applications àl'aide d'un navigateur Web sur un ordinateur distant.Si vous voyez l'erreur suivante, vérifiez le réglage du paramètreplanningServices dans le fichier planning.html sur le serveur CognosAnalytics.


The planning service parameter was not specified or is notone of the configured locations

Configuration des valeurs de délai d'attente de session pour Cognos TM1Applications et la sécurité Cognos Analytics :

Lors de l'utilisation d'IBM Cognos TM1 Applications avec la sécurité IBM Cognos,attribuez au délai d'attente de session pmpsvc une valeur supérieure à celle dudélai d'attente de session CAM pour garantir la bonne détection du délai. Si lavaleur du délai d'attente de session de Cognos TM1 Applications (pmpsvc) estinférieure à celle du délai d'attente de session de la sécurité Cognos Analytics(CAM), Cognos TM1 Applications ne détecte pas correctement l'arrêt des sessionsCAM et ne se termine pas.


Pour garantir la bonne détection de la fin d'une session CAM par Cognos TM1Applications, affectez au délai d'attente de session pmpsvc une valeur supérieure àcelle du délai d'attente de session CAM.v Le délai d'attente de session pmpsvc est le nombre de minutes d'inactivité après

lequel Cognos TM1 Applications met fin à la session d'un utilisateur. La valeurpar défaut est 60 minutes (1 heure).

v Le délai d'attente de session CAM est le nombre de secondes d'inactivité aprèslequel la sécurité Cognos met fin à la session d'un utilisateur. La valeur pardéfaut est 3600 secondes (1 heure).

Procédure

1. Configurez le paramètre de délai d'expiration de la session pmpsvc.a. Localisez le fichier fpmsvc_config.xml dans le répertoire

WEB-INF/configuration.v Lorsque Cognos TM1 Applications est déployé avec le serveur WebSphere

Liberty fourni dans l'installation Cognos TM1, le fichierfpmsvc_config.xml se trouve dans ce répertoire :répertoire d'installation Cognos TM1\webapps\pmpsvc\WEB-INF\configuration

v Lorsque Cognos TM1 Applications est déployé avec Apache Tomcat, lefichier se trouve dans ce répertoire :C:\Program Files\Apache Software Foundation\Tomcat numéro deversion\webapps\pmpsvc\WEB-INF\configuration

b. Entrez une valeur pour l'attribut timeout de l'élément service/session.Utilisez pour l'attribut service/session/timeout le format défini dans lefichier de définition de schéma XML fpmsvc_config.xsd situé dans le mêmerépertoire.Par exemple :<session timeout=“60”/>

2. Sur le système Cognos Analytics, configurez le délai d'attente de session CAMà l'aid d'IBM Cognos Configuration.Entrez une valeur dans la zone Délai maximal d'inactivité (en secondes) de lasection Sécurité/Authentification de Cognos Configuration.


Considérations à prendre en compte par les administrateurs lorsde l'utilisation de l'authentification CognosLes administrateurs IBM Cognos TM1 doivent être conscients des problèmespouvant survenir lors de la configuration du serveur Cognos TM1 en vue del'utilisation de l'authentification IBM Cognos.

Les problèmes sont les suivants :v Lisez la description des modes de sécurité 4 et 5 de Cognos TM1 pour le

paramètre IntegratedSecurityMode. Vous devez comprendre la façon dont cesdifférents modes contrôlent l'appartenance ou la non-appartenance desutilisateurs Cognos à des groupes d'utilisateurs Cognos TM1. Pour des détails,voir la description du paramètre IntegratedSecurityMode dans TM1 Operations.

v Vous ne pouvez pas utiliser Cognos TM1 pour affecter un utilisateur Cognos àun autre groupe Cognos de façon permanente. Les affectations d'utilisateurs àun groupe Cognos, que vous effectuez dans Cognos TM1, ne sont pasenregistrées dans Cognos. Lorsqu'un utilisateur Cognos se connecte à CognosTM1, les affectations de groupe de Cognos remplacent les affectations à desgroupes Cognos effectuées dans Cognos TM1.

v Si vous renommez un utilisateur Cognos après l'avoir importé dans CognosTM1, vous devez supprimer l'utilisateur dans Cognos TM1 pour mettre à jourCognos TM1 avec le nouveau nom d'utilisateur. Une fois l'utilisateur supprimédans Cognos TM1, le nouveau nom apparaît à la prochaine connexion de cetutilisateur.

Considérations à prendre en compte par les utilisateurs lors del'utilisation de l'authentification CognosLes utilisateurs d'IBM Cognos TM1 doivent prendre connaissance des problèmespouvant survenir lors de l'accès au serveur Cognos TM1 configuré en vue del'utilisation de l'authentification IBM Cognos.

Comportement de l'authentification :

Des règles régissent le comportement de l'authentification lors de la connexion àune instance d'IBM Cognos TM1 utilisant l'authentification IBM Cognos.

Les règles sont les suivantes :v Si la connexion commune est activée dans IBM Cognos, et si vous vous êtes

précédemment connecté à une application IBM Cognos en conservant unesession active, il n'est pas nécessaire d'entrer des données d'identification pour laconnexion à Cognos TM1 Server.

v Si la connexion commune est activée dans IBM Cognos et si vous ne vous êtespas encore connecté à une application IBM Cognos, vous devez entrer vosdonnées d'identification pour la connexion à Cognos TM1 Server.

v Si la connexion commune n'est pas activée dans IBM Cognos, vous êtes invité àentrer vos données d'identification pour la connexion à Cognos TM1, même si ceserveur est configuré pour utiliser l'authentification IBM Cognos.

Sessions de sécurité Cognos privées :

Lorsqu'un serveur IBM Cognos est configuré pour utiliser la connexion commune,vos donnée d'identification ne vous sont demandées qu'une fois.


Par la suite, la connexion à d'autres applications IBM Cognos sécurisées(notamment Cognos TM1) configurées pour référencer le même serveur IBMCognos sera établie automatiquement, à condition que votre passeport de sécuritéCognos soit valide.

Exemple : trois serveurs Cognos TM1 sont disponibles, tous configurés pourutiliser le même serveur IBM Cognos. Une fois que vous êtes connecté au premierserveur sous l'utilisateur X dans l'espace-noms Y, toutes les connexions aux autresserveurs Cognos TM1 sont établies automatiquement à l'aide du passeport del'utilisateur X dans l'espace-noms Y.

Dans certains cas, vous pouvez être amené à vous connecter à un serveur CognosTM1 sous un utilisateur différent de celui identifié par votre passeport de sécuritéCognos. Pour cela, l'option Se connecter sous vous permet de remplacerl'authentification automatique qui a généralement lieu avec un passeport, tout enconservant la validité du passeport pour une utilisation ultérieure. Lorsque vousvous connectez au serveur Cognos TM1 à l'aide de l'option Se connecter sous, unesession privée est établie. Les données d'identification utilisées pour établir lasession privée ne sont pas stockées dans un passeport ni partagées avec une autreapplication. Le passeport existant reste valide et peut être utilisé pour accéder àd'autres applications IBM Cognos sécurisées.

Procédure

1. Dans l'explorateur de serveur, cliquez sur Serveur, puis sur Se connecter sous.2. Dans la fenêtre de connexion Cognos, entrez l'ID utilisateur et le mot de passe

que vous souhaitez utiliser pour vous connecter au serveur Cognos TM1.3. Cliquez sur OK.

Etablissement d'une réplication avec la sécurité Cognos :

Lors de l'établissement d'une connexion de réplication sur le serveur IBM CognosTM1 qui utilise l'authentification IBM Cognos, vous devez fournir l'ID del'espace-noms IBM Cognos.

Ne fournissez pas le nom descriptif de l'espace-noms.

Utilisation de SSL pour la sécurisation de la transmission de donnéesVous pouvez configurer IBM Cognos TM1 pour SSL afin de sécuriser lestransmissions de données.

Présentation de l'utilisation de SSL pour la sécurisation de latransmission de données

Tous les composants IBM Cognos TM1 communiquent avec Cognos TM1 AdminServer à l'aide de SSL.

Le serveur Admin prend en charge des clients Cognos TM1 plus anciens qui nepeuvent pas utiliser SSL en écoutant deux ports (dont un sécurisé). Les clientsCognos TM1 pouvant utiliser SSL se connectent au serveur Admin par le biais duport sécurisé. Les clients plus anciens, incapables d'utiliser SSL, se connectent auserveur Admin par le biais du port non sécurisé.

Quand un serveur Cognos TM1 s'enregistre sur le serveur Admin, il spécifie s'ilutilise SSL ou non. Quand un client Cognos TM1 contacte le serveur Admin, la


liste des serveurs Cognos TM1 disponibles varie selon le port utilisé par le clientpour se connecter au serveur Admin. Si le client utilise le port sécurisé, le serveurAdmin répond avec une liste de tous les serveurs Cognos TM1 disponibles sur leréseau. Si le client utilise le port non sécurisé, le serveur Admin répond avec uneliste limitée aux serveurs Cognos TM1 n'utilisant pas SSL.

Certificats générésLorsque vous installez IBM Cognos TM1, tous les certificats et autres fichiersrequis pour implémenter SSL sont placés dans le répertoire rép_install_TM1\bin\SSL.

Les certificats se trouvant dans ce répertoire sont délivrés par l'autorité decertification Applix, Inc. créée à l'aide de OpenSSL. Le mot de passe utilisé est «applix ».

Lorsque vous installez Cognos TM1, le serveur Admin, le serveur Cognos TM1 etle client Cognos TM1 sont configurés pour utiliser SSL, sur la base des certificatsinstallés dans le répertoire répertoire d'installation de TM1\bin\SSL. Bien que lescertificats Cognos TM1 permettent une implémentation SSL prête à l'emploi, il estconseillé de les remplacer par vos propres certificats (ainsi qu'une liste derévocation de certificats) afin d'optimiser la sécurité. Pour Cognos TM1 Web, tousles certificats racine doivent être installés dans l'espace de stockage de certificatssur l'ordinateur utilisé par les serveurs pour exécuter Cognos TM1 Web.

Figure 12. Utilisation de SSL pour la sécurisation de la transmission de données


Le répertoire répertoire d'installation de TM1\bin\SSL contient les certificats etfichiers suivants. Les fichiers avec l'extension .pem sont au format PrivacyEnhanced Mail. Les fichiers avec l'extension .der sont des « DistinguishedEncoding Rules ».v Applixca.pem - certificat d'autorité racine publiquev Applixcacrl.pem - liste de révocation de certificatsv Applixca.der - certificat d'autorité racine publique au format DER utilisé pour les

espaces de stockage de certificats Javav tm1admsvrcert.pem - certificat de serveur Admin contenant la paire de clés

publique/privéev tm1svrcert.pem - certificat de serveur Cognos TM1 contenant la paire de clés

publique/privéev dh512.pem - fichier contenant la clé 512 bits Diffie-Hellman prégénéréev dh1024.pem - fichier contenant la clé 1024 bits Diffie-Hellman prégénéréev dh2048.pem - fichier contenant la clé 2048 bits Diffie-Hellman prégénéréev tm1store - magasin de certificats Java contenant le certificat d'autorité racine

publiquev tm1cipher.dat - fichier chiffré contenant le mot de passe utilisé pour accéder à la

clé privée du serveurv tm1key.dat - clé utilisée pour chiffrer et déchiffrer tm1cipher.dat

Configuration du serveur Admin de Cognos TM1 pour SSLUtilisez IBM Cognos Configuration pour configurer IBM Cognos TM1 AdminServer pour qu'il utilise SSL.

Ouvrez Cognos Configuration et modifiez les paramètres associés à SSL commeindiqué dans le tableau suivant.


Prise en charge de clients nonSSL ?

Détermine si le serveur Admin prend en charge les clientsCognos TM1 non SSL.

Définissez ce paramètre sur True pour que le serveur adminprenne en charge les clients non-SSL et reste à l'écoute pourdétecter des connexions client aux ports sécurisés (SSL) etnon sécurisés.

Définissez ce paramètre sur True pour configurer le serveuradmin uniquement pour la prise en charge des connexionsclient SSL à un seul port sécurisé.



Prise en charge des clientsantérieurs à TLS version1.2 ?

Depuis TM1 10.2.2 groupe de correctifs 6 (10.2.2.6), toutesles communications sécurisées par SSL entre les clients etles serveurs dans TM1 utilisent le protocole TLS (TransportLayer Security) 1.2. Ce paramètre détermine si les clientsTM1 et les serveurs TM1 antérieurs à la version 10.2.2groupe de correctifs 6 peuvent se connecter au serveuradmin version 10.2.2.6 (ou version ultérieure).

Définissez ce paramètre sur True pour autoriser les clientsTM1 et les serveurs TM1 antérieurs à la version 10.2.2.6 à seconnecter au serveur admin. Lorsqu'une telle connexion estétablie, TLS 1.0 est utilisé à la place de TLS 1.2.

Définissez ce paramètre sur False pour empêcher les clientsTM1 et les serveurs TM1 antérieurs à la version 10.2.2.6 dese connecter au serveur admin.

Emplacement du fichierd'autorité de certification deTM1 Admin Server

Chemin complet et nom du fichier d'autorité de certificationdu serveur Admin de Cognos TM1.

Emplacement du fichiercertificat

Chemin complet du fichier de certificat du serveur AdminCognos TM1, qui contient la paire de clés publique/privée.

Emplacement du fichier declés Diffie-Hellman 512 bits

Nom de chemin complet du fichier contenant une clé512 bits Diffie-Hellman prégénérée.

La génération de paramètres Diffie-Hellman peutconsommer beaucoup de ressources de traitement del'ordinateur. Pour minimiser la consommation de ressourceset réduire le temps nécessaire au chargement du serveurCognos TM1, la clé 512 bits Diffie-Hellman doit êtregénérée à l'avance et stockée dans un fichier qui est appeléau démarrage du serveur Admin.

Emplacement du fichier declés Diffie-Hellman 1024 bits

Chemin complet du fichier qui contient une clé 1024 bitsDiffie-Hellman prégénérée.

La génération de paramètres Diffie-Hellman peutconsommer beaucoup de ressources de traitement del'ordinateur. Pour minimiser la consommation de ressourceset réduire le temps nécessaire au chargement du serveurCognos TM1, la clé 1024 bits Diffie-Hellman doit êtregénérée à l'avance et stockée dans un fichier qui est appeléau démarrage du serveur Admin.

Emplacement du fichier demot de passe de clé privée deTM1 Admin Server

Chemin complet du fichier qui contient le mot de passechiffré pour la clé privée du serveur Admin Cognos TM1.

Emplacement du fichier declé mot de passe de TM1Admin Server

Chemin complet du fichier qui contient la clé utilisée pourchiffrer et déchiffrer le mot de passe pour la clé privée.



Exporter un certificat de TM1Admin Server ?

Indique si le certificat du serveur Admin Cognos TM1 doitêtre exporté du magasin de certificats Windows.

Si ce paramètre est défini sur True, le certificat du serveurAdmin est exporté du magasin de certificats de Windowsquand le certificat est demandé par le serveur Admin.

Pour des détails sur l'emploi de vos propres certificats desécurité et l'exportation de certificats du magasin decertificats Windows, voir «Utilisation de certificatsindépendants avec SSL et Planning Analytics», à la page289.

ID de certificat de TM1Admin Server

Nom du principal auquel le certificat du serveur AdminCognos TM1 est délivré.

Emplacement du fichier derévocation de certificat

Chemin complet du fichier de révocation de certificats duserveur Admin Cognos TM1.

Un fichier de révocation de certificats n'existe que si uncertificat a été révoqué.

ID de clé d'exportation deTM1 Admin Server

Spécifie la clé d'identité utilisée pour exporter le certificatdu serveur Admin à partir du magasin de certificatsMicrosoft Windows.

Requis uniquement si vous choisissez d'utiliser le magasinde certificats.

Version du certificat duserveur TM1 Admin

Définit la version des certificats SSL générés par TM1 àutiliser.

Par défaut, la version chiffrée sur 1024 bits des certificatsgénérés par TM1 est utilisée.

Ne modifiez ce paramètre que si vous voulez utiliser lanouvelle version chiffrée sur 2048 bits des certificats pardéfaut. Vous pouvez utiliser la nouvelle version avec lesanciens et les nouveaux clients TM1, mais vous devezconfigurer les clients pour qu'ils utilisent le nouveau fichierde l'autorité de certification.

Remarque : Ce paramètre ne s'applique pas si vous utilisezvos propres certificats SSL.

Les valeurs admises sont les suivantes :

v 1 - Active l'autorité de certification pour le chiffrementsur 1024 bits avec sha-1 (valeur par défaut)

v 2 - Active l'autorité de certification pour le chiffrementsur 2048 bits avec sha-256

Configuration du serveur Cognos TM1 pour SSLPour configurer un serveur IBM Cognos TM1 pour qu'il utilise SSL, vous devezdéfinir plusieurs paramètres dans Tm1s.cfg, un fichier de configuration du serveurCognos TM1.


Le tableau suivant décrit les paramètres SSL pouvant être définis dans le fichier deconfiguration Tm1s.cfg. Notez que ce tableau décrit seulement les paramètres deTm1s.cfg liés à SSL ; tous les autres paramètres de Tm1s.cfg sont décrits dans«Paramètres du fichier tm1s.cfg», à la page 312.


UseSSL Active ou désactive SSL sur le serveurCognos TM1.

Ce paramètre est activé par défaut.

Définissez UseSSL=F pour désactiver SSL.Avec ce réglage, les clients peuvent seconnecter au serveur en mode non sécurisé.

AdminSvrSSLCertID Nom du principal auquel le certificat duserveur Admin Cognos TM1 est délivré.

La valeur de ce paramètre doit êtreidentique à celle du paramètre ID decertificat du serveur admin de TM1 définidans IBM Cognos Configuration.

Si le paramètre AdminSvrSSLCertID n'estpas configuré correctement, le menudéroulant des serveurs dans Cognos TM1Web est vide et une erreur est consignéedans le fichier TM1web.log.

AdminSvrSSLCertAuthority Chemin complet du fichier d'autorité decertification qui a délivré le certificat duserveur Admin Cognos TM1.

AdminSvrSSLCertRevList Chemin complet du fichier de révocation decertificats délivré par l'autorité decertification ayant délivré le certificat duserveur Admin Cognos TM1. Un fichier derévocation de certificats n'existe que si uncertificat a été révoqué.



ExportAdminSvrSSLCert Indique si le certificat du serveur AdminCognos TM1 Web doit être exporté dumagasin de certificats Microsoft Windows.

Si ExportAdminSvrSSLCert=T, le certificat duserveur Admin est exporté à partir dumagasin de certificats Microsoft Windowsquand le certificat est demandé par leserveur Cognos TM1.

Si ExportAdminSvrSSLCert=T, vous devezaussi définir les paramètres suivants detm1s.cfg :

v AdminSvrSSLCertID

v AdminSvrSSLExportKey

v SvrSSLExportKeyID

v SSLCertificateID

v SSLPwdKeyFile

v SSLPrivateKeyPwdFile

v SSLCertAuthority

v ClientExportSSLSvrCert

AdminSvrSSLExportKeyID Spécifie la clé d'identité utilisée pourexporter le certificat du serveur Admin àpartir du magasin de certificats MicrosoftWindows.

Ce paramètre est requis uniquement si vouschoisissez d'utiliser le magasin de certificatsen définissant ExportAdminSvrSSLCert=T.

SSLCertificate Chemin complet du fichier certificat quicontient la paire de clés publique/privée.

SSLCertAuthority Nom du fichier d'autorité de certification duserveur Cognos TM1. Ce fichier doit résidersur l'ordinateur où le serveur Cognos TM1est installé.

SSLCertRevocationFile Nom du fichier de révocation de certificatsdu serveur Cognos TM1. Un fichier derévocation de certificats n'existe que si uncertificat a été révoqué. Ce fichier doitrésider sur l'ordinateur sur lequel le serveurCognos TM1 est installé.

SSLCertificateID Nom du principal auquel le certificat duserveur Cognos TM1 est délivré.



CertificateVersion Définit la version des certificats SSL généréspar TM1 à utiliser.

Ne modifiez ce paramètre que si vousvoulez utiliser la nouvelle version chiffréesur 2048 bits des certificats par défaut.

Vous pouvez utiliser la nouvelle versionavec les anciens et les nouveaux clients TM1,mais vous devez configurer les clients pourqu'ils utilisent le nouveau fichier del'autorité de certification.

Les valeurs valides sont les suivantes :

v 1 - Active l'autorité de certification pour lechiffrement sur 1024 bits avec sha-1(valeur par défaut)

v 2 - Active l'autorité de certification pour lechiffrement sur 2048 bits avec sha-256

:

ExportSvrSSLCert Indique si le certificat du serveur CognosTM1 doit être exporté du magasin decertificats de Microsoft Windows.

Si ExportSvrSSLCert=T, le certificat duserveur Cognos TM1 est exporté à partir dumagasin de certificats de Windows lorsquele certificat est réclamé par le serveurCognos TM1.

Si ExportSvrSSLCert=T, vous devez aussidéfinir les paramètres suivants de tm1s.cfg :

v AdminSvrSSLCertID

v AdminSvrSSLExportKey

v SvrSSLExportKeyID

v SSLCertificateID

v SSLPwdKeyFile

v SSLPrivateKeyPwdFile

v SSLCertAuthority

v ClientExportSSLSvrCert

Pour plus d'informations sur l'emploi de vospropres certificats de sécurité et l'exportationde certificats du magasin de certificatsMicrosoft Windows, voir «Utilisation decertificats indépendants avec SSL et PlanningAnalytics», à la page 289.



SvrSSLExportKeyID Clé d'identité utilisée pour exporter lecertificat du serveur Cognos TM1 à partir dumagasin de certificats de MicrosoftWindows.

Ce paramètre est requis uniquement si vouschoisissez d'utiliser le magasin de certificatsen définissant ExportSvrSSLCert=T.

SSLPrivateKeyPwdFile Chemin complet du fichier .dat qui contientle mot de passe chiffré pour la clé privée.

SSLPwdKeyFile Chemin complet du fichier .dat qui contientla clé utilisée pour chiffrer et déchiffrer lemot de passe pour la clé privée.

ClientExportSSLSvrCert Spécifie si le client Cognos TM1 doitrécupérer le certificat de l'autorité decertification, qui a été utilisé initialementpour émettre le certificat du serveur CognosTM1, depuis le magasin de certificatsMicrosoft Windows.

Si ClientExportSSLSvrCert=T, le certificat del'autorité de certification est exporté à partirdu magasin de certificats sur l'ordinateurclient à la demande du client Cognos TM1.

ClientExportSSLSvrKeyID Clé d'identité utilisée par le client TM1 pourexporter le certificat de l'autorité decertification, qui a été utilisé initialementpour émettre le certificat du serveur CognosTM1, depuis le magasin de certificatsWindows.

DHFile-512 Chemin complet du fichier qui contient laclé 512 bits Diffie-Hellman prégénérée.

La génération de paramètres Diffie-Hellmanpeut taxer l'ordinateur sur le plan desressources. Pour réduire cetteconsommation, la clé 512 bits Diffie-Hellmanpeut être générée à l'avance et stockée dansun fichier qui est appelé au démarrage duserveur Cognos TM1.



DHFile-1024 Nom de chemin complet du fichier quicontient la clé 1024 bits Diffie-Hellmanprégénérée.

La génération de paramètres Diffie-Hellmanpeut consommer beaucoup de ressources detraitement de l'ordinateur. Pour réduire cetteconsommation, la clé 1024 bitsDiffie-Hellman peut être générée à l'avanceet stockée dans un fichier qui est appelé audémarrage du serveur Cognos TM1.

DHFile-2048 Nom de chemin complet du fichier quicontient la clé 2048 bits Diffie-Hellmanprégénérée.

La génération de paramètres Diffie-Hellmanpeut consommer beaucoup de ressources detraitement de l'ordinateur. Pour réduire cetteconsommation, la clé 2048 bitsDiffie-Hellman peut être générée à l'avanceet stockée dans un fichier qui est appelé audémarrage du serveur Cognos TM1.

Configuration des clients Cognos TM1 pour utiliser SSLPour configurer des clients IBM Cognos TM1Architect pour SSL, vous devezdéfinir plusieurs options dans la boîte de dialogue Options de Cognos TM1.1. Ouvrez Cognos TM1 Architect ou Cognos TM1 Perspectives, puis l'explorateur

de serveur.2. Dans l'explorateur de serveur, cliquez sur Fichier > Options.3. Editer les options SSL dans la section Secure Socket Layer du serveur admin.

Le tableau suivant décrit toutes les options associées à SSL qui peuvent êtredéfinies dans la boîte de dialogue Options de TM1 et affiche les paramètresTm1p.ini correspondants.

Nom d'optionParamètre Tm1p.inicorrespondant Description

Autorité decertification

AdminSvrSSLCertAuthority Chemin complet du fichier d'autoritéde certification qui a délivré lecertificat du serveur Admin CognosTM1.

Liste de révocationde certificats

AdminSvrSSLCertRevList Chemin complet du fichier derévocation de certificats délivré parl'autorité de certification ayant délivréle certificat du serveur Admin CognosTM1. Un fichier de révocation decertificats n'existe qu'en cas derévocation de certificat.


Nom d'optionParamètre Tm1p.inicorrespondant Description

ID de certificat AdminSvrSSLCertIDRemarque : Nom du principal auquelle certificat du serveur Cognos TM1Admin Server est délivré.

La valeur de ce paramètre doit êtreidentique à celle du paramètreSSLCertificateID du serveur admind'IBM Cognos TM1 tel qu'il est définidans IBM Cognos Configuration.

Utiliser le magasinde certificats

ExportAdminSvrSSLCert Sélectionnez cette option pour que lecertificat de l'autorité de certificationqui a délivré initialement le certificatdu serveur Admin Cognos TM1 soitexporté à partir du magasin decertificats Microsoft Windows lors del'exécution.

La sélection de cette option dans laboîte de dialogue Options de CognosTM1 équivaut à définirExportAdminSvrSSLCert=T dans lefichier Tm1p.ini.

Quand cette option est sélectionnée,vous devez aussi définir une valeurpour l'ID d'exportation du certificatdans la boîte de dialogue Options deCognos TM1.

ID du certificatd'exportation

AdminSvrSSLExportKeyID Clé d'identité utilisée pour exporter lecertificat de l'autorité de certificationqui a initialement délivré le certificatdu serveur Admin Cognos TM1, àpartir du magasin de certificats.

Ce paramètre est requis uniquement sivous choisissez d'utiliser le magasin decertificats en définissantExportAdminSvrSSLCert=T.

Configuration de SSL dans Cognos TM1 WebPour activer SSL dans IBM Cognos TM1 Web, vous devez ajouter un certificat dansle magasin de clés du JRE (Java Runtime Environment).

Avant de commencer

Par défaut, Cognos TM1 Web utilise les certificats standard par défaut qui sontinclus dans l'installation Cognos TM1. Si vous souhaitez utiliser vos proprescertificats SSL, vous devez les ajouter au magasin de clés du JRE.

Procédure1. Ouvrez IBM Cognos Configuration et entrez l'URL sécurisée HTTPS pour les

paramètres suivants :


v URI de la passerelle du serveur TM1 Application - Par exemple,http://system_name:9514/pmpsvc

v URI externe du serveur - Par exemple, http://system_name:9514Entrez le nom du système et les numéros de port de votre configuration.

2. Pour les installations 32 bits :a. Ouvrez une invite de commande et accédez au répertoire du JRE fourni

avec l'installation Cognos TM1.répertoire_TM1\bin\jre\7.0\bin

Par exemple :C:\Program Files\IBM\cognos\tm1\bin\jre\7.0\bin>

b. Exécutez la commande Java keytool pour importer le certificat dans lefichier de clés.

Remarque : Pour des raisons de mise en page, la commande est présentéeici avec des sauts de ligne, mais vous devez la saisir sur une seule ligne.keytool.exe -import -trustcacerts -file“c:\Program Files\ibm\cognos\tm1\bin\ssl\your_certificate.pem”-alias your_certificate -keystore"c:\Program Files\ibm\cognos\tm1\bin\jre\7.0\lib\security\cacerts"

Remplacez votre_certificat.pem et votre_certificat par le nom de fichier et lenom de votre certificat.


Le message suivant s'affiche : Certificate was added to keystore.3. Pour les installations 64 bits :

Avertissement : Sur les ordinateurs 64 bits, veillez à ajouter les certificats audossier bin64.a. Ouvrez une invite de commande et accédez au répertoire du JRE fourni

avec l'installation Cognos TM1.C:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.0\bin

b. Exécutez la commande Java keytool pour importer le certificat dans lefichier de clés.Dans le cas des installations 64 bits, ciblez le dossier 64 bits lorsque voustravaillez sur les certificats. Si vous ne ciblez pas correctement lesrépertoires 64 bits pour les certificats lors de l'exécution d'une installation 64bits, vous recevrez un message d'avertissement indiquant que les serveursne sont pas joignables.

Remarque : Pour des raisons de mise en page, la commande est présentéeici avec des sauts de ligne, mais vous devez la saisir sur une seule ligne.keytool.exe -import -trustcacerts -file"c:\Program Files\ibm\cognos\TM1_64\bin64\ssl\your_certificate.pem"-alias your_certificate -keystore"c:\Program Files\ibm\cognos\TM1_64\bin64\jre\7.0\lib\security\cacerts"

Remplacez votre_certificat.pem et votre_certificat par le nom de fichier et lenom de votre certificat.


Le message suivant s'affiche : Certificate was added to keystore.4. Redémarrez TM1 Application Server à l'aide d'IBM Cognos Configuration pour

que les modifications soient prises en compte.


a. Dans Cognos Configuration, développez le noeud Environnement, cliquezavec le bouton droit sur TM1 Application Server et sélectionnez Arrêter.

b. Cliquez avec le bouton droit de la souris sur TM1 Application Server, puissur Démarrer.

A faire : Les certificats doivent être ajoutés à chaque réinstallation de CognosTM1.

Résultats

Connectez-vous à Cognos TM1 Web avec l'URL HTTPS sécurisée pour vérifier quela configuration permet de se connecter à Cognos TM1.

Dans le cas de cet exemple, connectez-vous avec https://nom dusystème:9514/tm1web.

Configuration de Cognos TM1 Applications pour l'utilisationde SSL

Pour configurer IBM Cognos TM1 Applications en vue de l'utilisation de SSL, vousdevez configurer SSL pour les autres composants Cognos TM1 qui interagissentavec Cognos TM1 Applications, configurer les serveurs Web qui prennent encharge Cognos TM1 Applications et modifier la configuration de Cognos TM1Applications.

Avant de commencer

Installez et configurez Cognos TM1 Applications sans SSL et vérifiez que vouspouvez démarrer le programme et vous y connecter.


Certaines des tâches destinées à l'utilisation d'un certificat provenant d'une autreautorité de certification font appel à un outil de ligne de commande appeléThirdPartyCertificateTool. Cet outil se trouve dans C:\ProgramFiles\ibm\cognos\tm1_64\bin. Pour plus d'informations sur cet outil, voir «Outilde ligne de commande ThirdPartyCertificateTool - Informations de référence», à lapage 294.

Procédure1. Configurez l'utilisation de SSL dans TM1 Admin Server.

Voir «Configuration du serveur Admin de Cognos TM1 pour SSL», à la page274.

2. Configurez l'utilisation de SSL dans TM1 Server.Voir «Configuration du serveur Cognos TM1 pour SSL», à la page 276.

3. Configurez l'utilisation de SSL dans TM1 Web.Voir «Configuration de SSL dans Cognos TM1 Web», à la page 282.

4. Copiez vos fichiers certificat dans le dossier SSL de Cognos TM1Applications :répertoire d'installation Cognos TM1\webapps\pmpsvc\WEB-INF\bin\ssl

5. Si vous utilisez vos propres certificats, importez-les de la façon suivante.


a. Sur l'ordinateur sur lequel Cognos TM1 Admin Server est exécuté, utilisezIBM Cognos Configuration pour mettre à jour les paramètres SSL pour leserveur admin.Voir «Modification des paramètres SSL dans Cognos Configuration en vuede l'utilisation de certificats indépendants», à la page 291.

b. Sur l'ordinateur sur lequel Cognos TM1 Server est exécuté, lancez l'outiltm1crypt.exe.Voir «Exécution de l'utilitaire TM1Crypt», à la page 290.

c. Pour Cognos TM1 Applications, voir «Importation de certificats SSLprovenant d'une autorité de certification tierce dans le serveur TM1Applications», à la page 286.

6. Dans l'outil Cognos Configuration, modifiez l'URI de la passerelle du serveurTM1 Application et l'URI externe du serveur de manière qu'ils utilisent lepréfixe https.

7. Enregistrez la configuration et redémarrez TM1 Applications Server.8. Sur l'ordinateur exécutant Cognos TM1 Application Server, éditez le fichier de

configuration de Cognos TM1 Applications, fpmsvc_config.xml.a. Ouvrez le fichier fpmsvc_config.xml :v Si vous avez déployé Cognos TM1 Applications avec la version

d'Apache Tomcat fournie, le fichier se trouve à cet emplacement :répertoire d'installation Cognos TM1\webapps\pmpsvc\WEB-INF\configuration

v Si vous avez réalisé le déploiement avec un autre serveur d'applicationsWeb, le fichier se trouve à cet emplacement :fichiers programmes du serveur d'applications Web\webapps\pmpsvc\WEB-INF\configuration

b. Modifiez ou ajoutez l'entrée suivante sous la section </tm1><servers> :<certificate authority="authority_file_name" id="id_name" />

où nom_fichier_autorité est le nom du fichier certificat et nom_id est le nomdu certificat. Ce fichier se trouve normalement dans le dossier :répertoire d'installation Cognos TM1\webapps\pmpsvc\WEB-INF\bin\ssl

A faire : Vous devez copier manuellement ce fichier dans ce répertoire.c. Pour définir une liste de révocation de certificats SSL, utilisez l'attribut

facultatif revocationList. S'il est utilisé, un fichier du même nom est censése trouver dans le dossier \pmpsvc\WEB-INF\bin\ssl.

d. Pour spécifier les droits et l'ID de certificat d'un serveur Admin CognosTM1, ajoutez la même section <certificate authority /> sous la sectionadmin_host. Si aucun certificat n'est défini, le certificat par défaut estutilisé.

9. Modifiez la configuration de l'URL pour le client Cognos TM1 ApplicationWeb :a. Connectez-vous à Cognos TM1 Applications.

b. Cliquez sur l'icône d'administration d'IBM Cognos TM1 Applicationsdans la barre d'outils de la page principale de Cognos TM1 Applications.

c. Cochez la case TM1 Application Web, puis cliquez sur Editer.d. Entrez l'URL sécurisée de votre installation Cognos TM1 Web dans la zone

URL. Par exemple :https://web server name:9510/tm1web/Contributor.jsp


e. Cliquez sur OK.10. Importez le certificat SSL de TM1 Applications dans le magasin de clés Java

du client.a. Exportez le certificat SSL racine de TM1 Applications :

Les sauts de lignes ont été insérés uniquement dans le but d'améliorer lalisibilité.cd <install>\tm1_64\binThirdPartyCertificateTool.bat -E -T -rc:\tmp\cacert.cer -k"<install>/tm1_64/configuration/signkeypair/jCAKeystore"-p NoPassWordSet

b. Importez le certificat SSL dans le magasin de clés Java.cd <install>\tm1_64\bin64\jre\7.0\binkeytool -import -file c:\tmp\cacert.cer -keystore "<install>\tm1_64\bin64\jre\7.0\lib\security\cacerts"-storepass changeit -alias TM1ApplicationsSSL

Importation de certificats SSL provenant d'une autorité decertification tierce dans le serveur TM1 ApplicationsAidez-vous des instructions générales qui suivent comme d'un exemple pourimporter et utiliser des certificats SSL provenant d'une autorité de certificationtierce avec TM1 Application Server.


La procédure exacte dépend de l'outil tiers utilisé.

Certaines des tâches destinées à l'utilisation d'un certificat provenant d'une autreautorité de certification font appel à un outil de ligne de commande appeléThirdPartyCertificateTool. Cet outil se trouve dans C:\ProgramFiles\ibm\cognos\tm1_64\bin. Pour plus d'informations sur cet outil, voir «Outilde ligne de commande ThirdPartyCertificateTool - Informations de référence», à lapage 294.

Procédure1. Créez un certificat d'autorité de certification autosigné.

Par exemple, l'échantillon suivant utilise OpenSSL pour créer un certificatd'autorité de certification autosigné nommé app_ca.pem.openssl req -new -x509 -extensions v3_ca -keyout app_ca/private/app_cakey.pem -out app_ca/app_ca.pem -days 3650 -config./bi_ca_openssl.cnf

2. Créez la demande de signature de certificat pour la clé de signature.Vous pouvez utiliser la ligne qui suit comme modèle.ThirdPartyCertificateTool.bat -java:local -c -s -d"CN=TM1_Signer,O=IBM_TM1,ST=MA,C=US" -r signRequest.csr -D "c:\ProgramFiles\ibm\cognos\tm1_64\configuration\signkeypair" -p password..\bin\jre\7.0\bin\java.execom.cognos.accman.jcam.utilities.ThirdPartyCertateTool -c -s -d"CN=TM1_Signer,O=IBM_TM1,ST=MA,C=US" -r signRequest.csr -D ProgramFiles\ibm\cognos\tm1_64\configuration\signkeypair" -p password

3. Créez la demande de signature de certificat pour la clé de chiffrement.


ThirdPartyCertificateTool.bat -java:l -c -e -d"CN=aplxprince.swg.usma.ibm.com,O=IBM_TM1,ST=MA,C=US" -rencryptRet.csr -D "c:\Program Files\ibm\cognos\tm1_64\configuration\encryptkeypair" -p password

4. Copiez les fichiers signRequest.csr et encryptRequest.csr dans un répertoireaccessible par votre autorité de certification.

5. Entrez les fichiers signRequest.csr et encryptRequest.csr dans l'autorité decertification et générez les certificats.Par exemple, l'échantillon suivant utilise OpenSSL pour cette étape.C:\openssl.exe ca -out signRequest.pem -config ./bi_ca_openssl.cnf-infiles signRequest.csr

C:\openssl.exe ca -out encryptRequest.pem -config ./bi_ca_openssl.cnf-infiles encryptRequest.csr

6. Renommez signRequest.pem, encrpytRequest.pem et app_ca.pem.Dans cet exemple, les fichiers sont renommés signCertificate.cer,encryptRequest.cer et ca.cer.

7. Entrez les trois certificats dans le magasin de certificats d'IBM Cognos.ThirdPartyCertificateTool.bat -java:local -i -s -r signCertificate.cer-D "c:\Program Files\ibm\cognos\tm1_64\configuration\signkeypair" -ppassword -t ca.cer

ThirdPartyCertificateTool.bat -java:local -i -e -r signCertificate.cer-D "c:\Program Files\ibm\cognos\tm1_64\configuration\encryptkeypair" -ppassword -t ca.cer

ThirdPartyCertificateTool.bat -java:local -i -T -r ca.cer -D"c:\Program Files\ibm\cognos\tm1_64\configuration\signkeypair" -ppassword

8. Ouvrez Cognos Configuration et définissez la propriété avancéeStandaloneCertificateAuthority sur true.a. Sélectionnez Configuration locale, cliquez sur le bouton Cliquez pour

éditer, puis sur Ajouter.b. Entrez StandaloneCertificateAuthority dans la zone Nom.c. Entrez True dans la zone Valeur.d. Cliquez sur OK.

Avertissement : Si vous ne définissez pas la propriété avancéeStandaloneCertificateAuthority sur true, le message d'erreur suivants'affiche lorsque vous tentez d'enregistrer la configuration dans CognosConfiguration :

[Cryptography] [ ERROR ] CAM-CRP-1132 Une erreur s'est produite lors de lademande d'un certificat au service d'autorité de certification. Le serviced'autorité de certification a signalé l'erreur suivante : CAM-CRP-1039Impossible de générer un nouveau certificat. Une erreur s'est produitependant la mise à jour du numéro de série de l'autorité de certification.Raison : java.io.FileNotFoundException

9. Dans Cognos Configuration, vérifiez que l'URI de la passerelle du serveurTM1 Application a la valeur localhost.a. Développez le noeud Environnement > TM1 Application Server.b. Vérifiez la valeur de la propriété URI de la passerelle du serveur TM1

Application.http://localhost:9510/pmpsvc


10. Dans Cognos Configuration, entrez le mot de passe déjà utilisé au cours desautres étapes aux emplacements suivants :v Sécurité > Cryptographie > Cognos > Paramètres de clé de signature >

Mot de passe du fichier de clés de signature

v Sécurité > Cryptographie > Cognos > Paramètres de clé cryptographique> Mot de passe du fichier de clés cryptographiques

11. Redémarrez TM1 Application Server.a. Dans Cognos Configuration, développez le noeud Environnement > TM1

Application Server.b. Cliquez avec le bouton droit de la souris sur TM1 Application Server et

sélectionnez Arrêter, puis Démarrer.

Configuration de l'API TM1 C pour SSLLes routines publiques suivantes font partie de l'API TM1 C. Vous pouvez utiliserces routines pour permettre à un client de communiquer avec le serveur Admin àl'aide de SSL.

Pour plus de détails, voir la section relative à la configuration d'API C TM1 pourSSL dans IBM Cognos TM1 API.

Configuration de l'API Java de Cognos TM1 pour SSLLes certificats utilisés par un client Java pour valider le serveur doivent résiderdans le fichier truststore cacerts du système Java ou être spécifiés sur la ligne decommande de l'application.

Le fichier truststore cacerts du système Java réside dans le répertoire Java\lib\security.

Par exemple :C:\Program Files\Java\JDK1.5.0_04\lib\security

Le mot de passe par défaut de cacerts est "changeit". Java fournit un exécutablenommé keytool.exe à cette fin précise. Par exemple :keytool -keystore ..\lib\security\cacerts -alias Company-import -file Companyca.der

En option, si l'accès est restreint au truststore cacerts du système, un truststorepeut être créé. Par exemple :keytool -keystore tm1store -alias Companyca -import -fileACompanyca.der

Lors du démarrage de l'application Java, ce keystore doit être spécifié. Si un motde passe est requis, il doit aussi être fourni. Par exemple :java -Djavax.net.ssl.trustStore=bin\ssl\tm1store -Djavax.net.ssl.

trustStorePassword=Companycom.mycompany.MyApp

Pour plus de détails, reportez-vous à la spécification d'API pour Java 2 PlatformStandard Edition. La version Java minimum prise en charge est 1.4.2.


Configuration de l'utilitaire Cognos TM1 ETLDAP pour SSLPour vous connecter au serveur LDAP à l'aide de SSL, vous devez exécuter lacommande suivante afin d'ajouter votre certificat au magasin IBM Cognos TM1dans le répertoire répertoire d'installation de TM1\axajre\bin :

Exemple :C:\Program Files\Cognos\Tm1\axajre\bin >keytool -keystore"C:\Program Files\Cognos\Tm1\bin\ssl\tm1store" -alias Applixldapca-import -file c:\temp\certificate_name.cer

Dans la commande ci-dessus, utilisez le nom de votre fichier certificat pourremplacer nom_certificat.cer.

A l'invite de mot de passe de keystore, entrez 'applix'.

Vous recevrez confirmation que le certificat a été ajouté au fichier de clés CognosTM1.

Lors de la connexion au serveur LDAP, vous devez sélectionnez l'option SSL.

Si vous ne sélectionnez pas l'option SSL, le serveur LDAP ne peut pas authentifiervos informations utilisateur.

Lors de l'exécution de l'utilitaire ETLDAP depuis une ligne de commande, vousdevez utiliser les deux paramètres suivants pour activer SSL.


-Djavax.net.sll.truststore Permet de spécifier le chemin complet dumagasin de certificats Java contenant lecertificat de l'autorité racine publique.

Par exemple, pour utiliser le magasin decertificats Java installé avec Cognos TM1,servez-vous du paramètre-Djavax.net.sll.truststore= C:\ProgramFiles\Cognos\TM1\bin\ssl\tm1store.

-Djavax.net.ssl.trustStorePassword Permet de spécifier le mot de passe utilisépour créer le magasin de certificats Java.

Par exemple, pour spécifier le mot de passeutilisé pour créer le magasin de certificatsJava installé avec Cognos TM1, utilisez leparamètre-Djavax.net.ssl.trustStorePassword=applix.

Utilisation de certificats indépendants avec SSL et PlanningAnalytics

Bien qu'une installation IBM Planning Analytics standard soit configurée pour SSL(sur la base des certificats installés dans le répertoire répertoire d'installation deTM1), vous devez utiliser vos propres certificats pour optimiser la sécurité.

Les sections suivantes décrivent comment utiliser des certificats indépendants pourimplémenter SSL.


Ajout d'un certificat au magasin de certificats de MicrosoftWindowsVous pouvez ajouter un certificat indépendant au magasin de certificats MicrosoftWindows et configurer IBM Cognos TM1 de façon à utiliser le certificat dans lemagasin.

Procédure1. Depuis le menu Démarrer de Windows, cliquez sur Démarrer > Exécuter et

entrez mmc pour ouvrir la console de gestion Microsoft (MMC ou MicrosoftManagement Console).

2. Cliquez sur File > Ajouter/Supprimer le composant logiciel enfichabledepuisla console de gestion Microsoft.

3. Cliquez sur Ajouter.4. Sélectionnez Certificats et cliquez sur Ajouter.5. Sélectionnez Mon compte utilisateur et cliquez sur Terminer. Cliquez sur OK.6. Cliquez avec le bouton droit sur Personnel sous Certificats - Utilisateur actuel

et sélectionnez Toutes les tâches > Importer. Cliquez sur Suivant.7. Cliquez sur Parcourir et sélectionnez le fichier .pfx contenant vos informations

de certificat. Cliquez sur Suivant.8. Entrez un mot de passe pour la clé privée et sélectionnez l'option Rendre la

clé exportable. Cliquez sur Suivant.9. Configurez l'écran et cliquez sur Suivant.

10. Cliquez sur Terminer sur l'écran final de l'assistant Importation de certificats.

Exécution de l'utilitaire TM1CryptL'utilitaire TM1Crypt (TM1Crypt.exe) chiffre le mot de passe dont le serveur IBMCognos TM1 a besoin pour accéder à la clé privée.

Le mot de passe est chiffré à l'aide de la norme AES-256-CBC (AdvancedEncryption Standard, 256 bit, Cipher Block Chaining).

Emplacement

L'utilitaire TM1Crypt, tm1crypt.exe, est installé dans le répertoire :

répertoire d'installation TM1\bin

Syntaxe

Exécutez l'utilitaire TM1Crypt depuis une invite de commande en utilisant lasyntaxe suivante :

tm1crypt.exe -pwd password -keyfile filename -outfile filename -fipsmode[1|2|3]-validate

Options de la commande

Tableau 30. Options de l'utilitaire TM1Crypt

Option Description

-pwd (Requis) Mot de passe pour la clé privée. Il doit s'agir du mot de passeutilisé pour chiffrer votre certificat.


Tableau 30. Options de l'utilitaire TM1Crypt (suite)

Option Description

-keyfile Nom du fichier .dat qui sera généré pour contenir la clé utilisée pourchiffrer et déchiffrer le mot de passe pour la clé privée.

Si ce paramètre n'est pas spécifié, TM1Crypt génère un fichier nommétm1key.dat.

Remarque : Le nom de fichier de l'option -keyfile est également utilisépour le paramètre SSLPwdKeyFile dans Cognos Configuration et dans lefichier tm1s.cfg.

-outfile Nom du fichier .dat qui sera généré pour contenir le mot de passe chiffrépour la clé privée.

Si ce paramètre n'est pas spécifié, TM1Crypt génère un fichier nommétm1cipher.dat.

Remarque : Le nom de fichier de l'option -outfile est également utilisépour le paramètre SSLPrivateKeyPwdFile dans Cognos Configuration etdans le fichier tm1s.cfg.

-validate Si vous incluez le paramètre -validate, l'utilitaire déchiffre le mot depasse chiffré et affiche les résultats en texte clair.

Le texte affiché doit correspondre au mot de passe spécifié avec leparamètre -pwd.

Ce paramètre ne permet pas la validation des fichiers existants.

Exemple

Par exemple, la commande

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfile btprk.dat -validate

génère deux fichiers :v btkey.dat - contient la clé utilisée pour chiffrer/déchiffrer le mot de passe pour

la clé privéev btprk.dat - contient le mot de passe chiffré pour la clé privée

Les fichiers générés sont écrits dans le répertoire répertoire d'installation deTM1\bin.

Modification des paramètres SSL dans Cognos Configuration envue de l'utilisation de certificats indépendantsLorsque vous avez ajouté votre certificat au magasin de certificats MicrosoftWindows, utilisez IBM Cognos Configuration pour mettre à jour les paramètresSSL pour le serveur Cognos TM1 Admin.


Tableau 31. Paramètres SSL dans Cognos Configuration pour la prise en charge descertificats indépendants


Exporter un certificat deTM1 Admin Server ?

Ce paramètre doit être défini sur True pour permettre auserveur admin de récupérer le certificat à partir du magasin decertificats.

Emplacement du fichierd'autorité de certificationde TM1 Admin Server

Chemin complet et nom du fichier d'autorité de certification quia délivré le certificat du serveur TM1 Admin.

Vous pouvez déterminer cette valeur en vous référant à laconsole de gestion Microsoft et en cliquant sur Certificats >Personnel > Certificats. Le nom de l'autorité apparaît dans lacolonne Délivré par de la sous-fenêtre Propriétés.

ID de certificat de TM1Admin Server

Nom du principal auquel le certificat du serveur IBM CognosTM1 Admin Server est délivré.

Vous pouvez déterminer cette valeur en vous référant à laconsole de gestion Microsoft et en cliquant sur Certificats >Personnel > Certificats. Le nom de principal apparaît dans lacolonne Délivré à de la sous-fenêtre Propriétés.

Emplacement du fichierde mot de passe de cléprivée de TM1 AdminServer

Chemin complet du fichier .dat qui contient le mot de passechiffré pour la clé privée.

Remarque : Le nom de ce fichier est spécifié par le paramètre-outfile lorsque vous exécutez l'utilitaire TM1Crypt.

Par exemple, si vous exécutez l'utilitaire TM1Crypt depuis lacommande suivante :

tm1crypt.exe -pwd abc123 -keyfile btkey.dat -outfilebtprk.dat -validate

La valeur correcte de ce paramètre est :

C:\Program Files\Cognos\TM1\bin\btprk.dat

Emplacement du fichierde clé mot de passe deTM1 Admin Server

Chemin d'accès complet au fichier .dat qui contient la clé utiliséepour chiffrer et déchiffrer le mot de passe pour la clé privée.

Remarque : Le nom de ce fichier est spécifié par le paramètre-keyfile lorsque vous exécutez l'utilitaire TM1Crypt.

Par exemple, si vous exécutez l'utilitaire TM1Crypt depuis lacommande suivante :


La valeur correcte de ce paramètre est :

C:\Program Files\Cognos\TM1\bin\btkey.dat

ID de clé d'exportationde TM1 Admin Server

Spécifie la clé d'identité utilisée pour exporter le certificat duserveur Admin à partir du magasin de certificats Windows.

Dans la plupart des cas, la valeur de l'ID de clé d'exportationde TM1 Admin Server sera identique à celle de l'ID decertificat de TM1 Admin Server.


Modification des paramètres SSL dans le fichier Tm1s.cfg en vuede l'utilisation de certificats indépendantsLorsque vous avez ajouté votre certificat au magasin de certificats MicrosoftWindows, ajoutez les paramètres SSL requis au fichier Tm1s.cfg.

Tableau 32. Paramètres SSL du fichier Tm1s.cfg

Paramètre Valeur

AdminSvrSSLCertID Nom du principal auquel le certificat du serveur AdminIBM Cognos TM1 est délivré.

AdminSvrSSLExportKeyID Spécifie la clé d'identité utilisée pour exporter le certificatdu serveur Admin à partir du magasin de certificatsMicrosoft Windows.

ClientExportSSLSvrCert Indique si le client Cognos TM1 doit récupérer le certificatde l'autorité de certification, qui a été utilisé initialementpour émettre le certificat du serveur Cognos TM1, depuis lemagasin de certificats de Microsoft Windows.

Si ClientExportSSLSvrCert=T, le certificat de l'autorité decertification est exporté à partir du magasin de certificats àla demande du client TM1.

ClientExportSSLSvrKeyID Clé d'identité utilisée par le client Cognos TM1 pourexporter le certificat de l'autorité de certification, qui a étéutilisé initialement pour émettre le certificat du serveurCognos TM1, depuis le magasin de certificats de MicrosoftWindows.

ExportAdminSvrSSLCert Indique si le certificat du serveur Admin Cognos TM1 Webdoit être exporté du magasin de certificats de MicrosoftWindows.

Si ExportAdminSvrSSLCert=T, le certificat du serveur Adminest exporté à partir du magasin de certificats de MicrosoftWindows lorsqu'il est réclamé par le serveur Cognos TM1.

ExportSvrSSLCert Ce paramètre doit être défini sur T pour permettre auserveur Cognos TM1 de récupérer le certificat à partir dumagasin de certificats de Microsoft Windows.

ExportSvrSSLCert=T

SSLCertAuthority Nom de l'autorité qui a délivré votre certificat.

Vous pouvez déterminer cette valeur en vous référant à laconsole de gestion Microsoft et en cliquant sur Certificats >Personnel > Certificats. Le nom de l'autorité figure dans lacolonne Délivré par de la sous-fenêtre Propriétés.

SSLCertificateID Nom du principal auquel le certificat du serveur CognosTM1 est délivré.

Vous pouvez déterminer cette valeur en vous référant à laconsole de gestion Microsoft et en cliquant sur Certificats >Personnel > Certificats. Le nom du principal figure dans lacolonne Délivré à de la sous-fenêtre Propriétés.


Tableau 32. Paramètres SSL du fichier Tm1s.cfg (suite)

Paramètre Valeur

SSLPrivateKeyPwdFile Chemin complet du fichier .dat qui contient le mot de passechiffré pour la clé privée.

Remarque : Le nom de ce fichier est spécifié par leparamètre -outfile lorsque vous exécutez l'utilitaireTM1Crypt.

Par exemple, si vous exécutez l'utilitaire TM1Crypt depuisla commande suivante :


La valeur correcte de ce paramètre estSSLPrivateKeyPwdFile=C:\Program Files\Cognos\TM1\bin\btprk.dat

SSLPwdKeyFile Chemin d'accès complet au fichier .dat qui contient la cléutilisée pour chiffrer et déchiffrer le mot de passe pour laclé privée.

Remarque : Le nom de ce fichier est spécifié par leparamètre -keyfile lorsque vous exécutez l'utilitaireTM1Crypt.

Par exemple, si vous exécutez l'utilitaire TM1Crypt depuisla commande suivante :


La valeur correcte de ce paramètre est SSLPwdKeyFile=C:\Program Files\Cognos\TM1\bin\btkey.dat

SvrSSLExportKeyID Spécifie la clé d'identité utilisée pour exporter le certificatdu serveur Cognos TM1 à partir du magasin de certificatsMicrosoft Windows.

Dans la plupart des cas, la valeur de SvrSSLExportKeyIDsera identique à celle de SSLCertificateID.

Utilisation de certificats indépendants dans votre système defichiersVous pouvez implémenter SSL avec des certificats indépendants stockés dans votresystème de fichiers.

Il suffit d'ajouter votre certificat, votre autorité de certification, vos fichiers de motde passe, etc. au répertoire répertoire d'installation de TM1\bin\SSL et demodifier les paramètres de configuration de IBM Cognos TM1 appropriés de sortequ'ils pointent vers vos fichiers indépendants.

Outil de ligne de commande ThirdPartyCertificateTool -Informations de référenceCertaines des tâches destinées à l'utilisation d'un certificat provenant d'une autreautorité de certification font appel à un outil de ligne de commande appeléThirdPartyCertificateTool.

Cet outil se trouve dans le répertoire \bin suivant de l'installation Cognos TM1.


Par exemple : C:\Program Files\IBM\cognos\tm1_64\bin

Sur les systèmes d'exploitation UNIX ou Linux, utilisez le format suivant :

ThirdPartyCertificateTool.sh parameters

Sur les systèmes d'exploitation Microsoft Windows, utilisez le format suivant :

ThirdPartyCertificateTool.bat parameters

Les tableaux qui suivent répertorient les options de cet outil de ligne decommande.

Tableau 33. Mode de fonctionnement principal

Commande Description

-c Créer une nouvelle demande de signature de certificat

-i Importer un certificat

Tableau 34. Modificateurs de fonctionnement


-s Utiliser l'identité de signature

-e Utiliser l'identité de chiffrement

-T Utiliser le magasin de clés de confiance (uniquement avec -i)

Tableau 35. Indicateurs d'informations


-d Nom unique à utiliser pour le certificat

-r Emplacement du fichier de demande de signature de certificat ou dufichier certificat (selon le mode)

-t Fichier certificat de l'autorité de certification (uniquement avec -i)

-p Mot de passe de fichier de clés

-a Algorithme de paire de clés : RSA ou DSA. RSA est la valeur pardéfaut.

-D Emplacement du répertoire

Les exemples de valeur du tableau suivant sont utilisés :

Tableau 36. Exemples de valeur

Propriété Valeur

Nom distinctif du certificat designature

Valeur unique, formatée de la façon suivante :

CN=SignCert,O=MyCompany,C=CA

Nom distinctif du certificat dechiffrement

Valeur unique, formatée de la façon suivante :

CN=EncryptCert,O=MyCompany,C=CA

Mot de passe du fichier declés

Mot de passe


Chapitre 19. Maintenance de l'installation Cognos TM1

Une fois l'installation d'IBM Cognos TM1 menée à bien, vous pouvez réaliser destâches de gestion du produit, telles que l'installation de composantssupplémentaires, la sauvegarde et la restauration des données et des fichiers deconfiguration, et la désinstallation de la version en cours.

Installation de composants supplémentairesVous pouvez retourner dans l'assistant d'installation de Cognos TM1 pourinstaller des composants supplémentaires qui ne le sont pas encore.

Sauvegarde des données et des fichiers de configurationSauvegardez régulièrement vos données et vos fichiers de configuration,particulièrement avant d'effectuer une mise à niveau vers une nouvelleversion de Cognos TM1.

Désinstallation de la version en coursLa désinstallation de certains composants Cognos TM1 peut nécessiter desopérations supplémentaires. Par exemple, IBM Cognos Insight et IBMCognos TM1 Performance Modeler s'installent différemment des autrescomposants IBM Cognos TM1.

Sauvegarde des données et des fichiers de configuration de CognosTM1

Cette rubrique décrit la façon de sauvegarder les données et les fichiers deconfiguration des composants IBM Cognos TM1 version 10.2.x.


Chaque composant Cognos TM1 dispose de son propre jeu de données et defichiers de configuration. Lisez et suivez toutes les étapes ci-dessous poursauvegarder les données et les paramètres de configuration des composants quevous utilisez.

Par exemple :v Sauvegardez le répertoire de données et les fichiers de configuration Cognos

TM1 de tous vos serveurs IBM Cognos TM1.v Si vous utilisez Cognos TM1 Web, sauvegardez les données et les fichiers

associés à ce composant.v Si vous utilisez Cognos TM1 Applications, exportez vos applications et

sauvegardez les fichiers associés.

Procédure1. Exportez les paramètres de configuration depuis IBM Cognos Configuration :

Si vous avez utilisé l'utilitaire de configuration Cognos Configuration pourexécuter et gérer les composants Cognos TM1, tels que Cognos TM1 AdminServer, les serveurs Cognos TM1, ou Cognos TM1 Application Server, vouspouvez enregistrer les paramètres de configuration dans un fichier XML.a. Ouvrez Cognos Configuration.b. Cliquez sous Fichier > Exporter sous.c. Sélectionnez un emplacement et entrez le nom du fichier XML.


d. Cliquez sur Enregistrer.2. Sauvegardez les bases de données Cognos TM1 Server :

Enregistrez dans un répertoire sécurisé une copie du contenu des répertoires etdes sous-répertoires de données de vos bases de données IBM Cognos TM1.Ces répertoires contiennent à la fois les données et les fichiers de configuration.Les répertoires et les sous-répertoires des bases de données d'exemple deCognos TM1 se situent dans :<installation TM1>\samples\tm1

3. Sauvegardez les autres fichiers de configuration de Cognos TM1 :Faites une copie de tous les fichiers de configuration de Cognos TM1 que voussouhaitez conserver - par exemple, le fichier des propriétés de consignation deCognos TM1 Admin Server, tm1admsrv-log.properties, situé dans le répertoire<installation TM1>\bin\.

4. Sauvegardez Cognos TM1 Web :Si vous utilisez Cognos TM1 Web, sauvegardez dans un emplacementpersonnalisé le fichier tm1web_config.xml et les pages de serveur Web CognosTM1 personnalisées. L'emplacement par défaut de ces fichiers est le suivant :<installation TM1>\webapps\tm1web\

<installation TM1>\webapps\tm1web\web-inf\configuration\

5. Sauvegardez Cognos TM1 Architect et Cognos TM1 Perspectives :Si vous utilisez Cognos TM1 Architect ou Cognos TM1 Perspectives,sauvegardez le fichier de configuration client Tm1p.ini situé dans :v %ALLUSERSPROFILE%\Application Data\Applix\TM1\

v %USERPROFILE%\Application Data\Applix\TM1\

Dans la plupart des cas, les chemins complets de ces fichiers sont :v C:\Documents and Settings\All Users\Application Data\Applix\TM1\

Tm1p.ini

v C:\Documents and Settings\<nom d'utilisateur>\ApplicationData\Applix\TM1\Tm1p.ini

6. Sauvegardez Cognos TM1 Applications :Si vous utilisez Cognos TM1 Applications, suivez la procédure ci-dessous poursauvegarder les données et les fichiers de configuration qui lui sont associés.v «Sauvegarde des données Cognos TM1 Applications», à la page 301v «Exportation d'applications depuis Cognos TM1 Applications», à la page 302

Modification des composants Cognos TM1 installésVous pouvez modifier l'installation en réinstallant des composants ou en ajoutantdes composants non encore installés.


L'assistant d'installation vous permet uniquement d'installer des composants, etnon d'en supprimer.

Remarque : La maintenance des programmes ne permet pas le changement derépertoire d'installation de Cognos TM1. Pour changer de répertoire d'installation,supprimez tous les fichiers Cognos TM1 et réinstallez Cognos TM1 dans lenouveau répertoire.


Procédure1. Pour démarrer l'installation :v Accédez au répertoire de téléchargement du programme d'installation de

Cognos TM1.v Ou, insérez le CD du produit IBM Cognos TM1.

Si l'assistant d'installation ne démarre pas automatiquement, accédez aurépertoire du système d'exploitation et localisez le fichier issetup.exe.

2. Selon votre système d'exploitation, cliquez avec le bouton droit ou cliquez deuxfois sur le fichier issetup.exe :v Sous Microsoft Windows Vista, Windows 7 ou Windows Server 2008, cliquez

avec le bouton droit sur la commande issetup.exe, puis cliquez sur Exécuteren tant qu'administrateur.

v Pour tous les autres systèmes d'exploitation Windows, cliquez deux fois surissetup.exe.

3. Cliquez sur Suivant pour atteindre l'écran Sélection des composants.Si vous y êtes invité, répondez aux questions suivantes :v Confirmez que l'installation doit se faire au même emplacement que

précédemment.v Indiquez si vous voulez créer une sauvegarde de tous les fichiers de

l'installation existante.4. Sur l'écran Sélection des composants, sélectionnez les composants Cognos TM1

à installer et cliquez sur Suivant.L'écran Sélection de composants indique l'état actuel de votre installationCognos TM1.v Une croix rouge est affichée en regard des composants installés.v Une coche verte est affichée en regard des composants qui ne le sont pas.

L'installation de ces éléments est sélectionnée automatiquement.5. Cliquez sur Suivant pour démarrer les modifications.6. Cliquez sur Terminer une fois les modifications terminées.

Désinstallation d'IBM Planning AnalyticsPour supprimer et désinstaller tous les composants d'IBM Planning Analytics,procédez comme suit :

Remarque : Si vous désinstallez Cognos TM1 Applications, consultez lesopérations supplémentaires à effectuer à la section «Désinstallation et déploiementde Cognos TM1 Applications», à la page 301.

Avant de commencer

Avant de commencer à désinstaller Planning Analytics, vous devez avoir terminéla sauvegarde de l'ensemble des données Planning Analytics.

Pour plus de détails, voir :v «Sauvegarde des données et des fichiers de configuration de Cognos TM1», à la

page 297.v «Sauvegarde des données Cognos TM1 Applications», à la page 301.

Chapitre 19. Maintenance de l'installation Cognos TM1 299


La suppressions de certains composants installés peut nécessiter des opérationssupplémentaires. Par exemple, IBM Cognos Insight et IBM Cognos TM1Performance Modeler s'installent différemment des autres composants IBM CognosTM1.

Procédure1. Désinstallez Cognos Insight :

a. Dans le Panneau de configuration de Windows, sélectionnezAjout/Suppression de programmes.

b. Dans la liste des programmes installés, sélectionnez IBM Cognos TM1Insight.

c. Cliquez sur Supprimer et suivez les instructions pour terminer le processus.d. Vérifiez dans le répertoire des fichiers programme si certains fichiers ont été

conservés. Si c'est le cas, supprimez-les manuellement.2. Désinstallez Cognos TM1 Performance Modeler :

a. Dans le Panneau de configuration de Windows, sélectionnezAjout/Suppression de programmes.

b. Dans la liste de programmes actuellement installés, sélectionnez IBMCognos Performance Modeler.

c. Cliquez sur Supprimer et suivez les instructions pour terminer le processus.d. Vérifiez dans le répertoire des fichiers programme si certains fichiers ont été

conservés. Le cas échéant, supprimez-les manuellement.3. Désinstallez les composants TM1 de base :

Cette procédure désinstalle tous les composants suivants :v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos Configurationv Cognos TM1 Webv Cognos TM1 Architectv Cognos TM1 Perspectivesv Cognos TM1 Applicationsv Cognos TM1 Operations Consolea. Dans le menu Démarrer de Microsoft Windows, cliquez sur Tous les

programmes > IBM Planning Analytics > Désinstaller IBM PlanningAnalytics > Désinstaller IBM Planning Analytics.

b. Sélectionnez la langue de l'assistant de désinstallation et cliquez surSuivant.

c. Dans l'écran Sélectionnez les packs que vous voulez désinstaller, cochezIBM Planning Analytics, puis cliquez sur Suivant.Le programme de désinstallation supprime les composants. Cette opérationpeut prendre un certain temps. Lorsqu'elle est terminée, vous êtes invité àredémarrer votre ordinateur.

d. Choisissez un redémarrage immédiat ou différé, puis cliquez sur Terminer.e. Vérifiez dans le répertoire d'installation de Cognos TM1 s'il reste des

fichiers ou des sous-répertoires. Le cas échéant, supprimez-lesmanuellement.Par exemple, vérifiez dans C:\Program Files\IBM\cognos\tm1.


Désinstallation et déploiement de Cognos TM1 ApplicationsSi vous souhaitez conserver les données de vos applications, une procédure desauvegarde et d'exportation complète comprenant plusieurs étapes doit êtreréalisée pour IBM Cognos TM1 Applications.

Les tâches décrites ici vous permettent d'effectuer les opérations suivantes :v Sauvegarde des données Cognos TM1 Applicationsv Exportation des données de Cognos TM1 Applicationsv Arrêt des services associésv Désinstallation de Cognos TM1 Applicationsv Annulation du déploiement de Cognos TM1 Applications dans Apache Tomcat,

si ce produit est utilisé.v Annulation du déploiement de Cognos TM1 Applications dans WebSphere, si ce

produit est utilisé.

Sauvegarde des données Cognos TM1 ApplicationsCette rubrique explique comment sauvegarder manuellement vos données et vosfichiers de configuration de Cognos TM1 Applications.


La sauvegarde manuelle des fichiers d'application permet de conserver les donnéesd'état de l'application, telles que les propriétaires de noeuds ou le statut dessoumissions.

Remarque : Pour enregistrer uniquement la définition de la structure del'application, sans les données d'état, utilisez la fonction d'exportation. Voir«Exportation d'applications depuis Cognos TM1 Applications», à la page 302.

Procédure1. Sauvegardez les bases de données Cognos TM1 Server qui sont utilisées par

vos applications.Enregistrez dans un répertoire sécurisé une copie du contenu des répertoires etdes sous-répertoires de données de vos bases de données IBM Cognos TM1.Ces répertoires contiennent à la fois les données et les fichiers de configuration.Les répertoires et les sous-répertoires des bases de données d'exemple deCognos TM1 se situent dans :<installation TM1>\samples\tm1

2. Enregistrez une copie de sauvegarde du dossier applications et des fichiers deconfiguration pmpsvc_config.xml et fpmsvc_config.xml de Cognos TM1Applications.Ces éléments se trouvent généralement aux emplacements suivants :v <installation TM1>\webapps\pmpsvc\WEB-INF\applications

v <installation TM1>\webapps\pmpsvc\WEB-INF\configuration\pmpsvc_config.xml

v <installation TM1>\webapps\pmpsvc\WEB-INF\configuration\fpmsvc_config.xml

Si vous utilisez la sécurité IBM Cognos Analytics avec Cognos TM1Applications, vous trouverez ces éléments à l'emplacement suivant : <ProgramFiles>\cognos\cx\webapps\pmpsvc


où x est la version de Cognos Analytics que vous utilisez.

Exportation d'applications depuis Cognos TM1 ApplicationsVous pouvez exporter la définition de base d'une application d'IBM Cognos TM1Applications 10.x pour en enregistrer une copie de sauvegarde ou la déplacer versune autre instance de Cognos TM1 Applications. L'exportation vous permetd'enregistrer un modèle d'application sans les activités des utilisateurs ni lesdonnées d'état. Seule la structure et la définition de la sécurité de l'application sontexportées. Vous pouvez importer et réutiliser l'application quand vous voulezaprès l'exportation, par exemple pour un nouveau cycle de planification.


Une archive est créée et contient les fichiers XML qui décrivent la structure et lasécurité de votre application.

Important : Le processus d'exportation ne conserve pas les données d'état del'application, telles que les propriétaires de noeuds ou le statut des soumissions.Ces informations ne sont pas conservées par le processus d'exportation/importation.

Pour conserver les données d'état de vos applications, sauvegardez manuellementles fichiers selon les instructions de la rubrique «Sauvegarde des données CognosTM1 Applications», à la page 301.

Procédure1. Ouvrez le portail TM1 Cognos Applications.2. Cliquez sur l'icône Exporter une application sous la colonne Actions.3. Dans la boîte de dialogue Téléchargement de fichier, cliquez sur Enregistrer.4. Accédez au répertoire dans lequel le fichier exporté doit être enregistré.5. Cliquez sur Enregistrer.

Arrêt des services associés dans Cognos TM1Cette rubrique décrit la manière d'arrêter les services associés dans la version 10.2d'IBM Cognos TM1.

Procédure1. Ouvrez Cognos Configuration.2. Arrêtez les services suivants :v TM1 Admin Serverv Toutes les instances du service TM1 Serverv TM1 Application Server

Remarque : L'arrêt de TM1 Application Server arrête également les autrescomposants TM1 qui sont installés sur le même ordinateur. Cette opérationarrête tous les composants d'application Web associés : Cognos TM1Applications, Cognos TM1 Web et Cognos TM1 Operations Console. Cetteopération arrête les services de prise en charge qui permettent à Cognos TM1de communiquer avec IBM Planning Analytics for Microsoft Excel.

3. Si vous utilisez la sécurité IBM Cognos Analytics avec Cognos TM1Applications, arrêtez le service IBM Cognos Analytics.


4. Arrêtez dans la console des services Windows les services Cognos TM1 quin'auraient pas été configurés et démarrés dans Cognos Configuration.

Désinstallation de Cognos TM1 ApplicationsSi vous avez installé et déployé IBM Cognos TM1 Applications avec le serveurWebSphere Liberty par défaut fourni avec l'installation Cognos TM1, procédez dela manière suivante pour désinstaller Cognos TM1 Applications.

Avant de commencer

Vérifiez que vous avez effectué une sauvegarde de vos données Cognos TM1Applications, et que les services associés ont été arrêtés dans IBM CognosConfiguration.


Cette procédure ne s'applique que si vous utilisez IBM Cognos TM1 Applicationsavec la version par défaut du serveur d'applications Web WebSphere Libertyfournie avec l'installation de Cognos TM1.

Si vous avez installé et déployé Cognos TM1 Applications sur un serveurd'applications Web autre que le serveur par défaut qui vous a été fourni, utilisezles outils de ce serveur pour annuler le déploiement. Pour plus de détails, voir lesrubriques suivantes :v «Annulation du déploiement de Cognos TM1 Applications dans Apache Tomcat»

, à la page 304v «Annulation du déploiement de Cognos TM1 Applications dans WebSphere», à

la page 304

Avertissement : Ces opérations vont également retirer les composants CognosTM1 suivants, s'ils sont installés sur le même ordinateur :v Cognos TM1 Admin Serverv Cognos TM1 Serverv Cognos Configurationv Cognos TM1 Webv Cognos TM1 Architectv Cognos TM1 Perspectivesv Cognos TM1 Operations Console

Procédure1. Dans le menu Démarrer de Microsoft Windows, cliquez sur Tous les

programmes > IBM Planning Analytics > Désinstaller IBM PlanningAnalytics > Désinstaller IBM Planning Analytics.

2. Sélectionnez la langue de l'assistant de désinstallation et cliquez sur Suivant.3. Dans l'écran Sélectionnez les packs que vous voulez désinstaller, cochez IBM

Planning Analytics, puis cliquez sur Suivant.Le programme de désinstallation supprime les composants. Cette opérationpeut prendre un certain temps. Lorsqu'elle est terminée, vous êtes invité àredémarrer votre ordinateur.

4. Choisissez un redémarrage immédiat ou différé, puis cliquez sur Terminer.5. Vérifiez dans le répertoire d'installation de Cognos TM1 s'il reste des fichiers ou

des sous-répertoires. Le cas échéant, supprimez-les manuellement.


Par exemple, vérifiez dans C:\Program Files\IBM\cognos\tm1\webapps\pmpsvc.

Annulation du déploiement de Cognos TM1 Applications dansApache Tomcat

Utilisez cette procédure pour annuler le déploiement d'IBM Cognos TM1Applications si vous avez utilisé Apache Tomcat au lieu du serveur WebSphereLiberty fourni avec l'installation de Cognos TM1.

Procédure1. Ouvrez le gestionnaire Tomcat.2. Cliquez sur Annuler le déploiement pour l'entrée /pmpsvc de la liste

Applications.3. Cliquez sur OK pour confirmer votre choix.

Le déploiement de l'application est annulé et l'application est supprimée de laliste Applications du gestionnaire Tomcat.

Conseil : Si l'entrée /pmpsvc apparaît toujours dans la liste Applications aprèsl'annulation du déploiement, arrêtez et redémarrez Tomcat, puis cliquez denouveau sur Undeploy.

4. Vérifiez que les fichiers et dossiers suivants de Cognos TM1 Application Webont bien été supprimés. Arrêtez Tomcat et supprimez ces fichiers s'ils sonttoujours présents.

Dossiers

v C:\Program Files\Apache Software Foundation\webapps\pmpsvc

v C:\Program Files\Apache Software Foundation\Tomcat6.0\webapps\pmpsvc

v C:\Program Files\Apache Software Foundation\Tomcat6.0\work\Catalina\localhost\pmpsvc

Fichiers

v C:\Program Files\Apache Software Foundation\Tomcat6.0\webapps\pmpsvc.war

Si vous utilisez la sécurité IBM Cognos Analytics avec Cognos TM1Applications, vous trouverez ces éléments aux emplacements suivants :v C:\Program Files\cognos\cx\webapps\pmpsvc

v C:\Program Files\cognos\cx\tomcat4.1.27\work\Standalone\localhost\pmpsvc

où x est la version de Cognos Analytics que vous utilisez.

Annulation du déploiement de Cognos TM1 Applications dansWebSphere

Utilisez cette procédure pour annuler le déploiement d'IBM Cognos TM1Applications si vous avez utilisé IBM WebSphere au lieu de la version d'ApacheTomcat fournie avec l'installation Cognos TM1.

Procédure1. Ouvrez la console d'administration de WebSphere.2. Dans la sous-fenêtre de navigation de la console, repérez la section

Applications et cliquez sur Fichiers WAR d'application Web.La page Applications Web installées s'ouvre.


3. Recherchez l'entrée /pmpsvc dans la colonne URL et cliquez sur Désinstaller.4. Cliquez sur OK pour confirmer la désinstallation.

WebSphere affiche le message suivant une fois l'opération terminée :Application désinstallée

default/pmpsvc

Restauration des fichiers de données et de configuration dans IBMPlanning Analytics version 2.0.0

Après l'installation de la nouvelle version d'IBM Planning Analytics, procédezcomme suit pour restaurer les anciens fichiers de données et de configuration deCognos TM1.

Avant de commencer



Ces étapes ne concernent que la restauration des fichiers de données et deconfiguration d'IBM Cognos TM1 version 10.x.x.

Pour restaurer des informations de Cognos TM1 version 9.x dans PlanningAnalytics version 2.0.0, voir «Restauration des données et des fichiers deconfiguration de Cognos TM1 version 9.x dans la nouvelle version», à la page 54.

Procédure1. Restaurez les données de Cognos TM1 Server :

Copiez le répertoire et les sous-répertoires de données de chaque serveurCognos TM1 à restaurer dans le nouvel emplacement réservé aux données :<installation TM1>\samples\tm1.

2. Restaurez les paramètres de configuration dans IBM Cognos Configuration :Cela concerne les paramètres de configuration de Cognos TM1 Admin Server,de Cognos TM1 Application Server et de tous les serveurs Cognos TM1 quevous souhaitez exécuter.a. Ouvrez IBM Cognos Configuration.b. Dans la sous-fenêtre Explorateur de Cognos Configuration, développez

Configuration locale > Environnement .c. Cliquez sur TM1 Admin Server et mettez à jour les paramètres de la

sous-fenêtre Propriétés.d. Cliquez sur TM1 Application Server et mettez à jour les paramètres de la

sous-fenêtre Propriétés.e. Cliquez sur Accès aux données > TM1 Server et ajoutez une entrée pour

chaque serveur Cognos TM1 que vous allez utiliser.Pour plus d'informations, voir «Ajout d'un serveur Cognos TM1 existantdans Cognos Configuration», à la page 91.

f. Cliquez sur Fichier > Enregistrer.3. Restaurez les fichiers de configuration de Cognos TM1 Architect et de Cognos

TM1 Perspectives :


Pour restaurer des paramètres de votre ancienne installation Cognos TM1 ouCognos TM1 Perspectives, copiez les valeurs de l'ancien fichier Tm1p.ini dansle nouveau fichier Tm1p.ini.Avertissement : Si vous conservez à la même place les anciens fichiersTm1p.ini, vous devrez peut-être y modifier le chemin du répertoire défini pourle paramètre AdminSvrSSLCertAuthority. Par exemple, si vous utilisez lecertificat SSL par défaut de Cognos TM1, remplacez manuellement la valeur dece paramètre par le nouveau chemin d'installation C:\ProgramFiles\IBM\cognos\tm1\bin\ssl\applixca.pem.a. Mettez à jour le fichier Tm1p.ini par défaut du système qui se trouve à



b. Mettez à jour le nouveau fichier Tm1p.ini de l'utilisateur qui se trouve àl'emplacement suivant :%APPDATA%\Applix\TM1\Tm1p.ini


4. Restaurez les fichiers de Cognos TM1 Web :

Remarque : A partir d'IBM Cognos TM1 version 10.2.0, le répertoired'installation par défaut de Cognos TM1 Web est <installation_TM1>\webapps\tm1web\.v Restauration des fichiers à partir de Cognos TM1 Web version 10.2.0 ou

d'une version plus récente :Ouvrez votre ancien fichier tm1web_config.xml et sélectionnez les lignes etles paramètres que vous voulez utiliser dans le nouveau fichiertm1web_config.xml situé dans <installation TM1>\webapps\tm1web\web-inf\configuration.

v Restauration des fichiers à partir d'une version antérieure à la version 10.2.0de Cognos TM1 Web :

Remarque : Cognos TM1 Web version 10.2.0 utilise un nouveau fichier deconfiguration nommé tm1web_config.xml. Ce fichier remplace le fichierweb.config des versions précédentes de Cognos TM1 Web. Pour plusd'informations, voir «Modification des paramètres de configuration deCognos TM1 Web», à la page 113.Ouvrez votre ancien fichier Web.config et sélectionnez les lignes et lesparamètres que vous voulez utiliser dans le nouveau fichiertm1web_config.xml situé dans <installation TM1>\webapps\tm1web\web-inf\configuration.

5. Restaurez les fichiers de configuration et d'application dans Cognos TM1Applications :Pour plus de détails, voir :v «Restauration des fichiers de configuration et d'application dans Cognos TM1

Applications», à la page 307v «Importation d'une définition d'application dans Cognos TM1 Applications»,

à la page 307


Restauration des fichiers de configuration et d'application dansCognos TM1 Applications

Vous pouvez restaurer manuellement des copies de sauvegarde de vos fichiersd'application et de configuration dans une version existante d'IBM Cognos TM1Applications.

Avant de commencer

Le serveur Cognos TM1 dont dépend votre application doit être restauré etredémarré avant la restauration des fichiers d'application de Cognos TM1Applications.

Procédure1. Restaurez vos applications Cognos TM1 Applications :

Copiez les fichiers d'application dans le répertoire :<installation TM1>\webapps\pmpsvc\WEB-INF\applications

2. Restaurez les fichiers de configuration de Cognos TM1 Applications :Copiez les copies de sauvegarde des fichiers de configurationpmpsvc_config.xml et fpmsvc_config.xml dans le répertoire :v <installation TM1>\webapps\pmpsvc\WEB-INF\configuration\

pmpsvc_config.xml

v <installation TM1>\webapps\pmpsvc\WEB-INF\configuration\fpmsvc_config.xml

3. Dans Cognos Configuration :a. Démarrez le serveur TM1 Application.b. Démarrez les serveurs TM1 associés à votre application.

4. Connectez-vous au portail Cognos TM1 Applications et ajoutez le serveur TM1associé dans la page de configuration s'il n'y figure pas.

a. Cliquez sur l'icône Administrer IBM Cognos TM1 Applications dans labarre d'outils de la page principale de Cognos TM1 Applications.

b. Sous la section Nom des serveurs, cliquez sur Ajouter et entrez lesinformations relatives au serveur TM1.

c. Cliquez sur OK.Les applications du dossier webapps/pmpsvc/WEB-INF/application sont misesà jour et ajoutées à Cognos TM1 Applications.

Remarque : La durée du processus de mise à niveau dépend de la quantitéde droits à appliquer aux applications, et peut être relativement longue.Pour plus d'informations, voir «Enregistrement des droits de sécurité lors del'importation ou de la restauration d'une application Cognos TM1», à lapage 56.

Importation d'une définition d'application dans Cognos TM1Applications

Vous pouvez réimporter dans IBM Cognos TM1 Applications une définitiond'application qui en a été exportée.


Procédure1. Ouvrez le portail de Cognos TM1 Applications.2. Cliquez sur le bouton Importer une application.3. Sélectionnez le serveur Cognos TM1 sur lequel vous voulez importer

l'application.4. En regard de la zone Fichier de l'application, cliquez sur Parcourir.5. Accédez au fichier de l'application (.zip), puis cliquez sur Ouvrir.6. Sélectionnez l'option Importation de la sécurité de l'application pour importer

les paramètres de sécurité avec l'application.

Remarque : Si vous importez les paramètres de sécurité, la durée del'enregistrement des droits dépend de la quantité de droits à appliquer auxapplications, et peut être relativement longue. Pour plus d'informations, voir«Enregistrement des droits de sécurité lors de l'importation ou de larestauration d'une application Cognos TM1», à la page 56.

7. Sélectionnez l'option Importation des propriétés de l'application pour importerles propriétés avec l'application.

8. Cliquez sur Importer.


Chapitre 20. Fonctions d'accessibilité

Les fonctions d'accessibilité aident les utilisateurs qui souffrent d'un handicapphysique, tel qu'une mobilité limitée ou une vision faible, à utiliser les logiciels.

Pour en savoir plus sur l'engagement d'IBM en matière d'accessibilité,reportez-vous à IBM Accessibility Center.

Le site IBM Accessibility Center est disponible à l'adresse http://www.ibm.com/able.

Raccourcis clavier de l'assistant d'installationLes raccourcis clavier ou les touches de raccourci fournissent une méthode plusfacile et souvent plus rapide pour accéder au logiciel et l'utiliser.

L'assistant d'installation utilise les touches de navigation standard de MicrosoftWindows en plus des touches spécifiques aux applications.

Remarque : Les raccourcis clavier suivants sont basés sur le clavier standardaméricain.

Le tableau ci-dessous répertorie les raccourcis clavier que vous pouvez utiliserpour exécuter des tâches principales dans l'assistant d'installation sous le systèmed'exploitation Windows.

Résultat Touches de raccourci

Passer à la zone suivante dans une page Onglet

Revenir à la zone précédente dans une page Maj+Tabulation

Fermer l'assistant d'installation [Alt] + F4

Passer à la prochaine étape de configuration Alt+N

Revenir à l'étape de configuration précédente [Alt] + B

Passer à la sélection suivante dans une liste Touche de déplacement du curseurvers le bas

Revenir à la sélection précédente dans une liste Touche de déplacement du curseurvers le haut

Le tableau ci-dessous répertorie les raccourcis clavier que vous pouvez utiliserpour exécuter des tâches principales dans l'assistant d'installation sous le systèmed'exploitation UNIX ou Linux.


Passer à la zone suivante dans une page Onglet

Revenir à la zone précédente dans une page Maj+Tabulation

Fermer l'assistant d'installation [Alt] + F4

Passer à la sélection suivante dans une liste Touche de déplacement du curseur vers lebas


http://www.ibm.com/able

http://www.ibm.com/able


Revenir à la sélection précédente dans uneliste

Touche de déplacement du curseur vers lehaut

Le tableau ci-dessous répertorie les raccourcis clavier que vous pouvez utiliserpour exécuter des tâches principales dans la page License Agreement de l'assistantd'installation.


Accepter le contrat de licence Alt+A

Refuser le contrat de licence [Alt] + D

Quitter l'assistant d'installation [Alt] + x

Raccourcis clavier pour Cognos ConfigurationLes raccourcis clavier ou les touches de raccourci fournissent une méthode plusfacile et souvent plus rapide pour accéder au logiciel et l'utiliser.

Les raccourcis clavier suivants sont basés sur le clavier standard américain.

Le tableau suivant répertorie les raccourcis clavier que vous pouvez utiliser poureffectuer certaines tâches principales dans IBM Cognos Configuration sur lesystème d'exploitation Windows.


Enregistrer la configuration en cours [Ctrl]+S

Fermer Cognos Configuration [Alt] + F4

Renommer l'élément sélectionné F2

Afficher le menu Fichier [Alt]+F

Afficher le menu Editer Alt+H Alt+E

Afficher le menu Affichage [Alt]+V

Afficher le menu Actions Alt+A

Afficher le menu Aide [Alt]+H

Le tableau suivant répertorie les raccourcis clavier que vous pouvez utiliser poureffectuer certaines tâches principales dans Cognos Configuration sur le systèmed'exploitation UNIX ou Linux.


Enregistrer la configuration en cours Onglet

Fermer Cognos Configuration Maj+Tabulation

Renommer l'élément sélectionné [Alt] + F4


Annexe A. Fichier de configuration du serveur tm1s.cfg

Le fichier tm1s.cfg est un fichier ASCII qui fournit des informationsd'environnement à un serveur IBM Cognos TM1.

Un fichier tm1s.cfg par défaut est créé dans le répertoire de données de CognosTM1 Server lorsque vous installez une copie de Cognos TM1 Server. La plupartdes paramètres disponibles sont documentés dans le fichier de configuration.Lorsqu'un paramètre n'est pas installé par défaut, il est mis en commentaire dansle fichier de configuration. Vous pouvez modifier le fichier tm1s.cfg pour refléterl'environnement du serveur distant associé en annulant la mise en commentaire duparamètre à utiliser et en définissez sa valeur.

Pour obtenir une liste alphabétique de tous les paramètres du fichier deconfiguration, voir «Paramètres du fichier tm1s.cfg», à la page 312.

Emplacement du fichier tm1s.cfgL'emplacement du fichier tm1s.cfg dépend du type de serveur utilisé..v Si vous utilisez l'outil IBM Cognos Configuration pour démarrer et arrêter vos

serveurs IBM Cognos TM1, vous pouvez afficher le chemin de configurationd'un serveur Cognos TM1 en cliquant sur son nom dans l'arborescence del'explorateur de Cognos Configuration.

v Si vous exécutez un serveur distant Cognos TM1 comme service MicrosoftWindows (Tm1sd.exe), et si vous avez utilisé le programme d'installation deCognos TM1 pour installer le serveur, le système utilise le fichier tm1s.cfgfigurant dans le répertoire de données du serveur spécifié lors de l'installation.

v Si vous exécutez le serveur distant Cognos TM1 en tant qu'application Windows(Tm1s.exe), spécifiez l'emplacement du fichier tm1s.cfg à l'aide du paramètre -zsur la ligne de commande lorsque vous démarrez le serveur à partir d'unraccourci ou d'une invite de commande.Par exemple, la commande suivante spécifie que Cognos TM1 utilise le fichiertm1s.cfg situé dans le répertoire c:\salesdata :c:\ProgramFiles\Cognos\TM1\bin\tm1s.exe-z c:\salesdata

Si le paramètre -z pointe à un répertoire contenant des espaces, vous devezmettre ce nom de répertoire entre doubles guillemets. Par exemple, -z "c:\salesdata".

v Si vous exécutez un serveur Cognos TM1 sous UNIX, et si vous avez utilisé leprogramme d'installation de Cognos TM1 pour installer le serveur, le systèmeutilise le fichier tm1s.cfg figurant dans le répertoire de données du serveurspécifié lors de l'installation.

Exemple de fichier tm1s.cfgVoici un exemple de fichier tm1s.cfg.

Votre fichier tm1s.cfg peut également inclure des commentaires décrivant cesparamètres.#Security mode


#(there are typically some information comments here.)

[TM1S]

ServerLogging=F

SecurityPackageName=Kerberos


UseSSL=T

ServerName=Planning Sample

DataBaseDirectory=C:\Program Files\Cognos\TM1\Custom\TM1Data\PlanSamp\

AdminHost=xxxxxxxx

PortNumber=12345

ClientMessagePortNumber= 5433

Language=ENG

Savetime=

Downtime=

ProgressMessage=True

AuditLogOn=F

AuditLogMaxFileSize= 100 MB

AuditLogUpdateInterval=60

#ServerCAMURI=http://L3L0833-6457A26:9300/p2pd/servlet/dispatch

#ClientCAMURI=http://L3L0833-6457A26/ibmcognos/cgi-bin/cognos.cgi

#ClientPingCAMPassport=900

#Optional CAM parameters

#CAMSSLCertificate=

#SkipSSLCAMHostCheck=TRUE

#SkipSSLCAMHostCheck=TRUE

Paramètres du fichier tm1s.cfgLes paramètres du fichier tm1s.cfg sont décrits ci-après.

Paramètre dynamique

Les valeurs de paramètre dynamique peuvent être modifiés lorsque le serveur IBMCognos TM1 est en cours d'exécution.

Le serveur Cognos TM1 vérifie continuellement le fichier tm1s.cfg toutes les60 secondes pour déterminer si des valeurs de paramètre dynamique ont changé.Si le serveur détecte un changement de valeur de paramètre, la nouvelle estappliquée immédiatement. Les paramètres dynamiques sont identifiés par lamention "dynamic" dans cette liste.

Paramètre statique

Les valeurs de paramètre statiques sont lues à partir du fichier tm1s.cfguniquement au démarrage du serveur IBM Cognos TM1. Pour modifier une valeurde paramètre statique, vous devez arrêter le serveur Cognos TM1, éditer la valeurdans le fichier tm1s.cfg, puis redémarrer le serveur.

La plupart des paramètres du fichier tm1s.cfg sont statiques.


Espaces dans les valeurs

Si une valeur de paramètre contient des espaces, mettez-la entre guillemetsdoubles.

AdminHostIndique le nom ou l'adresse IP de l'hôte Admin sur lequel un serveur admin estexécuté.

Type de paramètre : obligatoire, statique

Vous pouvez spécifier plusieurs hôtes Admin en séparant leur nom par unpoint-virgule pour une exécution sous Microsoft Windows ou par un deux-pointspour une exécution sous UNIX. Par exemple :v Utilise le format AdminHost=hostname1;hostname2 sur un serveur Windows

Cognos TM1.v Utilisez le format AdminHost=hostname1:hostname2 sur un serveur UNIX Cognos

TM1.

Voici quelques exemples :v AdminHost=boston;newyork

v AdminHost=192.168.1.17;192.168.1.22

v AdminHost=boston;192.168.1.17;192.168.1.22;myserver;192.168.1.40

Remarque : La chaîne spécifiant le ou les hôtes Admin est limitée à 1020 caractèresou octets.

AllowReadOnlyChoreRescheduleDonne aux utilisateurs l'accès en lecture à une tâche, ainsi que la capacité d'activer,désactiver et replanifier des tâches.


Lorsque la ligne AllowReadOnlyChoreReschedule=T est ajoutée au fichier Tm1s.cfgpour un serveur, les utilisateurs ayant l'accès en lecture à une tâche peuventcliquer à l'aide du bouton droit de la souris sur une tâche dans l'explorateur deserveur et basculer l'option Activer le planning ou sélectionner l'option Editer unetâche. L'option Editer une tâche n'est disponible que si une tâche n'est pas activée.

Quand un utilisateur ayant l'accès Lecture pour une tâche choisit l'option Editerune tâche, seul l'écran de planification de l'assistant de définition de tâche s'affiche.

Cet écran permet à l'utilisateur de définir les paramètres de planification de latâche, mais ne lui permet pas d'éditer la liste des processus qui composent la tâche.

AllowSeparateNandCRulesLorsqu'il est activé, ce paramètre permet de spécifier des expressions de règle pourles niveaux N: et C: sur des lignes distinctes, avec des définitions identiquesd'AREA.


Par exemple :

Annexe A. Fichier de configuration du serveur tm1s.cfg 313

[’Budget’,’Argentina’]=N:Expression;

[’Budget’,’Argentina’]=C:Expression;

sont toutes deux des instructions de règles valides quand le paramètreAllowSeparateNandCRules est présent dans le fichier Tm1s.cfg et a la valeur T.

Ce paramètre a également un impact sur la façon d'appliquer les règles à descellules de type numérique et chaîne. Sans ce paramètre, la première instruction derègle rencontrée pour une définition AREA donnée est appliquée aux cellulesconcernées par cette définition. Si une cellule de la définition AREA est numériqueet que la règle s'applique aux chaînes, alors la cellule n'est pas considérée commecalculée par des règles puisque la correspondance établie ne s'appliquait pas à lacellule.

Prenons l'exemple des instructions suivantes :[’1 Quarter’]=s:’str_value’;Not following.

[’1 Quarter’]=n:77;

Si le paramètre AllowSeparateNandCRules p n'est pas défini (ou a la valeur F),alors la première instruction de règle concernera toute cellule qui utilise '1 Quarter'comme l'un de ses éléments. Si la cellule est de type chaîne, la valeur de la celluleaura la valeur 'str_value'. Si la cellule est de type numérique, la cellule ne sera pasconsidérée comme calculée par des règles puisqu'une correspondance a été établie(la première règle) mais que la règle elle-même ne s'appliquait pas.

Si le paramètre AllowSeparateNandCRules a la valeur T, alors les cellules de typechaîne qui utilisent '1 Quarter' prendront la valeur 'str_value' et celles de typenumérique la valeur 77.

Pour régler ce paramètre à T, ajoutez la ligne suivante au fichier Tm1s.cfg :AllowSeparateNandCRules=T

AllRuleCalcStargateOptimizationLe paramètre AllRuleCalcStargateOptimization permet d'optimiser lesperformances en cas de calcul de vue contenant uniquement des valeurs calculéespar règle.


En général, Cognos TM1 effectue les calculs pour les consolidations standard, puiscalcule les valeurs des consolidations à base de règles, ce qui peut mener auremplacement des valeurs dans les consolidations standard. Le paramètreAllRuleCalcStargateOptimization assure l'optimisation puisqu'il commence parvérifier si les valeurs de la vue sont calculées par règle. Ensuite, il procède ainsi :v Si chaque valeur de la vue est calculée par règle, Cognos TM1 évite des calculs

inutiles pour les consolidations standard et traite uniquement les consolidationscalculées par règle.

v Si la vue contient ne serait-ce qu'une valeur qui n'est pas calculée par règle, ceparamètre d'optimisation n'aura aucun effet.

Si ce paramètre prend la valeur True, certains traitements supplémentaires aurontlieu pour chacune des vues où il convient de vérifier tout d'abord qu'il n'existe quedes valeurs calculées par règle. Pour la plupart des vues, ce traitement


supplémentaire s'avère minime puisque l'optimisation cesse dès la détection d'unepremière valeur qui n'est pas calculée par règle.

Pour activer ce paramètre, affectez-lui la valeur T dans le fichier de configurationdu serveur Cognos TM1, Tm1s.cfg, en procédant comme suit :AllRuleCalcStargateOptimization=T

Par défaut, le paramètre est désactivé (F).

ApplyMaximumViewSizeToEntireTransactionApplique MaximumViewSize à toute la transaction au lieu de l'appliquer auxcalculs individuels.

Type de paramètre : facultatif, dynamique

Par défaut MaximumViewSize vérifie les traitements individuel des vues. Si, parexemple, 10 vues sont traitées en une seule transaction, le seuil n'est dépassé que sile traitement d'une seule vue atteint le seuil. Voir «MaximumViewSize», à la page349.

Lorsque ce paramètre a la valeur True, l'utilisation cumulée de la mémoire pour letraitement de toutes les vues d'une transaction est comparée à la valeur de seuil.Ainsi, un plus grand nombre de transactions consommant beaucoup de mémoiresont détectées.

Remarque : L'exécution du processus TI, y compris tous les processus TI enfants,compte pour une seule transaction.ApplyMaximumViewSizeToEntireTransaction=T

La valeur par défaut est F.

AuditLogMaxFileSizeIndique la taille de fichier maximale qu'un fichier d'audit peut atteindre avantd'être fermé et qu'un nouveau fichier soit créé.


L'unité de cette valeur doit être les ko (kilooctets), Mo (mégaoctets), ou Go(gigaoctets). Par exemple, pour limiter la taille du fichier journal à 100 Mo, entrez :

AuditLogMaxFileSize=100 MB

La plage de valeurs est la suivante :v Valeur par défaut : 100 Mov Valeur minimale : 1 kov Valeur maximale : 2 Go

AuditLogMaxQueryMemoryIndique la quantité de mémoire maximale qu'IBM Cognos TM1 peut utiliser lorsde l'exécution d'une requête de journal d'audit et de l'extraction de l'ensemble derésultats.



L'unité de cette valeur doit être les ko (kilooctets), Mo (mégaoctets), ou Go(gigaoctets). Par exemple :

AuditLogMaxQueryMemory=100 MB

La plage de valeurs est la suivante :v Valeur par défaut : 100 Mov Valeur minimale : 1 kov Valeur maximale : 2 Go

AuditLogOnActive la journalisation d'audit (T) ou la désactive (F).


Par exemple :v Pour activer la journalisation d'audit, définissez AuditLogOn=T.v Pour désactiver la journalisation d'audit, définissez AuditLogOn=F.


AuditLogUpdateIntervalIndique en minutes la durée minimale pendant laquelle IBM Cognos TM1 attendavant de déplacer les événements depuis le journal d'audit temporaire vers lejournal d'audit final.


Par exemple :

AuditLogUpdateInterval=60

La valeur par défaut est de 60 (soixante minutes).

La valeur minimale est de 1 (une minute).

Remarque : Vous pouvez à tout moment mettre à jour manuellement le journald'audit avec les événements les plus récents, en utilisant la commande Traitementdes événements du journal d'audit dans l'explorateur de serveur. Pour plus dedétails, voir la section «Mise à jour du journal d'audit à l'aide des événements lesplus récents» dans le document IBM Cognos TM1 Operations.

AutomaticallyAddCubeDependenciesIndique si les dépendances de cube sont définies automatiquement, ou si vousdevez les identifier manuellement pour chaque cube.


Le serveur IBM Cognos TM1 établit les dépendances de manière à pouvoirinvalider les caches de calcul des cubes lorsque les données des cubes sontmodifiées. Pour plus de détails, voir "Description de la dépendance de cube" dansTM1 Operations.


Lorsque ce paramètre a la valeur True (valeur par défaut), les dépendances DB(...)basées sur les règles intercubes sont détectées et définies automatiquement aumoment du démarrage du serveur. De plus, lorsqu'une règle est éditée, enregistréeou recompilée, les dépendances qu'elle exprime, provenant des fonctions DB(),ATTRS() ou ATTRN(), sont automatiquement ré-établies.

Lorsque ce paramètre a la valeur False, les dépendances DB(...) basées sur lesrègles intercubes ne sont pas détectées et ne sont pas définies au moment dudémarrage du serveur. Elles sont établies lors de l'exécution d'une requête. Dans cecas, une requête peut en bloquer d'autres à cause d'une nouvelle dépendance.AutomaticallyAddCubeDependencies=F

Valeur par défaut : T

CacheFriendlyMallocPermet l'alignement de la mémoire qui est spécifique à la plateforme IBM Power.


Les tests ont montré que l'activation de ce paramètre donne les meilleurs résultatspour les scénarios d'utilisation impliquant un grand nombre d'utilisateurs. Pourceux qui impliquent un seul ou quelques utilisateurs, le bénéfice peut être faible ounul. Par défaut, CacheFriendlyMalloc=F.

Pour activer l'option, ajoutez la liste suivante à votre fichier tm1s.cfg :CacheFriendlyMalloc=T

CalculationThresholdForStorageDéfinit un nombre minimum pour les calculs de règle requis pour une seule celluleou une vue Stargate ; au-delà de ce nombre, le serveur IBM Cognos TM1 stockeles calculs pour les utiliser pendant la session de serveur courante.


Par exemple, quand un utilisateur demande des valeurs calculées par des règles auserveur Cognos TM1, soit depuis une seule cellule, soit depuis une vue Stargate, leserveur doit généralement effectuer de nombreux calculs pour arriver aux valeursqui sont calculées par des règles.

Le paramètre CalculationThresholdForStorage a un effet direct sur l'utilisation demémoire et la performance. Une valeur haute réduit l'utilisation de mémoire etdonne une performance plus lente. Une valeur basse augmente la consommationde mémoire et accélère la performance.

Si CalculationThresholdForStorage est omis dans Tm1s.cfg, la valeur par défaut est50.

CAMPortalVariableFileChemin du fichier variables_TM1.xml dans l'installation IBM Cognos.

Type de paramètre : Obligatoire pour les fonctions d'interopérabilité d'IBM,statique.


Le paramètre CAMPortalVariableField est requis uniquement en cas d'utilisationd'IBM Cognos Analytics avec Cognos TM1 Web et Cognos TM1 Server.

Définissez un chemin relatif pour ce paramètre :

CAMPortalVariableFile=portal\variables_TM1.xml

Remarque : L'emplacement exact du fichier sur le serveur IBM Cognos Analyticsest : répertoire Cognos\templates\ps\portal\variables_TM1.xml.

CAMUseSSLIndique que toutes les communications entre TM1 et le serveur IBM CognosAnalytics doivent utiliser SSL.


Valeur par défaut : False

CheckFeedersMaximumCellsCe paramètre restreint le nombre de cellules vérifiées par l'option Vérification desfeeders dans Cube Viewer.

Le paramètre CheckFeedersMaximumCells est facultatif et peut être ajouté àTm1s.cfg. S'il n'est pas inclus dans Tm1s.cfg, Vérifier les feeders vérifie 3 000 000cellules par défaut.


Lors de la vérification des feeders depuis une cellule fortement consolidée, CognosTM1 doit vérifier toutes les intersections qui s'appliquent à la cellule. Dans lesapplications volumineuses, le serveur Cognos TM1 reste indisponible pendant unassez long moment au cours de la vérification de toutes les intersections parCognos TM1.

Pour limiter le nombre de cellules vérifiées lors de l'utilisation de Vérifier lesfeeders (ce qui limite la durée d'indisponibilité du serveur Cognos TM1), ajoutezCheckFeedersMaximumCells à Tm1s.cfg et réglez le paramètre sur le nombre decellules à vérifier.

Par exemple, pour limiter la vérification des feeders à 1 000 000 cellules, entrez laligne suivante :

CheckFeedersMaximumCells=1,000,000

ClientCAMURIURI d'IBM Cognos Server définie dans IBM Cognos Connection et permettantd'authentifier les clients Cognos TM1.


L'URI doit avoir la forme http[s]://<hôte>/<emplacement cognos>/cgi-bin/cognos.cgi.

Par exemple, http://10.121.25.121/ibmcognos/cgi-bin/cognos.cgi


ClientExportSSLSvrCertSpécifie si un client IBM Cognos TM1 doit extraire le certificat de l'autorité decertification, utilisé initialement pour émettre le certificat du serveur TM1, depuisle magasin de certificats Microsoft Windows.

Type de paramètre : facultatif (requis pour SSL), statique

Si ClientExportSSLSvrCert=T, le certificat de l'autorité de certification est exportédu magasin de certificats de l'ordinateur client TM1, à sa demande.


ClientExportSSLSvrKeyIDDéfinit la clé d'identité utilisée par un client IBM Cognos TM1 pour exporter lecertificat de l'autorité de certification, utilisé initialement pour émettre le certificatdu serveur TM1, depuis le magasin de certificats Microsoft Windows.


ClientPingCAMPassportIndique l'intervalle, en secondes, pendant lequel un client doit envoyer unecommande ping au serveur Cognos Authentication Management pour maintenirson passeport actif.


Si une erreur se produit ou si le passeport expire, l'utilisateur est déconnecté duserveur Cognos TM1 .

Valeur par défaut : 900

ClientMessagePortNumberIdentifie un port secondaire utilisé pour accepter les messages des clientsconcernant la progression et l'annulation finale d'une longue opération sansbloquer les réserves de processus.

Type de paramètre : facultatif, statique pour les modifications, définidynamiquement .

Si aucun numéro de port n'est spécifié dans le fichier de configuration, le numérodu port est choisi de façon dynamique et défini au démarrage du serveur. Il estcependant impossible de le modifier pendant l'exécution du serveur.

Ce port additionnel assure la continuation du traitement des autres requêtes deserveur sans attendre l'annulation par l'utilisateur.

Par défaut, le numéro de port est affecté automatiquement et dynamiquementlorsque le serveur Cognos TM1 démarre. Vous n'avez pas à définirClientMessagePortNumber sur un numéro spécifique, à moins que les pare-feu ouautres questions de réseau n'exigent que le port d'écoute soit un nombre bienconnu.


ATTENTION :Si vous choisissez d'affecter une valeur spécifique au paramètreClientMessagePortNumber, au lieu de conserver son affectation dynamique,vous devez affecter des numéros uniques à tous les ports des messages client etserveur de Cognos TM1 que vous utilisez. Si deux serveurs utilisant le mêmenuméro de port sont exécutés sur le même ordinateur, l'activité de messages peutentraîner un conflit ou un blocage du système.

Voir aussi «PortNumber», à la page 357 et «ProgressMessage», à la page 359.

ClientPropertiesSyncIntervalIndique la fréquence (en secondes) à laquelle les propriétés du client sont mises àjour dans le cube de contrôle }ClientProperties. Ce paramètre est défini à1800 secondes de façon à mettre à jour le cube toutes les 30 minutes.

Des mises à jour trop fréquentes consomment inutilement du temps processeur etrisquent d'empêcher les utilisateurs de se connecter/déconnecter tout au long del'opération.


ClientVersionMaximumSpécifie la version client maximale qui peut se connecter au serveur IBM CognosTM1.


La valeur du paramètre ClientVersionMaximum est exprimée sous forme de chaînede version selon le format suivant :

m.n.tffhh

m = numéro de la version majeure,

n = numéro de la version mineure

t = numéro de la version de maintenance

ff = numéro du groupe de correctifs

hh = numéro du correctif logiciel

D'après ce format, le paramètre ClientVersionMaximum = 9.4.10305 spécifie que laversion client maximale qui peut se connecter au serveur est 9.4.1.

Si votre fichier Tm1s.cfg ne contient pas de valeur pour le paramètreClientVersionPrecision, seuls les numéros de version majeure, de version mineureet de version de maintenance sont utilisés pour assurer la compatibilité entre leclient et le serveur. D'après l'exemple ci-dessus,

Si le paramètre ClientVersionMaximum n'est pas défini explicitement, la valeur pardéfaut est égale à la version de serveur actuellement installée.

Les valeurs de paramètre valides sont comprises entre x00 et la version du serveuractuellement installée, où x est le numéro de la version majeure du serveur TM1


actuellement installé. Par exemple, les valeurs valides de paramètre pour TM1Server 9.0 SP3 sont comprises entre 900 et 903.

Vous ne pouvez pas définir le paramètre ClientVersionMaximum à une valeursupérieure à celle de version de serveur installée couramment. Vous ne pouvez pasconnecter à des versions de serveur plus anciennes.

ClientVersionMinimumSpécifie la version client minimale qui peut se connecter au serveur IBM CognosTM1.


La valeur du paramètre ClientVersionMinimum est exprimée sous forme de chaînede version selon le format suivant :

m.n.tffhh






D'après ce format, le paramètre ClientVersionMinimum = 9.4.10305 spécifie que laversion client minimale qui peut se connecter au serveur est 9.4.1.

Si votre fichier Tm1s.cfg ne contient pas de valeur pour le paramètreClientVersionPrecision, seuls les numéros de version majeure, de version mineureet de version de maintenance sont utilisés pour assurer la compatibilité entre leclient et le serveur.

Si le paramètre ClientVersionMinimum n'est pas défini explicitement, la valeur pardéfaut est 8.4.00000, soit la version 8.4.

Vous ne devez pas définir le paramètre ClientVersionMinimum sur une valeurinférieure à celle de la version majeure du serveur Cognos TM1 actuellementinstallé. Il n'y a pas de limite supérieure pour ClientVersionMinimum. SiClientVersionMinimum est supérieur à ClientVersionMaximum, seuls les clientsdont le numéro de version est égal à ClientVersionMaximum peuvent se connecterau serveur.

ClientVersionPrecisionCe paramètre vous permet d'identifier de façon plus précise les versions minimaleset maximales des clients qui peuvent se connecter au serveur IBM Cognos TM1.


La valeur des paramètres ClientVersionMinimum et ClientVersionMaximum sontexprimées sous forme de chaîne de version selon le format suivant :


m.n.tffhh






D'après ce format, la chaîne de version 9.4.10305 indique qu'il s'agit de la versionmajeure 9, de la version mineure 4, de la version de maintenance 1, du groupe decorrectifs 3 et du correctif logiciel 5.

Si le paramètre ClientVersionPrecision n'est pas défini dans le fichier Tm1s.cfg ousi sa valeur est 0, seuls les numéros de version majeure, de version mineure et deversion de maintenance sont utilisés pour assurer la compatibilité entre le client etle serveur. Dans ce cas, tout client équipé d'au moins la version majeure 9, laversion mineure 4 et la version de maintenance 1 peut se connecter au serveur.

Vous pouvez appliquer une compatibilité de versions encore plus étroite entre leclient et le serveur en ajoutant le paramètre ClientVersionPrecision au fichierTm1s.cfg et en lui donnant l'une des valeurs suivantes.v 1 - Indique que le numéro du groupe de correctifs sera pris en compte, mais pas

le numéro du correctif logiciel.v 2 - Indique que le numéro du groupe de correctifs et le numéro du correctif

logiciel seront tous les deux pris en compte.

Exemples

Si ClientVersionMinimum = 9.4.10305 et ClientVersionPrecision = 1, seuls les clientséquipés de la version majeure 9, de la version mineure 4, de la version demaintenance 1, du groupe de correctifs 3 ou ultérieur peuvent se connecter auserveur. Dans ce cas, le numéro de correctif logiciel n'est pas pris en compte pourdéterminer la compatibilité serveur/client.

Si ClientVersionMinimum = 9.4.10305 et ClientVersionPrecision = 2, seuls les clientséquipés de la version majeure 9, de la version mineure 4, de la version demaintenance 1, du groupe de correctifs 3, du correctif logiciel 5 ou ultérieurpeuvent se connecter au serveur. Dans ce cas, les numéros du groupe de correctifset du correctif logiciel sont tous les deux pris en compte pour déterminer lacompatibilité serveur/client.

CognosMDX.AggregateByAncestorRefLorsque cela est possible, remplace l'agrégation sur un ensemble de membres parune référence à un ancêtre, si l'ensemble de membres agrégés comporte unensemble complet de descendants et si tous les membres ont la pondération 1.

Par exemple, l'agrégation aggregate(children(<Member>)) peut être remplacée parune référence à <Member>.



Ce paramètre n'est applicable que lors de l'utilisation de TM1 avec IBM CognosAnalytics.

Pour activer CognosMDX.AggregateByAncestorRef, ajoutez la ligne suivante aufichier tm1s.cfg :CognosMDX.AggregateByAncestorRef=true

Valeur par défaut : false.

CognosMDX.CellCacheEnableAutorise le moteur MDX d'IBM Cognos à modifier les stratégies de mise en cachedes cellules de consolidation et de calcul de TM1.


Ce paramètre n'est applicable que lors de l'utilisation de TM1 avec CognosAnalytics.

Valeur par défaut : true

CognosMDX.PrefilterWithPXJEtend la méthode cross join du fournisseur de source de données aux ensemblesde filtres imbriqués.


Ce paramètre n'est applicable que lors de l'utilisation de TM1 avec IBM CognosAnalytics.

Ce paramètre est actif uniquement dans les cas suivants : vv CognosMDX.UseProviderCrossJoinThreshold a une valeur supérieure à 0 dans le

fichier tm1s.cfg

v UseProviderCrossJoinThreshold a une valeur supérieure à 0 dans le fichier deconfiguration qfs_config.xml de Cognos Analytics.

Pour activer CognosMDX.PrefilterWithPXJ, ajoutez la ligne suivante au fichiertm1s.cfg :CognosMDX.PrefilterWithPXJ=true

Valeur par défaut : false.

CognosMDX.SimpleCellsUseOPTSDKApplique les stratégies de mise en cache des cellules de consolidation et de calculdu moteur MDX d'IBM Cognos à toutes les cellules des résultats de requête.



Lorsque CognosMDX.SimpleCellsUseOPTSDK n'est pas activé, les stratégies demise en cache des cellules de consolidation et de calcul sont appliquéesuniquement aux cellules des résultats de requête associées à des membres calculés.



CognosMDX.UseProviderCrossJoinThresholdApplique la stratégie cross join du fournisseur de sources de données, même si ellen'est pas explicitement activée dans IBM Cognos Analytics.



L'activation de CognosMDX.UseProviderCrossJoinThreshold a le même effet quel'activation du paramètre UseProviderCrossJoinThreshold dans le fichierqfs_config.xml de Cognos Analytics.

UseProviderCrossJoinThreshold détermine si les combinaisons de membres d'unearête qui n'ont pas de valeur de mesure sont extraites du serveur TM1.UseProviderCrossJoinThreshold est activé lorsque sa valeur est supérieure à 0.

Remarque : Si le paramètre UseProviderCrossJoinThreshold est activé dans lefichier qfs_config.xml de Cognos Analytics, il a la priorité sur le paramètreCognosMDX.UseProviderCrossJoinThreshold du fichier tm1s.cfg.

Pour activer CognosMDX.UseProviderCrossJoinThreshold, ajoutez-le au fichiertm1s.cfg avec une valeur supérieure à 0, par exemple :CognosMDX.UseProviderCrossJoinThreshold=1000


CognosTM1InterfacePathPrécise l'emplacement du serveur IBM Cognos Business Intelligence à utiliser lorsde l'importation des données d'un pack Cognos vers TM1 à l'aide d'IBM CognosTM1 Package Connector.

Pour plus d'informations, voir IBM Cognos TM1 TurboIntegrator .

Type de paramètre : facultatif lors de l'utilisation de Cognos TM1 PackageConnector, statique

CreateNewCAMClientsLe paramètre de configuration serveur CreateNewCAMClients détermine lamanière dont le serveur TM1 gère une tentative de connexion au serveur avec desdonnées d'identification CAM en l'absence d'un client TM1 correspondant.


Si CreateNewCAMClients=T et qu'une connexion est tentée avec un ensemble validede données d'identification CAM, mais qu'il n'existe aucun client TM1correspondant, le client TM1 est créé lors de la connexion. Il s'agit ducomportement par défaut si CreateNewCAMClients n'est pas défini dans le fichierTm1s.cfg.


Si CreateNewCAMClients=F et qu'une connexion est tentée avec un ensemble validede données d'identification CAM, mais qu'il n'existe aucun client TM1correspondant, le client TM1 n'est pas créé et la connexion est rejetée.

Par l'intermédiaire de l'API C, le code d'erreur est SystemServerClientNotFound.Par l'intermédiaire du noeud final HTTP, une erreur 401 Non autorisé est renvoyée,les informations d'authentification dépendant des paramètres de configuration duserveur. En outre, si la connexion est rejetée, un message de journal est consignédans le gestionnaire de journalisation CAMSecurity.ClientCreation au niveauAVERTISSEMENT, si ce niveau de journalisation est activé. Le message de journalinclut le texte «CAM Client not found, and not created due toCreateNewCAMClients config setting.»

DataBaseDirectorySpécifie le répertoire de données à partir duquel le serveur charge les cubes,dimensions et autres objets.

Vous pouvez spécifier plusieurs répertoires de données en les séparant par unpoint-virgule.

Type de paramètre : obligatoire, statique

Pour plus d'informations, voir «Présentation du répertoire de données», à la page25.

DefaultMeasuresDimensionIndique si une dimension de mesures est créée. IBM Cognos TM1 ne requiert pasqu'une dimension de mesures soit définie pour un cube. Facultativement, vouspouvez définir une dimension de mesures en modifiant les propriétés de cube.

Pour plus d'infomations, reportez-vous à la rubrique "}CubeProperties" dudocument IBM Cognos TM1 Operation.

Type de paramètre : Facultatif, mais certaines applications OLAP peuvent exiger ceparamètre (voir les détails dans la description ci-dessous), statique

Certaines applications OLAP exigent qu'une dimension de mesures soit présentedans tous les cubes, et elles peuvent échouer si cette dimension n'existe pas. Pourrépondre aux besoins de ces applications, définissez DefaultMeasureDimension=T defaçon à demander au serveur Cognos TM1 de définir automatiquement la dernièredimension d'un cube comme dimension de mesures lorsqu'un nouveau cube estcréé sur le serveur Cognos TM1.

Si DefaultMeasureDimension est défini sur F ou omis du fichier Tm1s.cfg, aucunedimension de mesures n'est définie lors de la création d'un cube.

DisableMemoryCacheDésactive la mémoire cache utilisée par le gestionnaire de mémoire IBM CognosTM1.


Activez ce paramètre uniquement pour déboguer des fuites de mémoire.L'activation de ce paramètre peut dégrader la performance du serveur.


Par exemple, le paramètre DisableMemoryCache=T désactive la mémoire cacheutilisée par le gestionnaire de mémoire IBM Cognos TM1. Le paramètre par défautest DisableMemoryCache=F.

DisableSandboxingDétermine si les utilisateurs ont la possibilité d'utiliser les bacs à sable surl'ensemble du serveur.


Par défaut, ce paramètre ne figure pas dans le fichier de configuration ou est définisur F : la fonctionnalité de bac à sable est alors activée pour tous les utilisateurs.DisableSandboxing=F

Lorsque les bacs à sable sont activés de cette manière, les administrateurs peuventrecourir à la fonction d'affectation des droits pour Refuser ou Accorder l'utilisationdes espaces de travail personnels ou de plusieurs bacs à sable à chaque utilisateurindividuellement. Pour plus de détails, reportez-vous à la rubrique "Affectation desdroits" du document IBM Cognos TM1 Operations.

Pour placer tous les groupes d'utilisateurs en mode d'écriture différée directe,ajoutez la ligne suivante au fichier Tm1s.cfg :DisableSandboxing=T

Lorsque DisableSandboxing=T, l'affectation de droits est ignorée.

Important : N'utilisez pas DisableSandboxing=T dans le fichier de configurationdes serveurs TM1 qui déploient et prennent en charge des applications TM1. Cesserveurs nécessitent que la fonction de bac à sable soit activée dans leur fichier deconfiguration.

Display_Info_DBType_R8Display_Info_DBType_R8 commande au serveur IBM Cognos TM1 de stocker lesdonnées de colonne DISPLAY_INFO en tant que DBTYPE_R8.


Contactez le support client pour déterminer si ce paramètre s'applique à votresystème Cognos TM1.

Par défaut, Cognos TM1 stocke les données DISPLAY_INFO en tant queDBTYPE_UI4. Quand le fournisseur de base de données OLE de Cognos TM1traite une requête de ADO 2.7 pour les données de colonne DISPLAY_INFO, il doitconvertir les données des colonnes Cognos TM1 de DBTYPE_UI4 à DBTYPE_R8.Le fournisseur de base de données OLE de Cognos TM1 renvoie alors les donnéesde colonne converties au client de base de données OLE (ADO dans ce cas).

ADO 2.7 attend IRowset::GetData pour renvoyer un nombre entier, et utiliseseulement les quatre premiers octets des données de colonne converties. Toutefois,les données renvoyées sont un nombre réel à 8 octets, et toutes les informationsdes quatre derniers octets sont perdues. ADO 2.7 renvoie alors des zéros pour tousles éléments de la colonne DISPLAY_INFO.

Quand le paramètre Display_Info_DBType_R8 est inclus dans le fichier Tm1s.cfg etdéfini à T, le serveur Cognos TM1 stocke les données de colonne DISPLAY_INFO


comme DBTYPE_R8 avec les quatre octets pertinents d'informations dans lesquatre premiers octets. Le paramètre Display_Info_DBType_R8 garantit que lesinformations ne sont pas perdues lorsque ADO reconvertit les données à unnombre entier de 4 octets. Il garantit aussi qu'ADO 2.7 renvoie les valeurscorrectes pour les propriétés d'un membre d'ensemble de lignes d'axe. En outre,tout client de base de données OLE (par exemple ADO 2.6) demandant la propriétéDISPLAY_INFO comme valeur de 4 octets obtient également les valeurs correctes.

DistributedPlanningOutputDirDistributedPlanningOutputDir définit le répertoire dans lequel les données TUnitsont écrites lors du déploiement d'une application Cognos Insight répartie.


Les clients Cognos Insight Ditributed ont besoin de données appelées des "tunit".Ces données sont créées lorsqu'une application est déployée et mise à jour alorsque le serveur Cognos TM1 s'exécute. L'emplacement du répertoire utilisé à ceteffet est défini à l'aide de ce paramètre.

Pour déployer les applications client Cognos Insight réparties à l'aide de cette basede données, supprimez la mise en commentaire de ce paramètre ou ajoutez-le. Ildoit avoir la valeur suivante : DistributedPlanningOutputDir=<emplacement durépertoire tunit>.

Le chemin peut être entré sous sa forme absolue, ou relative par rapport aurépertoire de données du serveur Cognos TM1.

Par exemple :

Tableau 37. Exemples de chemin d'accès au répertoire pour le paramètreDistributedPlanningOutputDir

Exemple de valeur Résultat

DistributedPlanningOutputDir=tunit Crée un répertoire tunit sous le répertoirede données du serveur Cognos TM1.

DistributedPlanningOutputDir=../tunit Crée un répertoire tunit au même niveauque le répertoire de données de CognosTM1.

DistributedPlanningOutputDir=C:\ProgramFiles\IBM\cognos\tm1\samples\tm1\GO_New_Stores\tunit

Crée un répertoire tunit à l'emplacementindiqué.

DownTimeSpécifie l'heure d'arrêt automatique du serveur.


Le format du paramètre DownTime est jj:hh:mm où :v jj est le nombre de jours, aujourd'hui étant le point de départ. (par exemple, 00

est aujourd'hui, 01 est demain, etc.)v hhmm est l'heure du jour en format 24 heures.

Par exemple, DownTime = 01:03:30 spécifie que vous voulez arrêter le serveur lelendemain à 3:30 du matin.


Le paramètre DownTime n'est pas disponible lorsque le serveur Cognos TM1s'exécute en tant que service Windows.

Lorsque vous utilisez le paramètre DownTime sur le serveur UNIX Cognos TM1,vous devez définir le paramètre RunningInBackground à T. SiRunningInBackground=F, le serveur demande une confirmation avant de s'arrêter etne peut pas s'arrêter sans confirmation manuelle fournie par un administrateur.

EnableNewHierarchyCreationIndique si la création de hiérarchies multiples est activée ou désactivée.

Type de paramètre : facultatif (requis pour les hiérarchies multiples), dynamique

Par défaut, le paramètre EnableNewHierarchyCreation est défini sur F (false). Sivous utilisez plusieurs hiérarchies, remplacez la valeur de ce paramètre par T(true). Le document TM1 - Guide de référence répertorie les fonctions deTurboIntegrator permettant de gérer les dimensions et les fonctions équivalentespermettant de gérer des hiérarchies spécifiques dans les dimensions.

EnableTIDebuggingIndique si les fonctionnalités de débogage de TurboIntegrator sont activées oudésactivées.


Par défaut, le paramètre EnableTIDebugging est défini sur F (false).

Si vous souhaitez utiliser l'une des fonctionnalités de débogage des processusTurboIntegrator de l'API REST TM1, vous devez remplacer la valeur de ceparamètre par T (true). De même, vous devez spécifier T si vous souhaitez utiliserl'utilitaire de débogage de TurboIntegrator, disponible actuellement enprévisualisation sur IBM developerWorks.

Important : Le débogage des processus TurboIntegrator peut consommer unequantité importante de ressources système. Il est recommandé de ne spécifierEnableTIDebugging=T que lors du débogage des processus dans un environnementde développement ; ce paramètre ne doit pas être activé dans un environnementde production.

ExcelWebPublishEnabledAutorise la publication de fichiers Microsoft Excel dans IBM Cognos TM1 Web,ainsi que l'exportation de fichiers Microsoft Excel depuis Cognos TM1 Web, siMicrosoft Excel n'est pas installé sur le serveur Web. Activez le paramètreExcelWebPublishEnabled si certains de vos clients TM1 10.1 se connectent à desserveurs TM1 10.2.2.


Si ExcelWebPublishEnabled=T, les fichiers Microsoft Excel dans les applicationsCognos TM1 peuvent être publiés dans Cognos TM1 Web sans utiliser MicrosoftExcel sur le serveur Web. De même, les feuilles Web et la vue de cube peuvent êtreexportées depuis Cognos TM1 Web sans utiliser Microsoft Excel sur le serveurWeb.


https://www.ibm.com/support/knowledgecenter/SSD29G_2.0.0/com.ibm.swg.ba.cognos.tm1_rest_api.2.0.0.doc/c_preface_tm1_odata.html

https://www.ibm.com/developerworks/

Si Microsoft Excel n'est pas disponible sur le serveur Web, les fichiers MicrosoftExcel dans les applications Cognos TM1 doivent être publiés explicitement dansCognos TM1 Web.

Pour plus de détails sur la procédure de publication des fichiers Microsoft Excel,reportez-vous au document IBM Cognos TM1 Developer.

Pour plus de détails sur les limitations lors de l'exportation depuis Cognos TM1Web sans utiliser Microsoft Excel sur le serveur Web, reportez-vous au documentIBM Cognos TM1 Perspectives, TM1 Architect, and TM1 Web.

Restriction : Il n'est pas possible de publier des fichiers .xlsx de Microsoft Excel2007 dans Cognos TM1 Web si Microsoft Excel n'est pas disponible sur le serveurWeb. Ces fichiers doivent être enregistrés au format .xls de Microsoft Excel 2003avant d'être publiés sur Cognos TM1 Web.


FileRetry.CountSpécifie le nombre de nouvelles tentatives.


Par défaut, le serveur TM1 s'arrête lorsque les mises à jour du journal destransactions échouent. La spécification de FileRetry.FileSpec permet de différerl'arrêt du serveur alors que le serveur tente de rétablir la connexion.FileRetry.Count définit le nombre de nouvelles tentatives avec une valeur de typeentier. Si l'échec réseau persiste après le nombre spécifié de nouvelles tentatives, leserveur TM1 s'arrête.


FileRetry.DelaySpécifie l'intervalle entre deux tentatives.


Par défaut, le serveur TM1 s'arrête lorsque les mises à jour du journal destransactions échouent. La spécification de FileRetry.FileSpec permet de différerl'arrêt du serveur alors que le serveur tente de rétablir la connexion.FileRetry.Delay définit l'intervalle (en millisecondes) entre les tentatives. Si l'échecréseau persiste après le nombre spécifié de nouvelles tentatives, le serveur TM1s'arrête.


FileRetry.FileSpecDes problèmes réseau peuvent entraîner l'échec de la mise à jour du journal destransactions, ce qui force généralement le serveur TM1 à s'arrêter. Ce paramètre deconfiguration spécifie le ou les chemins de répertoire des fichiers journaux affectés.



Par défaut, le serveur TM1 s'arrête lorsque les mises à jour du journal destransactions échouent. La spécification de FileRetry.FileSpec permet de différerl'arrêt du serveur alors que le serveur tente de rétablir la connexion. Le nombre denouvelles tentatives et l'intervalle entre chaque tentative sont déterminés parFileRetry.Count et FileRetry.Delay respectivement. Si l'échec réseau persisteaprès le nombre spécifié de nouvelles tentatives, le serveur TM1 s'arrête.

Utilisez un point-virgule comme délimiteur pour spécifier plusieurs chemins. Parexemple,1. FileRetry.FileSpec=c:\production\model\Logs

La logique de nouvelle tentative en cas d'échec de l'écriture est appliquée àtous les fichiers qui se trouvent dans le répertoire "c:\production\model\Logs"et sous ce répertoire.

2. FileRetry.FileSpec=c:\production\model\Logs;\\network.ibm.com\production\LogsLa logique de nouvelle tentative est appliquée en cas d'échec de l'écriture àtous les fichiers dans le répertoire "c:\production\model\Logs" et le partage deréseau de \\network.ibm.com\production\Logs et sous ce répertoire.

Remarque : les message sont écrits dans le journal serveur au niveauavertissement lorsque cette logique est activée.v Le message «Error writing to <NOM_FICHIER>, retry in progress.» est

enregistré lorsqu'une opération d'écriture a échoué et qu'une nouvelle tentativeest en cours.

v Le message «Error writing to <NOM_FICHIER>, retry attempt failed.» estenregistré si la nouvelle tentative échoue.

FIPSOperationModeContrôle le niveau de prise en charge de FIPS (Federal Information ProcessingStandards).


Valeurs autorisées :v 1 : fonctionnement et chiffrements autorisés par le niveau 1 de la norme FIPS

140-2v 2 : chiffrements autorisés par le niveau 1 de la norme FIPS 140-2v 3 : désactivé


Pour remplacer le niveau de prise en charge de FIPS par les chiffrements autoriséspar le niveau 1, par exemple, ajoutez la ligne suivante au fichier tm1s.cfg :FIPSOperationMode=2

ForceReevaluationOfFeedersForFedCellsOnDataChangeLa définition de ce paramètre force la réévaluation d'une instruction de feederlorsque des données sont modifiées.


Lorsque le serveur IBM Cognos TM1 calcule des feeders, le processus peut êtreune "chaîne" de feeders, dans laquelle la cellule A alimente la cellule B, la cellule B


est assortie à une règle qui alimente la cellule C, et ainsi de suite. Les feeders descellules numériques ne sont évalués que lorsqu'une cellule vide reçoit une valeurdifférente de zéro. En effet, la présence d'une valeur différente de zéro dans lacellule implique que des feeders sont déjà définis.

Il n'est pas nécessaire de réévaluer les feeders lorsqu'une valeur passe d'une valeurdifférente de zéro à une autre.

Normalement, lors de l'évaluation d'une règle de feeder, le processus du feeders'arrête si la cellule cible est déjà alimentée.

Le traitement des règles de feeder prend fin, car la présence du feeder dans lacellule cible indique que les règles de feeder de la cellule cible ont déjà étéexécutées. Il n'est donc pas nécessaire de les réexécuter.

Prenons l'exemple des règles de feeder suivantes :[’A’]=>[’B’];

La règle de feeder de la cellule B dépend de certaines valeurs de données de cube :[B]=>DB(cube-name,!dim1,DB(cube2-name,...),!dim2);[’C’]=>[’D’];[’X’]=>[’B’];

Lors de l'évaluation initiale de B, DB(cube2-name,...) est évalué pour produire unnom d'élément, C par exemple. Ainsi, B alimente C et C alimente D. Lorsque lavaleur de la cellule X passe d'une valeur nulle à une valeur non nulle, lamodification alimente également B. Mais B est déjà alimenté. Le processus dufeeder s'arrête donc, et la règle de feeder de B n'est jamais évaluée. Ainsi, toute"modification" du contenu de la règle, qui peut résulter d'une modification desdonnées sous-jacentes ciblée par l'instruction DB(...), n'est jamais évaluée. Si leparamètre ForceReevaluationOfFeedersForFedCellsOnDataChange est défini, laprésence d'un feeder dans la cellule B ne met pas fin au traitement du feeder. Larègle de feeder de B s'exécute. La règle de feeder de B étant dépendante desdonnées, la cible du feeder peut être l'ancien C, ou une autre cellule, et cette cellulesera alimentée. Remarquez que la définition de ce paramètre va engendrer d'autresévaluations de feeder, ce qui peut avoir des répercussions sur les performances.

Pour activer ce paramètre, définissezForceReevaluationOfFeedersForFedCellsOnDataChange=T.

HTTPPortNumberDéfinit le numéro de port sur lequel le serveur TM1 est à l'écoute des demandesHTTP(S) entrantes.


IBM Planning AnalyticsTM1 Server gère l'API REST via ce canal HTTP(S). Leserveur accepte les connexions HTTP standard ou les connexions HTTPS sécuriséespar SSL, en fonction du paramètre UseSSL (voir «UseSSL», à la page 373). SiUseSSL a la valeur T, ce qui active l'utilisation de SSL, le serveur accepteuniquement les connexions HTTPS. Si UseSSL a la valeur F, le serveur accepte lesconnexions HTTP non sécurisées.

Si HTTPPortNumber n'est pas défini dans votre fichier tm1s.cfg, le numéro de port«5001» est affecté automatiquement.


Remarque : Les numéros de port doivent être uniques dans l'ensemble des servicesqui s'exécutent sur un ordinateur, pas seulement dans les serveurs TM1 et parmiles ports HTTP des serveurs TM1.

HTTPSessionTimeoutMinutesDéfinit la valeur du délai d'attente des sessions d'authentification pour l'API RESTd'IBM Cognos TM1.


Lorsque vous utilisez l'API REST de TM1, votre application doit s'authentifierauprès du serveur TM1. Ce paramètre définit le délai, en minutes, de ce moded'authentification. Lorsqu'une session expire, les demandes faites avec l'ancien IDde session renvoient 401 Unauthorized.


IdleConnectionTimeOutSecondsSpécifie un délai maximum en secondes, par exemple pour les connexions declient inactives.


Par exemple, si vous ajoutez la ligne suivante dans Tm1s.cfg, le serveur ferme lesconnexions de client inactives au bout de 900 secondes.IdleConnectionTimeOutSeconds=900

IndexStoreDirectoryDésigne un dossier pour stocker les fichiers index et notamment les fichiers designets.


Par défaut, ce paramètre n'est pas défini et les fichiers de signets (*.bm)apparaissent dans le même dossier que le fichier principal correspondant.

IntegratedSecurityModeCe paramètre définit le mode d'authentification des utilisateurs qui sera utilisé parle serveur IBM Cognos TM1.


Bien que le nom du paramètre fasse référence au mode de sécurité intégrée, lesparamètres 2, 3 et 4 permettent de définir d'autres types de sécurité.

Remarque : Si vous modifiez le mode de sécurité sans redémarrer le serveur IBMCognos TM1, la modification ne s'applique qu'aux nouvelles connexions client. Sivous souhaitez vous assurer que tous les clients soient authentifiés avec le nouveaumode de sécurité, ils doivent être déconnectés par l'administrateur.

Respectez le format suivant pour définir ce paramètre :

IntegratedSecurityMode=x


où x peut être la valeur d'un ou plusieurs des modes de sécurité ci-après.

Cognos Analytics 11 est pris en charge.

Mode de sécurité Description

1 Le serveur utilise le mode sécurisé (sécurité Cognos TM1 standard).

Avec ce mode d'authentification, le serveur Cognos TM1 vérifie lenom d'utilisateur et le mot de passe en les comparant aux nomsd'utilisateur et aux mots de passe qui se trouvent dans la base dedonnées Cognos TM1.

2 Ce mode vous permet de basculer du mode de connexion intégréeau mode de sécurité native Cognos TM1 et vice versa.

3 Le serveur utilise la connexion intégrée.

La connexion intégrée utilise l'authentification de réseau MicrosoftWindows pour contrôler l'accès aux données Cognos TM1.

Si vous choisissez ce mode de sécurité, définissez également leparamètre «SecurityPackageName», à la page 363.

Pour plus de d'informations, voir «Connexion intégrée», à la page239.

4 Le serveur utilise l'authentification de sécurité IBM Cognos Analytics.

Eléments à prendre en compte lors de l'utilisation de ce mode :

Dans Cognos TM1, les utilisateurs Cognos Analytics ne peuventappartenir qu'aux groupes Cognos Analytics et à l'un des troisgroupes d'administrateurs Cognos TM1 internes (ADMIN,DataAdmin et SecurityAdmin). L'appartenance aux groupesd'utilisateurs (non administrateurs) de Cognos TM1 n'est pas prise encharge pour les utilisateurs Cognos Analytics lorsqu'ils se connectentà Cognos TM1.

Vous ne pouvez pas utiliser Cognos TM1 pour affecter un utilisateurCognos Analytics à un autre groupe Cognos Analytics de manièrepermanente. Les affectations d'utilisateurs à un groupe CognosAnalytics, que vous effectuez dans Cognos TM1, ne sont pasenregistrées dans Cognos Analytics. Lorsqu'un utilisateur CognosAnalytics se connecte à Cognos TM1, les affectations de groupe deCognos Analytics remplacent les affectations aux groupes CognosAnalytics effectuées dans Cognos TM1.


Mode de sécurité Description

5 Le serveur utilise l'authentification de sécurité IBM Cognos Analyticset prend en charge les groupes d'utilisateurs de Cognos TM1 etCognos Analytics.

Utilisez le mode de sécurité 5 lorsque vous exécutez IBM CognosTM1 Applications avec la sécurité IBM Cognos Analytics.

Eléments à prendre en compte lors de l'utilisation de ce mode :

v Dans Cognos TM1, les utiliateurs Cognos Analytics peuventappartenir à la fois aux groupes Cognos Analytics et aux groupesCognos TM1.

v Vous ne pouvez pas utiliser Cognos TM1 pour affecter unutilisateur Cognos Analytics à un autre groupe Cognos Analyticsde manière permanente. Les affectations d'utilisateurs à un groupeCognos Analytics, que vous effectuez dans Cognos TM1, ne sontpas enregistrées dans Cognos Analytics. Lorsqu'un utilisateurCognos Analytics se connecte à Cognos TM1 , les affectations degroupe de Cognos Analytics remplacent les affectations auxgroupes Cognos Analytics effectuées dans Cognos TM1.

v Si le paramètre IntegratedSecurityMode=5 est utilisé pour IBMCognos TM1 Server et IBM Cognos TM1 Applications, il estimpossible d'affecter des droits aux groupes TM1 natifs dans laboîte de dialogue Gérer les droits. Seuls les groupes Cognosimportés dans le serveur TM1 sont disponibles.

IPAddressV4Ce paramètre permet de spécifier l'adresse IPv4 d'un serveur IBM Cognos TM1.


Un serveur peut inclure une adresse IP interne pour les clients protégés par unpare-feu et une adresse IP externe différente pour ceux qui se trouvent à l'extérieurdu pare-feu. Par défaut, toutes les demandes de client TM1 sont acheminées vial'adaptateur externe (public), ce qui nécessite une mise à jour des profils depare-feu. Si vous affectez l'adresse IP interne au paramètre IPAddressV4, le traficest acheminé via l'adaptateur privé et les profils de pare-feu ne requièrent pas demises à jour.

Par exemple :IPAddressV4="10.109.241.121"

Remarque : Ce paramètre remplace les anciens paramètres IPAddress, qui sontdésormais obsolètes.

IPAddressV6Ce paramètre permet de spécifier l'adresse IPv6 d'un serveur IBM Cognos TM1.


Un serveur peut inclure une adresse IP interne pour les clients protégés par unpare-feu et une adresse IP externe différente pour ceux qui se trouvent à l'extérieurdu pare-feu. Par défaut, toutes les demandes de client TM1 sont acheminées via


l'adaptateur externe (public), ce qui nécessite une mise à jour des profils depare-feu. Si vous affectez l'adresse IP interne au paramètre IPAddressV6, le traficest acheminé via l'adaptateur privé et les profils de pare-feu ne requièrent pas demises à jour.

Par exemple :IPAddressV6="0ff1:aa00:4125:2:a05:f7b1:61c2:a341"

Remarque : Ce paramètre remplace les anciens paramètres IPAddress, qui sontdésormais obsolètes.

IPVersionCe paramètre indique le protocole Internet utilisé par le serveur IBM Cognos TM1pour identifier les adresses IP sur le réseau.

Par exemple, pour indiquer que votre réseau utilise le protocole IPV6, ajoutez leparamètre IPVersion=ipv6 au fichier tm1s.cfg.


Les valeurs acceptables sont :v ipv4

Valeur par défaut. Utilisé pour les réseaux IPv4.v dual

Utilisé comme transition entre IPv4 et IPv6. Les deux protocoles sont pris encharge.

v ipv6

Utilisé pour les réseaux IPv6.

Remarques sur la configuration

Si vous définissez ce paramètre sur ipv6 ou dual, utilisez l'outil CognosConfiguration pour appliquer la modification à l'option TM1 Admin Server IPsupport.

Pour permettre aux clients d'identifier ce changement, ajoutez au systèmed'exploitation la variable d'environnement TM1_IPVersion avec la valeur ipv6 oudual, ou modifiez-la.

L'affectation de la valeur dual ou IPV6 à ce paramètre sans avoir le réseaucorrespondant peut engendrer une dégradation des performances.

Remarque : Dans certains cas, selon l'environnement réseau et la configuration duDNS, vous devrez peut-être également ajouter l'adresse IPv6 au fichier du systèmed'exploitation /etc/hosts sous UNIX et Microsoft Windows pour que Cognos TM1Admin Server et Cognos TM1 Server puissent être exécutés en mode IPv6.

Pour des explications détaillées sur la configuration de l'utilisation d'IPv6 par tousles composants Cognos TM1, voir «Configuration de Cognos TM1 en vue del'utilisation d'IPv6», à la page 93.


JavaClassPathUtilisez ce paramètre pour mettre les bibliothèques tierces Java à la dispositiond'IBM Cognos TM1 Server.


Par exemple, pour autoriser une extension Java à utiliser les classes contenues dansun fichier appelé db2cc4.jar (un pilote JDBC DB2), utilisez ce qui suit :JavaClassPath=C:\Development\Java\DB2JDBC\db2jcc4.jar

Vous pouvez spécifier plusieurs références en les séparant par un point-virgule.

JavaJVMArgsSpécifie la liste des arguments à transmettre à la machine virtuelle Java. Séparez-lespar un espace et un trait d'union. Exemple : JavaJVMArgs=-argument1=xxx-argument2=yyy.


Si vous voulez déboguer un processus, vous pouvez spécifier les argumentssuivants :JavaJVMArgs=-Xrunjdwp:transport=dt_socket -server=y -suspend=n -address=1044

Les arguments que vous utilisez dépendent de la machine virtuelle Java spécifiqueque vous utilisez.

JavaJVMPathCe paramètre définit le chemin du fichier .dll de la machine virtuelle Java (jvm.dll),qui est requis pour l'exécution de Java à partir d'IBM Cognos TM1 TurboIntegrator.


Par défaut, ce paramètre n'est pas présent dans le fichier tm1s.cfg.

Pour activer l'intégration de Java avec TurboIntegrator, ajoutez la ligne suivante aufichier tm1s.cfg :

JavaJVMPath=<full_path_to_jvm.dll>

Remarque : Si vous utilisez une version 64 bits de tm1s.exe, vous devez utiliser laversion 64 bits de jvm.dll. La version 32 bits de tm1s.exe nécessite la version 32bits de jvm.dll.

JobQueuingActive la mise en file d'attente lors des soumissions réalisées à partir d'un espacede travail personnel ou d'un bac à sable.


Définissez le paramètre JobQueuing=T pour traiter toutes les soumissions réalisées àpartir d'un bac à sable via la file d'attente des travaux. Quand ce paramètre a lavaleur F ou est absent du fichier de configuration, les soumissions réalisées à partirdes bacs à sable ne transitent pas par une file d'attente.


Quand ce paramètre est activé, l'icône de soumission s'affiche dans la barred'outils.

Pour plus de détails, voir la description de la mise en file d'attente des travauxdans la section relative au bac à sable et à l'écriture différée, dans le document IBMCognos TM1 Perspectives, TM1 Architect, and TM1 Web.

JobQueueMaxWaitTimeLorsque l'unité d'exécution de la file d'attente est exécutée, elle bloque toutes lesdemandes entrantes afin d'obtenir les verrous nécessaires pour traiter un travail dela file. De nouvelles demandes sont bloquées pendant une période définie dans leparamètre JobQueueMaxWaitTime.


Si les demandes en cours d'exécution ne sont pas terminées une fois ce délaiécoulé, l'unité d'exécution de la file d'attente redevient inactive pendantJobQueueThreadSleepTime, et les demandes entrantes sont traitées.

Pour attribuer à l'unité d'exécution de la file d'attente une priorité plus élevée,augmentez la valeur du paramètre JobQueueMaxWaitTime.

Si le paramètre JobQueueMaxWaitTime a pour valeur zéro dans le fichier deconfiguration et que la mise en file d'attente est activée, la file bloque toute autreactivité jusqu'à ce que tous ses travaux soient exécutés.

Pour plus de détails, voir la section Mise en file d'attente des travaux du documentIBM Cognos TM1 Perspectives, TM1 Architect, and TM1 Web.

Valeur par défaut : 100 ms

JobQueueThreadPoolSizeLe paramètre JobQueueThreadPoolSize permet à IBM Cognos TM1 d'utiliserplusieurs unités d'exécution pour traiter la file d'attente des travaux Cognos TM1,ce qui améliore la capacité de traitement des demande de bac à sable.


Par défaut, si ce paramètre n'est pas défini, Cognos TM1 utilise la valeur 1 et leserveur Cognos TM1 n'utilise qu'une seule unité d'exécution pour le traitement desdemandes de la file d'attente des travaux.

Configurez ce paramètre dans le fichier tm1s.cfg en utilisant le format suivant :JobQueueThreadPoolSize=x

où x représente le nombre d'unités à utiliser pour le traitement des demandes de lafile d'attente des travaux de Cognos TM1.

Par exemple :JobQueueThreadPoolSize=3



JobQueueThreadSleepTimeDétermine la fréquence à laquelle s'exécute l'unité d'exécution traitant la filed'attente lorsqu'il existe des travaux en file d'attente.


Valeur par défaut : 10 secondes

keyfileDéfinit le chemin du fichier de la base de données de clés. Le fichier de base dedonnées de clés contient le certificat serveur et les autorités de certification deconfiance. Le certificat serveur est utilisé par le serveur TM1 et le serveur TM1Admin.


Le fichier de la base de données de clés fourni avec TM1 est[emplacement_installation]/ssl/ibmtm1.kdb

Pour spécifier un autre fichier de base de données de clés, ajoutez le paramètrekeyfile au fichier tm1s.cfg et spécifiez le chemin d'accès absolu ou relatif du fichier.kdb.

Par exemple :keyfile=./ssl/filename.kdb

keylabelIndique le libellé du certificat serveur dans le fichier de base de données de clés.


Par exemple :keylabel=TM1_Certificate

keystashfileDéfinit le chemin du fichier de mot de passe de la base de données de clés. Lefichier de mot de passe de la base de données de clés correspond au magasin declés qui contient le mot de passe du fichier de la base de données de clés.


Le fichier de mot de passe de la base de données de clés fourni avec[installation_location]/ssl/ibmtm1.sth

Pour spécifier un autre fichier de mot de passe de base de données de clés, ajoutezle paramètre keystashfile au fichier tm1s.cfg et spécifiez le chemin d'accès absoluou relatif du fichier .sth.

Par exemple :keystashfile=./ssl/filename.sth


LanguageDéfinit la langue utilisée par le serveur IBM Cognos TM1. Ce paramètre s'appliqueaux messages générés par le serveur. Il est également utilisé dans l'interfaceutilisateur de la boîte de dialogue du serveur lorsque vous exécutez le serveur entant qu'application et non en tant que service Windows.


Les valeurs acceptables actuellement sont :

Language Code


Croate hrv

Tchèque csy



Danois dan

Néerlandais nld

Allemand deu

Finnois fin

Français fra

Hongrois hun

Italien ita

Japonais jpn

Kazakh kaz

Coréen kor

Norvégien nor

Polonais pol

Roumain rom

Russe rus

Espagnol esp

Slovène vli

Suédois sve

Thaï tha

Turc trk

LDAPHostDéfinit le nom de domaine ou la représentation sous forme de chaîne en pointilléde l'adresse IP de l'hôte de serveur LDAP.


Si vous n'entrez pas de valeur pour LDAPHost, IBM Cognos TM1 utilise la valeurpar défaut, localhost.


LDAPPasswordFileDéfinit le fichier de mot de passe utilisé si LDAPUseServerAccount n'est pasemployé. Il s'agit du chemin d'accès complet au fichier .dat, qui contient le mot depasse chiffré pour la clé privée du serveur Admin d'IBM Cognos TM1.


Ce paramètre utilise le chemin d'accès complet à un fichier .dat.

LDAPPasswordKeyFileDéfinit la clé de mot de passe utilisée si LDAPUseServerAccount n'est pasemployé.


Ce paramètre utilise le chemin d'accès complet au fichier .dat qui contient la cléutilisée pour chiffrer et déchiffrer le mot de passe pour la clé privée.

Ce fichier doit être généré à l'aide de l'utilitaire tm1crypt, comme décrit dans«Exécution de l'utilitaire TM1Crypt», à la page 290.

LDAPPortPort utilisé par IBM Cognos TM1 pour la liaison à un serveur LDAP.


Entrez un port sécurisé (SSL), par exemple, 636.

Valeur par défaut : 389 (port non sécurisé)

LDAPSearchBaseSpécifie le noeud d'arborescence LDAP où IBM Cognos TM1 commence àrechercher des utilisateurs valides.


Un nom distinct (DN) de base dans le répertoire LDAP. Par exemple :ou=people,o=company.com

Par exemple, si les noms distincts (DN) ont la forme :uid-bjensen, ou-people, o=company.com

la base de recherche est :ou-people, o=company.com

LDAPSearchFieldLe nom de l'attribut LDAP qui doit contenir le nom de l'utilisateur IBM CognosTM1 à valider.



Si vous n'entrez pas une valeur LDAPSearchField, la valeur par défaut est cn, quiest également la valeur par défaut pour Microsoft Active Directory.

LDAPSkipSSLCertVerificationOmet l'étape de vérification de la relation de confiance pour le certificat SSL utilisépour s'authentifier auprès d'un serveur LDAP. Ce paramètre n'est applicable que siLDAPVerifyServerSSLCert=T.


Si la vérification de la relation de confiance ne fonctionne pas, vous pouvezomettre cette étape en définissant LDAPSkipSSLCertVerification=T. Dans ce cas,TM1 ne vérifie pas du tout le certificat du serveur, mais se contente de l'accepter.



LDAPSkipSSLCRLVerificationOmet la vérification de la liste de révocation de certificats pour le certificat SSLutilisé pour s'authentifier auprès d'un serveur LDAP. Ce paramètre n'est applicableque si LDAPVerifyServerSSLCert=T.


Ce paramètre n'est pas nécessaire si LDAPVerifyServerSSLCert=F. L'API MicrosoftWindows peut tolérer une liste de révocation de certificats vide ou inexistence.



LDAPUseServerAccountDétermine si la connexion au serveur requiert un mot de passe si l'authentificationLDAP est utilisée.

Type de paramètre : facultatif, statiquev Pour une connexion directe au serveur LDAP à l'aide de l'authentification

intégrée, réglez ce paramètre sur T. Définissez ce paramètre sur T chaque foisque le serveur IBM Cognos TM1 et le serveur LDAP appartiennent au mêmedomaine.

v Pour utiliser un mot de passe avant la connexion, réglez ce paramètre sur F. Si leparamètre LDAPUseServerAccount est défini à F, vous devez également définirle «LDAPPasswordFile», à la page 252 et le «LDAPPasswordKeyFile», à la page252 pour permettre la connexion au serveur LDAP via SSL.

LDAPVerifyCertServerNameContient un serveur à utiliser lors du processus de validation du certificat SSLpour l'authentification du serveur LDAP. Ce paramètre n'est applicable que siLDAPVerifyServerSSLCert=T.




Utilisez ce paramètre pour définir les serveurs TM1 à utiliser pour la validation ducertificat SSL reçu.

Chaque nom de serveur à utiliser pour la validation des certificats doit figurerdans une entrée LDAPVerifyCertServerName distincte. Les entrées doiventcorrespondre exactement au nom (sujet) du certificat présenté à TM1 par le serveursitué à l'autre extrémité lors de l'établissement de la liaison SSL.

Définissez LDAPVerifyCertServerName dans le fichier tm1s.cfg de chaque serveurTM1 qui utilise LDAP.LDAPVerifyCertServerName=<server_cert_subject>

Remplacez server_cert_subject par un nom de serveur ou une adresse IP. Créezune entrée pour chaque serveur à utiliser. Par exemple :LDAPVerifyCertServerName=abc99.mydomain.comLDAPVerifyCertServerName=xyz99.mydomain.com


LDAPVerifyServerSSLCertDélègue la vérification du certificat SSL à TM1. Ce paramètre est utile, parexemple, lorsque vous utilisez LDAP avec un serveur proxy.



Généralement, TM1 utilise l'API Microsoft Windows pour vérifier les certificatsSSL. Pour que ce processus aboutisse, le nom du certificat et le nom d'hôte duserveur LDAP nom doivent correspondre. Cependant, si vous utilisez un proxy, cesnoms peuvent être différents et la vérification échoue. Dans ce cas, vous pouvezdéfinir LDAPVerifyServerSSLCert=T pour que TM1 effectue la vérification ducertificat.

Lorsque LDAPVerifyServerSSLCert=T, TM1 exécute les deux étapes de lavérification (vérification de la relation de confiance avec le certificat et vérificationde la liste de révocation de certificats) comme l'aurait fait l'API Windows, maisavec une méthode légèrement différente.1. Au lieu de vérifier le certificat reçu par rapport au nom d'hôte configuré, TM1

examine la liste des noms de serveur définie dans LDAPVerifyCertServerName.2. Si le nom du certificat correspond à l'un des serveurs de

LDAPVerifyCertServerName, TM1 appelle l'API Microsoft Windows et luidemande de vérifier uniquement ce certificat.

Remarque : L'autorité de certificat racine de confiance doit au préalable avoirété importée dans le magasin de certificats de Microsoft Windows.

Vous pouvez omettre l'étape de vérification de la relation de confiance endéfinissant LDAPSkipSSLCertVerification=T. Dans ce cas, TM1 ne vérifie pas dutout le certificat du serveur, mais se contente de l'accepter.

3. Une fois la vérification de la relation de confiance vérifiée (ou omise), TM1appelle l'API Microsoft Windows pour vérifier la liste de révocation decertificats.


Remarque : La liste de révocation de certificats de la racine de confiance doitau préalable avoir été importée dans le magasin de certificats de MicrosoftWindows.

Si la liste de révocation de certificats n'existe pas dans le magasin de certificatsde Microsoft Windows, le processus échoue. Vous pouvez omettre lavérification de la liste de révocation de certificats en définissantLDAPSkipSSLCRLVerification=T.

4. Si toutes les étapes précédentes se sont terminées avec succès, l'établissementde liaison SSL est terminé. TM1 tente maintenant de s'authentifier auprès duserveur LDAP.

Pour obtenir des informations relatives au traitement des incidents, voir«Traitement des incidents liés à l'authentification LDAP», à la page 257.

LDAPWellKnownUserNameNon d'utilisateur utilisé par le serveur IBM Cognos TM1 pour se connecter àLDAP et rechercher le nom soumis par l'utilisateur.


La valeur de ce paramètre peut être n'importe quel nom distinctif LDAP.

Par exemple :uid=bjensen,ou=people,o=company.com

LoadPrivateSubsetsOnStartupCe paramètre de configuration détermine si des sous-ensembles privés sontchargés lorsque le serveur TM1 est démarré.


Des conflits de verrouillage peuvent se produire si des sous-ensembles privés sontchargés à la demande (lorsqu'un utilisateur demande le sous-ensemble). Vouspouvez éviter les conflits de verrouillage en chargeant tous les sous-ensemblesprivés de tous les utilisateurs en mémoire au démarrage du serveur, en ajoutantLoadPrivateSubsetsOnStartup=T

au fichier Tm1s.cfg de votre serveur.

Si LoadPrivateSubsetsOnStartup=F ou qu'il n'est pas présent dans Tm1s.cfg, lessous-ensembles privés sont chargés à la demande.

LockPagesInMemoryLorsque ce paramètre est activé, Windows réduit les pages de l'espace detraitement de IBM Cognos TM1, mais ne les pagine pas sur le disque.


Lorsqu'un serveur Cognos TM1 fonctionnant sous Windows 64 bits reste en veillependant une longue période, la mémoire physique qu'il utilise est paginée sur ledisque. Il s'agit d'une fonction du système d'exploitation Windows 64 bits et non


de Cognos TM1. Cela peut provoquer une baisse des performances sur les bases dedonnées Cognos TM1 volumineuses, lorsque le système tente d'accéder auxdonnées après une période d'inactivité.

Pour optimiser les performances lors de l'utilisation d'une base de données CognosTM1 volumineuse sur la version 64 bits de Windows, définissez le paramètreLockPagesInMemory=T dans le fichier Tm1s.cfg.

Lorsque ce paramètre est activé, Windows continue à réduire les pages de l'espacede traitement de Cognos TM1, mais ne les pagine pas sur le disque. Lesperformances du serveur Cognos TM1 s'en trouvent accrues, dans la mesure où lesobjets ne sont plus placés dans la mémoire virtuelle mais restent dans la RAMphysique.

LoggingDirectorySpécifie le répertoire dans lequel le serveur enregistre ses fichiers journaux.

Si vous ne fournissez pas ce paramètre, les fichiers journaux sont enregistrés dansle premier répertoire de données spécifié par le paramètre DataBaseDirectory.


Remarque : La valeur du paramètre LoggingDirectory doit être placée entreguillemets si elle contient des espaces. Exemple : LoggingDirectory=C:/DataFiles/Logfiles. Le démarrage du serveur Cognos TM1 échouera si les guillemetssont omis dans ce cas de figure. Notez par ailleurs que d'autres paramètres, telsque DataBaseDirectory, n'exigent pas nécessairement l'insertion de guillemetslorsqu'une valeur contient des espaces.

LogReleaseLineCountDéfinit le nombre de lignes qu'une recherche portant sur le journal des transactionspeut accumuler pendant le verrouillage du journal, avant que celui-ci ne soittemporairement déverrouillé pour permettre à d'autres activités du journal destransactions de continuer.


Valeur par défaut : 5000 lignes

MagnitudeDifferenceToBeZeroDéfinit l'ordre d'ampleur du numérateur relatif au dénominateur, au-dessus duquelle dénominateur est égal à zéro lors de l'utilisation d'un opérateur de divisionsécurisé.


Dans les règles et dans TurboIntegrator, la barre oblique inversée est un opérateurde division sécurisé. Si vous essayez de diviser par zéro, le résultat sera zéro etnon pas une valeur non définie. Si le dénominateur de la division est une quantitécalculée, le résultat peut être très proche de zéro, par exemple, .0000000000000004.En définissant le paramètre MagnitudeDifferenceToBeZero, vous pouvez spécifier laproximité d'un nombre par rapport à zéro, en fonction de l'ampleur du numérateurdevant être considéré comme zéro pour l'opérateur de division sécurisée.


Examinez l'exemple suivant :v Dans le fichier Tm1s.cfg, définissez MagnitudeDifferenceToBeZero=14v L'opération est A \ B

Remarque : La barre oblique inversée (\) est l'opérateur de division sécuriséedans TurboIntegrator.

v A = 1000 B = 1.5e-15v B est 18 ordres de grandeur de moins que Av 18 > 14, donc l'opérateur de division sécurisée renvoie B=0

MaskUserNameInServerToolsIndique si les noms d'utilisateur dans les outils d'administration du serveur(Operations Console) sont masqués jusqu'à ce que l'utilisateur soit explicitementidentifié comme disposant de l'accès administrateur.


Lorsque MaskUserNameInServerTools a la valeur TRUE, les noms d'utilisateur sontmasqués dans les outils d'administration du serveur jusqu'à ce que l'utilisateur quiutilise l'outil soit explicitement identifié en tant qu'administrateur. Pour en savoirplus sur la manière de vérifier l'accès administrateur à Operations Console, voirIBM Cognos TM1 Operations Console.

Lorsque MaskUserNameInServerTools a la valeur FALSE, les noms d'utilisateur sontvisibles dans les outils d'administration du serveur par tous les utilisateurs, qu'ilssoient ou non administrateurs.


MaximumCubeLoadThreadsSpécifie si les phases de chargement de cube et de calcul d'alimenteur duchargement de serveur sont à unités d'exécutions multiples, de telle sorte queplusieurs cœurs de processeur puissent être utilisés en parallèle.

Ceci réduit la durée du chargement de serveur.


Pour fonctionner en mode unités d'exécution multiples, vous devez définirMaximumCubeLoadThreads en fonction du nombre de coeurs de processeur duserveur Cognos TM1 que vous voulez dédier au chargement de cubes et autraitement de feeders.

En général, vous obtenez des performances optimales lorsque le paramètre estdéfini sur une valeur égale à (nombre de coeurs de processeur disponibles) - 1. Parexemple, si le serveur Cognos TM1 s'exécute sur un ordinateur doté de quatrecoeurs de processeur, le paramètre MaximumCubeLoadThreads doit être défini sur3. Ainsi, un coeur de processeur est toujours disponible pour exécuter d'autresapplications pendant le chargement du serveur Cognos TM1.

Quand MaximumCubeLoadThreads est défini à 0, le chargement des cubes et letraitement des alimenteurs n'est PAS à unités d'exécutions multiples. Il s'agit ducomportement par défaut quand MaximumCubeLoadThreads n'est pas définiexplicitement dans le fichier Tm1s.cfg.


Remarque : Quand MaximumCubeLoadThreads est activé, Cognos TM1 ne peutpas gérer l'ordre dans lequel les feeders sont calculés. Dans certains cas, cetraitement différent affecte votre application en raison de dépendances d'ordred'évaluation dans l'environnement à unités d'exécutions multiples.

Si votre modèle Cognos TM1 utilise des feeders conditionnels dans lesquels laclause de condition contient une valeur provenant du feeder, définissezMaximumCubeLoadThreads=0 ou excluez le paramètre du fichier Tm1s.cfg pourdésactiver l'utilisation simultanée de plusieurs unités d'exécution lors duchargement.

MaximumLoginAttemptsDéfinit le nombre maximum d'échecs de tentative de connexion utilisateur permissur le serveur.

S'il n'est pas inclus dans Tm1s.cfg, MaximumLoginAttempts permet par défauttrois tentatives de connexion.


Par exemple, si vous ajoutez la ligne MaximumLoginAttempts=5 à Tm1s.cfg, leserveur impose une limite de 5 échecs pour la tentative de connexion. Sil'utilisateur n'arrive pas à se connecter au serveur Cognos TM1 au bout du nombrede tentatives spécifié, le serveur émet une erreur.

Une fois qu'un utilisateur a dépassé le nombre maximum d'échecs de tentative deconnexion, le serveur Cognos TM1 rejette toute tentative de connexion ultérieurepar cet utilisateur.

MaximumLoginAttempts est pris en compte pour chaque session de serveur. Si unutilisateur dépasse le nombre maximum de tentatives, il ne peut se connecter à lasession actuelle de serveur Cognos TM1, à moins que l'administrateur Cognos TM1change son mot de passe. Toutefois, une fois le serveur Cognos TM1 redémarré,l'utilisateur peut se connecter avec son mot de passe existant.

MaximumMemoryForSubsetUndoDéfinit la quantité maximum de mémoire, en kilo-octets, à dédier pour le stockagede pile Annuler/Rétablir pour l'éditeur de sous-ensembles.

Par exemple, l'ajout de la ligne MaximumMemoryForSubsetUndo=20480 au fichierde configuration instruit le serveur d'allouer 20480 kilo-octets (20 Mo) de mémoirepour la pile Annuler/Rétablir.


En général, des sous-ensembles plus grands exigent de plus grandes quantités demémoire pour stocker une pile Annuler/Rétablir utilisable. Si vous vous apercevezque le serveur Cognos TM1 ne stocke pas un nombre suffisant d'étapesAnnuler/Rétablir pour vos sous-ensembles, augmentez la valeur deMaximumMemoryForSubsetUndo.

Si ce paramètre n'est pas défini explicitement dans le fichier Tm1s.cfg, la quantitémaximum de mémoire dédiée à la fonctionnalité Annuler/Rétablir de l'éditeur desous-ensemble est de 10240 kilo-octets (10 Mo).


MTFeedersApplique les techniques de parallélisation des requêtes à unités d'exécutionsmultiples aux processus suivants : fonction TI CubeProcessFeeders(), mises à jourde règle de cube et construction de feeders au démarrage.


Par défaut, le paramètre est désactivé (F). Activer ce paramètre pour améliorer letraitement de feeders. Spécifiez MTFeeders=T pour obtenir les avantages suivants :v Optimisation des processus lors de l'utilisation de la fonction TI

CubeProcessFeeders( <nom_cube>).v Si une mise à jour de règle implique la mise à jour de cubes de feeder, le

processus est optimisé par une exécution en parallèle. Les règles sont mises àjour manuellement ou à l'aide de la fonction TI RuleLoadFromFile (Cube,TextFile).

v Si ce paramètre est utilisé avec MTFeeders.AtStartup=T, les feeders sontconstruits au démarrage. Il est également possible de charger les feeders audémarrage avec la fonction TI RuleLoadFromFile(Cube, TextFile).

MTFeeders.AtStartupSi l'option de configuration MTFeeders est activée, l'activation deMTFeeders.AtStartup applique la construction des feeders au démarrage duserveur.


Par défaut, le paramètre est désactivé (F).

Si cette option de configuration est activée, elle empêche les unités d'exécution dechargement (définies avec l'option MaximumCubeLoadThreads) de prendre en chargela construction de feeders en parallèle. Toutefois, MTFeeders.AtStartup ne désactivepas l'impact de MaximumCubeLoadThreads sur les autres phases du chargement demodèle.

Il est également possible de charger les feeders au démarrage avec la fonction TIRuleLoadFromFile(Cube, TextFile).

MTFeeders.AtomicWeightDéfinit le nombre d'opérations atomiques requises pour traiter les feeders d'uneseule cellule.


L'«opération atomique» représente l'unité utilisée dans l'option de configurationMTQ.OperationProgressCheckSkipLoopSize. En principe, MTFeeders.AtomicWeightfournit un heuristique relatif indiquant de combien une construction de feeder estplus lente par rapport à la visite d'une cellule lors d'une opération de lecture. Leratio MTQ.OperationProgressCheckSkipLoopSize/ MTFeeders.AtomicWeight renvoieune approximation du nombre de cellules déclenchant une exécution en parallèlelors du traitement des mises à jour de feeder.



MaximumSynchAttemptsDéfinit le nombre maximum de fois où un processus de synchronisation d'unserveur Planet tentera de se reconnecter à un réseau avant l'échec du processus.


Vous pouvez utiliser le paramètre MaximumSynchAttempts pour optimiser lesperformances d'un processus de synchronisation qui s'exécute sur une connexionréseau instable (WAN longue distance, par exemple) avec une forte latence, unefaible bande passante et une qualité de transmission médiocre.

Pour préciser le nombre maximum de tentatives de connexion à un réseau d'unprocessus de synchronisation, ajoutez la ligne suivante au fichier Tm1s.cfg pour leserveur Planet :

MaximumSynchAttempts=n

où n représente le nombre de connexions au réseau qu'a tenté le processus desynchronisation avant l'échec du processus.

La valeur par défaut est de 1, ce qui signifie que le processus de synchronisationne tentera qu'une seule fois de se connecter. Il n'essaiera pas de se reconnecter s'iln'arrive pas à établir la connexion. Ce comportement par défaut reste identique àcelui des versions Cognos TM1 antérieures à 9.5.1, où un processus desynchronisation échouait en cas de perte de la connexion réseau.

Une valeur de 0 signifie un nombre illimité de tentatives de connexion au réseau.

Vous pouvez configurer ce paramètre pour qu'il fonctionne de pair avec leparamètre SyncUnitSize. Pour plus d'informations, voir «SyncUnitSize», à la page369.

L'exemple suivant montre comment utiliser le paramètre MaximumSynchAttemptsconjointement avec le paramètre SyncUnitSize :SyncUnitSize=2000

MaximumSynchAttempts=100

MaximumTILockObjectsParamètre de configuration du serveur qui définit le nombre maximal d'objets deverrouillage d'un processus TurboIntegrator. Utilisez la fonction TurboIntegratorsynchronized().

Le serveur gère la liste des objets de verrouillage TurboIntegrator créés. Chaquefois que l'utilisateur appelle la fonction synchronized() sur un objet de verrouillage,le serveur commence par vérifier si l'objet de verrouillage est déjà dans la liste. S'iln'y est pas, le serveur crée un nouvel objet de verrouillage et l'insère dans la liste.

Pour plus d'informations, voir la rubrique «Sérialisation des processusTurboIntegrator à l'aide de synchronized()» dans le document IBM Cognos TM1TurboIntegrator.

Même après que tous les processus TurboIntegrator ayant référencé un objet deverrouillage sont terminés, l'objet de verrouillage n'est pas forcément retiré de laliste immédiatement pour libérer de la mémoire. En effet, il est possible que la


fonction synchronized() puisse être appelé ultérieurement sur le même objet deverrouillage par le même processus ou un autre.

Le paramètre de configuration du serveur MaximumTILockObjects, dans le fichiertm1s.cfg, contrôle la taille de la liste des objets de verrouillage créés parTurboIntegrator. Lorsque le nombre d'objets de verrouillage dans la liste à atteint lavaleur de MaximumTILockObjects, le serveur démarre une opération de nettoyage.Il retire de la liste les objets de verrouillage non utilisés par un processus en cours.

Si le paramètre MaximumTILockObjects n'est pas explicitement défini dans lefichier Tm1s.cfg, une valeur par défaut de 2000 est utilisée.


MaximumUserSandboxSizeDéfinit la quantité maximale de mémoire RAM (en Mo) à allouer à chaqueutilisateur pour les espaces de travail personnels ou les bacs à sable.

Si le paramètre MaximumUserSandboxSize n'est pas défini, la taille maximale pardéfaut est de 100 Mo sur les systèmes 32 bits et de 500 Mo sur les systèmes64 bits.


Pour spécifier une allocation de mémoire maximale aux espaces de travailpersonnels ou aux bacs à sable, ajoutez la ligne suivante dans le fichier Tm1s.cfg :

MaximumUserSandboxSize=n

où n représente le maximum de mémoire (en Mo) à allouer.

MaximumViewSizeDéfinit en kilo-octets le maximum de mémoire à allouer pour l'accès à une vue.

Si aucun paramètre MaximumViewSize n'est défini, la taille maximale par défautdes vues est de 100 Mo pour les systèmes 32 bits et de 500 Mo pour les systèmes64 bits.


Pour spécifier une allocation de mémoire maximale pour les vues, ajoutez la lignesuivante dans le fichier tm1s.cfg :MaximumViewSize=n

où n représente le maximum de mémoire (en Mo) à allouer.

Voir aussi «ApplyMaximumViewSizeToEntireTransaction», à la page 315.

MDXSelectCalculatedMemberInputsModifie la manière dont les membres calculés des expressions MDX sont géréslorsque la suppression des zéros est activée.



MDXSelectCalculatedMemberInputs corrige un problème lié aux membres calculésd'une expression MDX lorsque la suppression des zéros est activée. Lorsque lasuppression des zéros est activée sur un axe de requête, les membres calculéspeuvent être supprimés de la requête ou peuvent causer la désactivation de lasuppression des zéros.

Ce problème se produit car la suppression des zéros est basée sur les donnéesréelles du cube. Les membres calculés n'ont pas de membre réel dans le cube ; ilssont dérivés d'autres membres.

Par exemple, supposons qu'un cube ait un membre calculé, C, qui corresponde à lasomme des membres A et B.

C (A+B)A B

Les membres A et B sont des membres réels du cube, alors que C est un membredérivé. Lorsque vous exécutez une requête avec A, B et C dans les colonnes, {A,B,C}, vous voyez A, B et C dans les colonnes et vous voyez que C correspond à lasomme de A et B. Lorsque vous activez la suppression des zéros, seules les lignesnon null de A, B et C sont affichées, ce qui est normal.

A présent, supposons que vous limitiez les colonnes à C, {C}. Si la suppression deszéros est désactivée, C est affiché dans les colonnes. Mais si vous activez lasuppression des zéros, C peut disparaître des colonnes car il ne référence aucunmembre réel du cube.

MDXSelectCalculatedMemberInputs résout ce problème. LorsqueMDXSelectCalculatedMemberInputs est activé, TM1 considère que si les entréesd'un membre calculé contiennent des données (A et B dans l'exemple), le membrecalculé (C) en contient également et doit être conservé lorsque la suppression deszéros est activée.

Le traitement se déroule comme suit :1. Examinez rapidement le membre calculé pour détecter les membres réels qu'il

référence.2. Considérez ces membres réels comme des entrées du membre calculé.3. Vérifiez que ces entrées sont comprises dans les données Stargate sous-jacentes

de la vue.

Si les entrées sont comprises dans les données Stargate, l'algorithme desuppression voit les données sur A et B, remarque que A et B sont des membres enentrée de C, et conserve C lorsque la suppression des zéros est activée.

MDXSelectCalculatedMemberInputs fonctionne bien pour les formules simples,comme C=A+B. Si vous utilisez des formules plus complexes, telles que desformules dépendantes des données qui contiennent une expression conditionnellecomme IIF, l'activation de MDXSelectCalculatedMemberInputs ne résout pasforcément les problèmes liés à la suppression des zéros.

Remarque : L'activation de MDXSelectCalculatedMemberInputs peut augmenter lataille des vues Stargate. Cela peut accélérer l'accès au données des cubes, maiségalement consommer plus de ressources système.

Pour activer MDXSelectCalculatedMemberInputs, ajoutez la ligne suivante aufichier tm1s.cfg.


MDXSelectCalculatedMemberInputs=True

Pour désactiver MDXSelectCalculatedMemberInputs, ajoutez la ligne suivante aufichier tm1s.cfg :MDXSelectCalculatedMemberInputs=False

Valeur par défaut : True

Il est recommandé de définir une valeur supérieure à la valeur de 500 Mo pourMaximumViewSize.

MessageCompressionActive la compression des messages de grande taille, ce qui réduitconsidérablement le trafic réseau.

Par défaut, ce paramètre est activé.


Pour désactiver la compression des messages, ajoutez la ligne suivante dans lefichier Tm1s.cfg :MessageCompression=F

MTCubeLoadActive le chargement à unités d'exécutions multiples de cubes individuels.


Valeur par défaut : F (désactivé)

MTCubeLoad utilise l'infrastructure à unités d'exécutions multiples de MTQ pouraugmenter les vitesses par rapport à l'approche précédente qui utilisaitMaximumCubeLoadThreads. Les paramètres de configuration MTCubeLoad.MinFileSize,MTCubeLoad.Weight, MTCubeLoad.UseBookmarkFiles et IndexStoreDirectory sontutilisés pour optimiser les performances.

MTCubeLoad éliminé également le risque de changer l'ordre de génération desfeeders. Si MTCubeLoad est activé, l'option de configuration MaximumCubeLoadThreadsest ignorée. Le paramètre MTCubeLoad exploitant l'infrastructure MTQ, il s'appuietoujours sur la configuration MTQ pour définir le nombre d'unités d'exécutionsimultanées.

Les administrateurs de serveur TM1 peuvent utiliser les paramètresPreallocatedMemory.Size, PreallocatedMemory.ThreadNumber etPreallocatedMemory.BeforeLoad pour configurer la préallocation de mémoire etoptimiser les résultats des mises à l'échelle et des performances. L'allocation demémoire à un serveur TM1 peut permettre d'éviter les conflits liés à une allocationde mémoire variable par le système d'exploitation. Pour de meilleurs résultats,tenez compte de la quantité de mémoire vive consommée par le serveur TM1 pourconfigurer les paramètres de préallocation de mémoire.

L'exemple de fichier tm1s.cfg suivant illustre la configuration du chargement decubes à unités d'exécutions multiples :


MTCubeLoad=TMTQ=AllMTCubeLoad.UseBookmarkFiles=TIndexStoreDirectory=c:\Cubes\CubeFolder\indexStore

# 30GB of RAM to preallocatePreallocatedMemory.Size=30000# Run preallocation in parallel to cube cell/feeder loadingPreallocatedMemory.BeforeLoad=F# Window 2008/2012 patches as of Dec 2016 worked most efficientlywith a single threadPreallocatedMemory.ThreadNumber=1

# Disable TM1 performance counters to speed up MTQ.PerfMonIsActive=F

MTCubeLoad.MinFileSizeDéfinit la taille minimale des fichiers de cube à charger sur plusieurs unitésd'exécution.


La valeur doit être spécifiée en ko (kilooctets). Si la valeur «0» est spécifiée,MTCubeLoad est appliqué aux fichiers de toute taille.

Valeur par défaut : 10 ko

MTCubeLoad.UseBookmarkFilesActive la conservation des signets sur le disque.


Les signets stockent des informations qui permettent au processus de chargementdes cubes de commencer à lire les cellules/feeders à partir du milieu des fichiers.cub et .feeder. Les signets peuvent être lus à partir des fichiers où ils sontconservés. Si un fichier de signets n'est pas présent ou qu'il n'est pas synchroniséavec le fichier principal auquel il correspond, les signets sont générés à la volée enparallèle pour le reste de la logique de chargement des cubes. Les fichiers designets sont stockés dans le dossier spécifié par l'option de configurationIndexStoreDirectory. Par exemple :<IndexStoreDirectory>\<path-to-main-file-relative-to-data-folder>\<main-filename>.bm

Les fichiers de signets incorporent l'horodatage de leur fichier principalcorrespondant. Si cet horodatage ne correspond pas à l'horodatage réel du fichierprincipal, les fichiers de signets sont ignorés et les signets sont régénérés à la volée.En cas de doute sur la synchronisation des signets, le contenu du dossier designets doit être nettoyé. Ce contenu est régénéré après le redémarrage du serveur.Les fichiers de signets sont également mis à jour lors des appels SaveDataAll etCubeSaveData lorsque les fichiers principaux auxquels les signets sont associéssont mis à jour.


MTCubeLoad.WeightDéfinit le nombre d'opérations atomiques requises pour charger une seule cellule.



L'«opération atomique» représente l'unité utilisée dans l'option de configurationMTQ.OperationProgressCheckSkipLoopSize. MTCubeLoad.Weight fournit unheuristique relatif indiquant de combien le chargement d'une cellule est plus lentpar rapport à la visite d'une cellule lors d'une opération de lecture.


MTQDéfinit le nombre maximal d'unités d'exécution par connexion à un utilisateurunique, si l'optimisation à unités d'exécutions multiples est appliquée. Utilisé lorsdu traitement des requêtes, ainsi que dans les opérations de chargement de cube etde feeder par lots.


Pour spécifier le nombre maximal d'unités d'exécution pour l'optimisation à unitésd'exécutions multiples, ajoutez la ligne suivante au fichier Tm1s.cfg :MTQ=n

où n est le nombre maximal d'unités d'exécution utilisables par opération.

Par défaut, MTQ=All (insensible à la casse), ce qui définit la valeur sur le nombremaximal de coeurs disponibles sur un serveur. Il en résulte un paramètre systèmedynamique qui utilise tous les coeurs.

Si vous définissez MTQ sur un nombre négatif, (MTQ=-N), le nombre d'unitésd'exécution qui seront utilisées est défini par l'équation suivante : T=M-N+1, où Test le nombre d'unités d'exécution à utiliser par le système et M est le nombred'unités d'exécution sur le serveur.

Ainsi, si votre serveur a 64 coeurs et si vous définissez MTQ=-10, le systèmeutilisera 55 coeurs.T=64-(10)+1

Si vous définissez MTQ=1 ou MTQ=0, l'optimisation à unités d'exécutions multiples estdésactivée.

Pour plus d'informations, reportez-vous à la rubrique "Amélioration desperformances de traitement grâce aux requêtes à unités d'exécutions multiples"dans le document IBM Cognos TM1 Operations.

Valeur par défaut : All

Remarque : Les optimisations à unités d'exécutions multiples peuvent améliorerles performances des cubes numériques, dans lesquels la consolidation estoptimisée. TM1 ne consolidant pas les valeurs de chaîne, le paramètre MTQ n'apas d'incidence sur les performances des cubes de chaîne.

MTQ.CTreeRedundancyReducerUtilisez ce paramètre pour optimiser le traitement des requêtes à unitésd'exécutions multiples.



Si ce paramètre est défini sur True, il réduit la probabilité de recalculer les mêmescellules gérées par des règles dans les unités d'exécution de tâche MTQ.


MTQ.OperationProgressCheckSkipLoopSizeUtilisez ce paramètre pour optimiser le traitement des requêtes à unitésd'exécutions multiples.


Ce paramètre indique le nombre de cellules à traiter avant de vérifier si ellesdoivent être réparties entre plusieurs unités d'exécution.

Valeur par défaut : 10 000.

MTQ.SingleCellConsolidationUtilisez ce paramètre pour optimiser le traitement des requêtes à unitésd'exécutions multiples.


Définissez ce paramètre sur FALSE pour rejeter le traitement des requêtes à unitésd'exécutions multiples pour les consolidations à cellule unique. Cela s'applique, parexemple, si votre modèle contient des règles complexes (des règles qui ont desréférences croisées avec une profondeur récursive supérieure à deux).

La consolidation à cellule unique est souvent appelée pour le calcul des règles quifont référence à des valeurs consolidées en tant qu'arguments. La consolidation àcellule unique est également utilisée pour traiter les vues contenant seulement destitres.

La valeur par défaut est TRUE.

NetRecvBlockingWaitLimitSecondsUtilisez ce paramètre pour que le serveur convertisse la durée d'attente desdemandes client en une série de durées plus courtes. Ce paramètre remplace ladurée d'attente d'une longue période par des durées plus courtes, pour permettrel'annulation d'une unité d'exécution, si nécessaire.


Par défaut, ce paramètre est activé.

Par défaut, le serveur peut attendre longtemps l'entrée d'un client, ce qui peutgénérer notamment des blocages d'unités d'exécution.

Ce paramètre indique à Cognos TM1 Server d'effectuer l'attente sous la formed'une série d'attentes courtes répétées, et lui donne la possibilité d'annuler ou demettre en pause l'unité d'exécution. La valeur par défaut (zéro) correspond àl'ancien comportement constitué par une seule attente longue.



NetRecvMaxClientIOWaitWithinAPIsSecondsDurée maximale des opérations d'entrée-sortie effectuées par un client dansl'intervalle comprenant l'arrivée du premier paquet de données pour un ensembled'API, le traitement et l'envoi d'une réponse.


Ce paramètre nécessite un traitement relativement rapide des entrées-sorties par leclient après le lancement des requêtes d'API. Ce paramètre constitue une protectioncontre les connexions inactives qui ne produisent pas d'erreur d'interface réseau nid'autres symptômes (par exemple un blocage du client).

La valeur par défaut est 0, c'est-à-dire aucune limite de temps.

NIST_SP800_131A_MODEIndique que le serveur doit fonctionner en conformité avec la norme dechiffrement SP800-131A.


Si le chiffrement SP800-131 est appliqué, le certificat signé doit respecter la normetelle qu'elle est définie par la publication spéciale SP800-131 du National Instituteof Standards and Technology (NIST). Cette norme requiert une taille de cléminimale de 2048 bits et un algorithme de signature RSA minimum de SHA-224.

Pour désactiver la conformité à la norme SP800-131, ajoutez la ligne suivante aufichier tm1s.cfg :NIST_SP800_131A_MODE=False

Valeur par défaut : True

ODBCLibraryPathIndique le nom et l'emplacement de la bibliothèque de l'interface ODBC (fichier.so) sous UNIX.

Type de paramètre : facultatif (requis pour prendre en charge ODBC sous UNIX),statique

Ce paramètre s'applique uniquement à TM1 exécuté sous UNIX, Linux ou AIX.

Dans le fichier tm1s.cfg, ajoutez la ligne suivante :ODBCLibraryPath= location/file

Remplacez location/file par le chemin absolu et le nom du fichier de labibliothèque.

Par exemple :ODBCLibraryPath=/usr/local/lib/unixODBC/lib/libodbc.so

OracleErrorForceRowStatusUtilisez ce paramètre pour garantir une bonne interaction entre les processusTurboIntegrator d'IBM Cognos TM1 et les sources de données ODBC d'Oracle.



Le format du paramètre est le suivant :OracleErrorForceRowStatus=x

Remplacez x par l'une des valeurs suivantes :

0 Planning Analytics détecte automatiquement la version d'Oracle à laquellevous êtes connecté.

1 Planning Analytics gère la connexion à Oracle la même manière que pourles autres pilotes.

2 Planning Analytics se connecte à Oracle et utilise SQLULEN à la place deSQLUSMALLINT.


PasswordMinimumLengthSpécifie la longueur minimum de mot de passe des clients accédant au serveur.


Par exemple, définissez PasswordMinimumLength=8 pour imposer une longueur demot de passe de 8 caractères au minimum.

Remarque : Remarque : Ce paramètre ne concerne que les mots de passe définisou modifiés après l'activation du paramètre. Il n'a aucune incidence sur les anciensmots de passe inchangés composés d'un nombre de caractères inférieur à celuiimposé par PasswordMinimumLength.

PasswordSourceCompare le mot de passe entré par l'utilisateur à celui stocké dans la base dedonnées.


Cognos TM1 (valeur par défaut) : Compare le mot de passe entré par l'utilisateur àcelui stocké dans la base de données Cognos TM1.

LDAP : Compare le mot de passe entré par l'utilisateur à celui stocké sur leserveur LDAP.

PerfMonIsActiveUtilisez ce paramètre pour activer ou désactiver les mises à jour des compteurs deperformances de TM1.


Vous pouvez afficher les compteurs de performances à l'aide de l'utilitaire TM1PerfMon ou de l'Analyseur de performances de Microsoft Windows. Pour plus dedétails, voir "Utilisation des compteurs de performances TM1" dans le documentTM1 Operations.

La capture des compteurs de performances dans TM1 peut impacter lesperformances sous une charge de travail multi-utilisateur importante (avec au


moins 100 utilisateurs actifs). Utilisez ce paramètre pour désactiver les mises à jourdes compteurs de performances si les performances sont un problème.PerfMonIsActive=F

La valeur par défaut est T.

PerformanceMonitorOnLance automatiquement le remplissage des cubes de contrôle }Stats au démarraged'un serveur.

Les cubes de contrôle contiennent des statistiques que vous pouvez examiner poursuperviser les performances du système. Pour plus de détails sur les cubes decontrôle, voir "Cubes de contrôle" dans le document IBM Cognos TM1 Operations.


Par exemple, pour activer la supervision des performances, définissezPerformanceMonitorOn=T. Pour désactiver la supervision des performances,définissez PerformanceMonitorOn=F

PersistentFeedersPour améliorer le temps de rechargement des cubes avec des feeders, attribuez lavaleur True (T) au paramètre de configuration PersistentFeeders afin de stocker lesfeeders calculés dans un fichier .feeders.

Toute installation avec des temps de chargement de serveur supérieurs à5 minutes peut améliorer ses performances à l'aide de ce paramètre.


Lorsque ce paramètre a la valeur T et que le serveur détecte un fichier feederpermanent, il charge les feeders enregistrés, ce qui réduit la durée normalementnécessaire au recalcul de ces feeders. Les feeders sont enregistrés lors del'enregistrement des données ou de l'édition des règles. Vous n'enregistrez pasexplicitement les feeders.

Pour les installations ayant un grand nombre de calculs de feeder complexes, laconservation des feeders puis le rechargement de ces derniers lors du démarragedu serveur améliore les performances. Pour les feeders simples, la durée nécessaireà la lecture des feeders à partir du disque peut dépasser la durée requise pour lerecalcul des feeders, ce qui est préférable pour la plupart des installations.

L'utilisation de la fonction de feeders permanents augmente la taille système surdisque uniquement. La taille de mémoire n'est pas concernée par l'utilisation de ceparamètre.PersistentFeeders=T

Pour plus d'informations, consultez la rubrique «Utilisation des feederspermanents» dans le document IBM Cognos TM1 Operations.

PortNumberDéfinit le numéro de port utilisé pour distinguer entre plusieurs serveurs tournantsur le même ordinateur.


Quand plusieurs serveurs IBM Cognos TM1 sont installés sur un seul ordinateur,chaque serveur doit utiliser un numéro de port unique.


Quand vous installez un serveur Cognos TM1 , le numéro de port par défaut est12345. Les numéros de port admis vont de 5001 à 49151.

Si le fichier Tm1s.cfg ne contient pas de paramètre PortNumber, le serveur CognosTM1 utilise le port 5000. Les serveurs locaux Cognos TM1 utilisent le port 5000. Leport utilisé pour les messages de clients doit aussi avoir un numéro unique et estdéfini par défaut à 5001 quand le paramètre ClientMessagePortNumber est utilisé.

PreallocatedMemory.BeforeLoadIndique si la préallocation de mémoire a lieu avant le chargement du serveur ouen parallèle.



Si PreallocatedMemory.BeforeLoad=T (activé), la préallocation de mémoire esteffectuée avant le chargement du serveur. Si ce paramètre est désactivé, lapréallocation a lieu en parallèle d'un processus de chargement de serveur. Lesaméliorations globales du délai de chargement du serveur varient en fonction desvitesses d'allocation du système d'exploitation et des vitesses de consommation demémoire de la logique de chargement du serveur. Les administrateur de serveurTM1 peuvent modifier les paramètres de préallocation de mémoire afin d'obtenirdes résultats optimaux pour leur environnement.

PreallocatedMemory.SizeDéclenche la préallocation de la mémoire du serveur TM1 en pool.



La mémoire allouée est spécifiée en Mo (mégaoctets).

PreallocatedMemory.ThreadNumberIndique le nombre d'unités d'exécution utilisées pour la mémoire de préallocationdans le chargement de cubes à unités d'exécutions multiples.



PrivilegeGenerationOptimizationLorsque le serveur TM1 génère des privilèges de sécurité à partir d'un cube decontrôle de sécurité, il lit chaque cellule de ce cube.

Si le cube de contrôle de sécurité n'est pas dense, il en résulte un traitementsuperflu et un temps de chargement plus long. Un exemple de cube de sécurité


peu dense serait un cube ayant une plus grande proportion de paramètres desécurité par défaut par rapport aux paramètres de sécurité définis.


Pour résoudre ce problème, le paramètre PrivilegeGenerationOptimization peutêtre ajouté au fichier Tm1s.cfg comme suit :PrivilegeGenerationOptimization=T

Quand ce paramètre a la valeur T, le serveur Cognos TM1 ne lit que les cellulesremplies des cubes de sécurité. Dans le cas d'un cube de sécurité peu dense, letemps de chargement du serveur Cognos TM1 est considérablement réduit.

Remarque : Si vous remplissez les paramètres de sécurité à l'aide de règles et quevous voulez utiliser ce paramètre, vous devez créer les feeders des règles quiremplissent vos cubes de sécurité. Comme les paramètres de sécurité sont stockéssous forme de chaînes, les règles qui remplissent vos cubes de sécurité doiventinclure la fonction FeedStrings.

ProgressMessageCe paramètre détermine si les utilisateurs peuvent annuler les longs calculs de vue.

Quand un utilisateur ouvre une vue qui prendra longtemps à calculer, (il s'agitsouvent d'une vue ayant de hauts niveaux de consolidations ou des règlescomplexes),IBM Cognos TM1 supervise la progression du processus. QuandProgressMessage=T une boîte de dialogue s'ouvre pour permettre à l'utilisateurd'Arrêter de créer la vue.


Si l'utilisateur clique sur Arrêter de créer la vue, celle-ci est abandonnée sur leclient mais son calcul continue sur le serveur. Dans certains cas, cela peut mener àun blocage du serveur.v Si ProgressMessage=F, l'option Arrêter de créer la vue n'est pas proposée et

l'utilisateur ne peut pas annuler les opérations complexes. Ce paramètre aide àéviter les blocages potentiels du serveur dans les versions 9.1 SP3 à 9.4.

v Lorsque ProgressMessage=T ou n'existe pas dans le fichier Tm1s.cfg, l'optionArrêter de créer la vue s'ouvre pendant les calculs de vue complexes pourpermettre à l'utilisateur d'annuler le processus, si nécessaire. Pour les versions9.4 et ultérieures, l'utilisateur peut affecter un numéro de port unique enutilisant le paramètre ClientMessagePortNumber. Ce port supplémentaire permetà ces messages du programme de passer par un port secondaire et le traitementdu serveur peut se poursuivre sans bloquer les réserves de processus.

Remarque : Pour éviter un blocage potentiel des serveurs, les versions 9.1 SP3 à9.4 de Cognos TM1 ont un paramètre, ProgressMessage=F, inséré dans le fichierTm1s.cfg pendant l'installation du serveur. A partir de Cognos TM1 9.4, lesmessages de progression peuvent passer par le port secondaire affecté par leparamètre ClientMessagePortNumber et, dans les versions Cognos TM1 9.4 etultérieures, ProgressMessage=T est défini par défaut.

ProportionSpreadToZeroCellsPermet de réaliser une répartition proportionnelle à partir d'une consolidation sansgénérer d'erreur lorsque toutes les cellules feuilles contiennent la valeur zéro.


Dans ce cas, Cognos TM1 applique une répartition égale entre les cellules videslorsque le paramètre ProportionSpreadToZeroCells est activé. Cette fonctionnalitéest activée par défaut.


Comportement lorsque le paramètreProportionSpreadToZeroCells est activé

Ce paramètre et cette fonction sont activés par défaut pour vous permettre deréaliser une répartitions proportionnelle sans erreur à partir d'une consolidationdans laquelle toutes les cellules feuilles contiennent des zéros. Dans ce scénario,Cognos TM1 convertit l'entrée "P###" saisie en "LS*###" et applique une répartitionégale.

Lorsque ce paramètre est activé et que des données existent dans au moins unecellule feuille, le comportement en cas de répartition proportionnelle est le mêmeque dans les versions précédentes de Cognos TM1.

Ce paramètre est activé par défaut. Il est donc inutile de le faire. Si néanmoinsvous voulez le configurer de façon explicite, affectez au paramètreProportionSpreadToZeroCells la valeur T (True) dans le fichier deconfigurationTm1s.cfg, comme indiqué ci-dessous.

ProportionSpreadToZeroCells=T

Comportement lorsque le paramètreProportionSpreadToZeroCells est désactivé

La valeur F (False) affectée à ce paramètre désactive la fonction correspondante.Une erreur s'affiche lorsque vous tentez d'effectuer l'une des opérations derépartition proportionnelle suivantes :v Dans TM1 Contributor - Entrer un nombre dans une cellule consolidée alors que

toutes les cellules feuilles de la consolidation contiennent des zéros.v Dans TM1 Contributor et dans les autres clients TM1 - Effectuer une répartition

proportionnelle soit en entrant un code de répartition et un nombre (parexemple "P###") dans une cellule, soit en accédant à la répartitionproportionnelle à partir du menu contextuel ou du menu TM1 (TM1Perspectives seulement) lorsque toutes les cellules feuilles de la consolidationcontiennent des zéros.

Si vous procédez ainsi, TM1 Server réalise une répartition proportionnelle, maisl'opération échoue à cause des zéros contenus dans l'ensemble des cellules.

Pour désactiver cette fonctionnalité, affectez au paramètreProportionSpreadToZeroCells la valeur F (False) dans le fichier de configurationTm1s.cfg, comme indiqué ci-dessous.

ProportionSpreadToZeroCells=F

PullInvalidationSubsetRéduit le verrouillage des métadonnées en évitant de requérir un verrou en lecturepour la dimension au cours de la création, de la suppression ou du chargementd'un sous-ensemble sur le disque.



Valeur par défaut : T (activé)

Lorsqu'un utilisateur se connecte, le système charge les sous-ensembles nonenregistrés de l'utilisateur depuis le disque. Simultanément, un processusTurboIntegrator qui édite une dimension maintient un verrou IX (écritureintentionnelle) pour la dimension pour toute la durée du processus. Dans leséditions précédentes, ou si ce paramètre a pour valeur F (désactivé), la connexionpeut être bloquée pour toute la durée d'un processus TurboIntegrator à exécutionlongue. Les types de verrou TM1 ne sont pas compatibles les uns avec les autres.

RawStoreDirectoryIndique l'emplacement du fichier journal temporaire non traité pour lajournalisation d'audit si celle-ci a lieu dans un répertoire autre que le répertoire desdonnées.


Si ce paramètre n'est pas entré, le fichier journal non traité est enregistré par défautdans le répertoire indiqué par le paramètre DataBaseDirectory.

Pour plus d'informations sur d'autres paramètres de journalisation d'audit, voir«AuditLogMaxFileSize», à la page 315, «AuditLogMaxQueryMemory», à la page315, «AuditLogOn», à la page 316 et «AuditLogUpdateInterval», à la page 316.

ReceiveProgressResponseTimeoutSecsLe paramètre ReceiveProgressResponseTimeoutSecs permet de configurer leserveur de telle sorte qu'il interrompe la connexion du client et libère les ressourceslors de l'attente prolongée d'une action Annuler.


Lorsque le serveur Cognos TM1 effectue des opérations longues pour un client, desmessages de progression sont envoyés à intervalles réguliers à l'application clientCognos TM1. Le client répond à ces messages en indiquant si l'utilisateur a appuyésur le bouton Annuler, auquel cas cette longue opération est abandonnée. Cesréponses sont générées automatiquement par le code réseau dans l'applicationclient et aucune interaction de l'utilisateur n'a lieu. Après avoir envoyé le messagede progression, le serveur attend une réponse de l'application client. Pendantl'attente, l'unité d'exécution du client conserve le verrouillage des ressources sur leserveur Cognos TM1, empêchant les autres utilisateurs de faire d'autres demandesde serveur exigeant le même verrouillage des ressources.

Dans des cas précis, en particulier lors de l'exécution de clients Cognos TM1 dansun environnement Citrix, la réponse de l'application client n'atteint jamais leserveur Cognos TM1, ce qui entraîne une attente infinie du serveur. Il en résulteun verrouillage du système puisque l'unité d'exécution du client conserve unverrouillage de ressources jamais libérées.

Le paramètre ReceiveProgressResponseTimeoutSecs vous permet de configurervotre serveur pour détecter cette situation et interrompre la connexion au client, cequi libère les ressources. Quand ce paramètre a une valeur d'intervalle valide


(en secondes), le processus serveur met fin à la connexion au client, libérant lesressources verrouillées, si le serveur ne détecte pas la réponse de l'applicationclient dans l'intervalle spécifié.

Par exemple, si ReceiveProgressResponseTimeoutSecs=20 et si l'application clientne répond pas au message de progression envoyé par le serveur dans les20 secondes suivantes, la connexion au client est abandonnée. Une fois encore,aucune action n'est requise de la part de l'utilisateur pour générer cette réponse. Laréponse est générée automatiquement par l'application client et, si elle n'arrive pasdans les 20 secondes, indique un problème sérieux du client ou réseau sous-jacent.

ReceiveProgressResponseTimeoutSecs est un paramètre Tm1s.cfg facultatif. Si ceparamètre n'existe pas dans le fichier Tm1s.cfg, les processus ne sont pasabandonnés quand un client ne répond pas à un message de progression duserveur Cognos TM1.

Dans certaines installations de Cognos TM1 (version 9.4 ou ultérieure), leparamètre ClientMessagePortNumber définit un processus séparé pour traiter lesmessages d'annulation sans bloquer les réserves. LorsqueClientMessagePortNumber est disponible, ReceiveProgressResponseTimeoutSecsn'est pas utilisé.

RulesOverwriteCellsOnLoadEmpêche les cellules contenant des données calculées par des règles d'être effacéesau chargement du serveur.


Durant le traitement des instructions feeders d'un cube, l'une des valeurs decelui-ci peut être effacée s'il existe une règle pour la cellule. Une fois que le cubedont une cellule a été effacée a été sauvegardé, la valeur n'est plus là et l'action n'aplus d'effet sur le cube. Cependant, si la règle est modifiée alors que le cube nel'est pas en conséquence, celui-ci n'est pas sauvegardé sur le disque. Dans ce cas,les valeurs réelles des cellules peuvent être effacées lors de l'application des règles.

Le paramètre RulesOverwriteCellsOnLoad peut être utilisé pour empêcher la miseà zéro après la modification d'une règle.

Si vous modifiez des règles qui, à la suite de différentes mises à jour, peuventtransformer certaines cellules contenant des données en cellules calculées par desrègles, ajoutez RulesOverwriteCellsOnLoad=F au fichier de configuration.

Si ce paramètre a la valeur True ou n'est pas défini, les cellules calculées par desrègles sont mises à zéro au chargement du serveur. La valeur des données de cescellules est perdue, même si la règle est ensuite modifiée et que la cellule n'est pluscalculée par une règle.

Par défaut, ce paramètre n'est pas défini dans le fichier de configuration, ou savaleur est True.RulesOverwriteCellsOnLoad=F

RunningInBackgroundSi vous ajoutez la ligne RunningInBackground=T à tm1s.cfg, le serveur UNIX IBMCognos TM1 tourne en mode Arrière-plan.



Si vous utilisez les scripts startup_tm1s.sh et shutdown_tm1s.sh pour démarrer etarrêter les serveurs TM1, définissez RunningInBackground=T.

SaveTimeDéfinit l'heure du jour à laquelle un enregistrement automatique des données deserveur doit être exécuté ; enregistre les données tous les jours qui suivent à lamême heure. Comme un arrêt normal, SaveTime renomme le fichier journal, ouvreun nouveau fichier journal, et continue de tourner après l'enregistrement.


Le paramètre SaveTime n'est pas disponible lorsque le serveur Cognos TM1s'exécute en tant que service Windows.

Le format du paramètre SaveTime est jj:hh:mm où :v jj est le nombre de jours, à compter d'aujourd'hui, après lequel le système

commence à enregistrer automatiquement des données. Par exemple, 00 estaujourd'hui, 01 est demain, etc.

v hh:mm est l'heure du jour en format 24 heures.

SecurityPackageNameSi votre serveur IBM Cognos TM1 est configuré pour la connexion intégrée, ceparamètre définit le progiciel de sécurité utilisé pour authentifier votre nomd'utilisateur et votre mot de passe pour Microsoft Windows.


Les valeurs acceptables sont :v Kerberosv NTLMv Negotiate

Utilisez Kerberos à moins que vous n'exécutiez TM1 en local. Pour une exécutionen local, utilisez Negotiate ou NTLM. Negotiate sélectionne Kerberos à moins que cedernier ne puisse pas être utilisé par l'un des systèmes impliqués dansl'authentification.

Pour une description complète de tous les modes de sécurité de connexion, ycompris la connexion intégrée, voir «Connexion intégrée», à la page 239.

ServerCAMURIIndique l'URI du distributeur interne que le serveur IBM Cognos TM1 doit utiliserpour se connecter à Cognos Authentication Manager (CAM).

L'URI est indiqué sous la formehttp[s]://fully-qualified host IP address:port/p2pd/servlet/dispatch


Par exemple :https://vottbies005.ent.ad.cognos.com:9443/p2pd/servlet/dispatch


Pour l'authentification CAM, ce paramètre doit contenir le nom qualifié complet duserveur pour lequel le certificat Cognos Analytics a été créé.

Pour connaître le serveur pour lequel le certificat a été émis :1. Entrez l'URI SSL du répartiteur Cognos Analytics dans un navigateur.2. Mettez à jour le paramètre ServerCAMURI du fichier tm1s.cfg avec le nom

qualifié complet de ce serveur.Par exemple :ServerCAMURI=https://vottbies005.ent.ad.cognos.com:9443/p2pd/servlet/dispatch.

Pour configurer l'utilisation de CAM SSL dans Cognos TM1 Applications Server,1. Les paramètres suivants doivent être définis dans Cognos Configuration :v Chemins qualifiés imposés avec la valeur Faux.v Voulez-vous utiliser une authentification mutuelle avec la valeur Vrai

2. Acceptez le certificat au moment de l'enregistrement.

ServerCAMURIRetryAttemptsDéfinit le nombre de tentatives après lequel le système passe à l'entréeServerCAMURI suivante du fichier tm1s.cfg.


Ce paramètre est applicable uniquement si vous utilisez IBM Cognos TM1 avec lasécurité Cognos Analytics et si vous avez défini plusieurs répartiteurs dans lefichier tm1s.cfg. Les répartiteurs sont définis à l'aide du paramètre ServerCAMURI.

Par exemple, supposons que trois paramètres ServerCAMURI soient définis dans lefichier tm1s.cfg et que vous ayez défini ServerCAMURIRetryAttempts=7.ServerCAMURI=http://server1:9300/p2pd/servlet/dispatchServerCAMURI=http://server2:9300/p2pd/servlet/dispatchServerCAMURI=http://server3:9300/p2pd/servlet/dispatchServerCAMURIRetryAttempts=7

Le système tente sept fois d'utiliser le premier répartiteur (http://server1:9300/p2pd/servlet/dispatch). Si celui-ci ne répond pas, il tente sept fois d'utiliser ledeuxième. Si celui-ci ne répond pas, le système tente sept fois d'utiliser letroisième. Si le troisième ne répond pas, la connexion échoue.


ServerLoggingCrée un journal contenant les détails de l'activité de sécurité sur le serveur IBMCognos TM1 qui sont associés à la connexion intégrée.


Le fichier journal, nommé Tm1server.log, est enregistré dans le répertoire dedonnées du serveur Cognos TM1 . Le paramètre ServerLogging est utileuniquement si votre serveur Cognos TM1 est configuré pour la connexion intégrée.

Définissez ServerLogging sur T dans Tm1s.cfg. Notez en outre que siServerLogging=T est défini, vous devez renommer le fichier journal des messages


du serveur Cognos TM1, tm1server.log, en modifiant le paramètre correspondantdans le fichier de configuration du gestionnaire de journalisation,tm1s-log.properties.

Remarque : Si vous modifiez ce paramètre de façon dynamique (sans redémarrerle serveur TM1), la journalisation se produit uniquement pour les nouvellessessions client.

ServerNameDéfinit le nom du serveur IBM Cognos TM1. Si vous ne fournissez pas ceparamètre, Cognos TM1 nomme le serveur Local et le traite comme un serveurlocal.


ServicePrincipalNameIndique le nom principal de service (SPN) lors de l'utilisation de la connexionintégrée avec TM1 Web et la délégation contrainte.


Utilisez le format suivant pour ajouter le paramètre au fichier Tm1s.cfg :

ServicePrincipalName=SPN

La valeur que vous définissez ici doit correspondre au nom de service qui aégalement été mappé à un compte de domaine sur le contrôleur de domaineActive Directory, à l'aide de l'outil de ligne de commande Microsoft, setspn.exe.

Par exemple, si vous utilisez setspn.exe pour ajouter un SPN de la manièresuivante :

setspn -a FPM/TM1 WbSvr_Account

vous devez définir ainsi le paramètre ServicePrincipalName :

ServicePrincipalName=FPM/TM1

Pour plus d'informations sur la délégation contrainte et la configuration du SPN,recherchez dans le site Web Microsoft la rubrique «Kerberos Technical Supplementfor Windows».

SkipLoadingAliasesUtilisez SkipLoadingAliases pour accélérer le chargement du serveur et la mise àjour des vues en sautant le chargement des alias.


Contactez le support client pour déterminer si ce paramètre s'applique à votresystème Cognos TM1.

Les valeurs acceptables sont :v T - Alias ignorésv F - Alias chargés


SkipSSLCAMHostCheckIndique si le processus de confirmation de l'ID du certificat SSL peut être omis.

La valeur par défaut est False.


Important : Ce paramètre ne doit être défini sur True que si un certificat génériqueest utilisé à des fins de démonstration.

SpreadingPrecisionLe paramètre SpreadingPrecision permet d'augmenter ou de réduire la marged'erreur lors des calculs de répartition.


L'arithmétique à virgule flottante sur ordinateur n'est pas précise à 100%. Quandun ordinateur calcule de très petits nombres, une marge d'erreur est appliquée aucalcul. Si l'ordinateur ajoute un ensemble de nombres et que la somme résultanteest proche de la valeur cible dans la marge d'erreur acceptée, la somme estconsidérée exacte.

La marge d'erreur de certains calculs Cognos TM1 est contrôlée par le paramètreSpreadingPrecision. La valeur par défaut est SpreadingPrecision=1e-8. Cette valeurest utilisée dans les scénarios de répartition suivants :v Répartition depuis une cellule consolidée.v Répartition dans des cellules feuilles dont la valeur consolidée est conservée.

Répartition depuis une consolidation

Quand vous exécutez une répartition de cellules proportionnelle depuis une celluleconsolidée, Cognos TM1 écrit les nombres dans chaque cellule de la plage etcumule le total pour recalculer la consolidation. Le total de toutes les cellules de laconsolidation est ensuite comparé à la valeur initiale que vous avez fournie pour lafonction de répartition. Ce total peut être différent de la valeur cible à cause desrègles appliquées aux éléments de niveau n ou à la cellule consolidée elle-même.

Si les règles sont définies de telle sorte que la valeur générée ne correspond pas àla valeur de répartition souhaitée, une erreur sera renvoyée et la répartition ne serapas effectuée.

Si SpreadingPrecision=1e-8, le total calculé par Cognos TM1 pour la consolidationdoit être dans les 0,000001 % de la valeur cible (c'est-à-dire correct à 99,999999 %),ou Cognos TM1 affiche un message d'erreur. Une erreur de plus de 0,01 USD surune répartition consolidée de 1 000 000 USD entraîne une erreur.

Vous pouvez augmenter ou diminuer la marge d'erreur pour ces types de calcul enutilisant le paramètre SpreadingPrecision.

Les exemples suivants comprennent des valeurs valides pour le paramètreSpreadingPrecision :v SpreadingPrecision=1e-4

v SpreadingPrecision=1e-8




Répartition et consolidation des retenues

Le paramètre SpreadingPrecision est également effectif dans les circonstancessuivantes :v Répartition de valeurs dans des cellules feuilles regroupées dans une

consolidationv Consolidation à laquelle une retenue a été appliquée

Supposons par exemple la consolidation Q1 ayant les valeurs Jan, Feb et Mar.

Si Q1- a une retenue de consolidation et si vous répartissez les valeurs sur Jan etFeb, Cognos TM1 effectue les opérations suivantes :v Applique la répartition à Jan et Feb.v Ajuste Mar.v Ajoute ensemble les trois éléments de niveau n.v Compare la somme des éléments de niveau n à la valeur de Q1.

Si la somme respecte la marge d'erreur spécifiée par le paramètreSpreadingPrecision, la répartition réussit. Si la somme ne respecte pas la marged'erreur spécifiée par le paramètre SpreadingPrecision, Cognos TM1 génère uneerreur.

SpreadErrorInTIDiscardsAllChangesSi SpreadErrorInTIDiscardsAllChanges est activé et qu'une erreur se propage lorsde l'exécution d'un script TurboIntegrator, toutes les modifications effectuées par lescript TurboIntegrator sont annulées.


Pour activer SpreadErrorInTIDiscardsAllChanges, ajoutez la ligne suivante aufichier tm1s.cfg :SpreadErrorInTIDiscardsAllChanges=T


SSLCertAuthorityDéfinit le nom du fichier de l'autorité de certification du serveur IBM Cognos TM1.Ce fichier doit résider sur l'ordinateur sur lequel le serveur TM1 est installé.


Si vous utilisez vos propres certificats SSL avec TM1, vous pouvez trouver cettevaleur à l'aide de Microsoft Management Console. Cliquez sur Certificats >Personnel > Certificats. Le nom de principal figure dans la colonne Délivré par dela sous-fenêtre Propriétés.

SSLCertificateDéfinit le chemin complet du fichier de certificat du serveur IBM Cognos TM1, quicontient la paire clé privée/clé publique.



SSLCertificateIDDéfinit le nom du principal auquel le certificat du serveur IBM Cognos TM1 estdestiné.


Si vous utilisez vos propres certificats SSL avec TM1, vous pouvez trouver cettevaleur à l'aide de Microsoft Management Console. Cliquez sur Certificats >Personnel > Certificats. Le nom de principal figure dans la colonne Délivré à de lasous-fenêtre Propriétés.

StartupChoresStartupChores est un paramètre de configuration qui identifie la liste des tâchesexécutées par le serveur au démarrage.


Pour exécuter des tâches au démarrage du serveur, avant la connexion desutilisateurs et les autres tâches planifiées, ajoutez ce paramètre en séparant le nomdes tâches par un deux-points, par exemple :StartupChores=ChoreName1:ChoreName2:ChoreName3:ChoreNameN

Sans ce paramètre, les tâches ne sont pas exécutées. Si un nom de tâche necorrespond pas à une tâche existante, une erreur est enregistrée dans le journal duserveur et celui-ci passe à la tâche suivante.

La valeur du paramètre de configuration peut être extraite par une applicationclient en tant que propriété serveur StartupChores à l'aide de l'appel existantTM1ObjectPropertyGet.

Il s'agit d'une propriété en lecture seule et les opérations de définitions sontrejetées. La valeur de cette propriété n'est modifiable qu'en procédant à l'édition dufichier de configuration puis au redémarrage du serveur.

SubsetElementBreatherCountCe paramètre détermine la manière dont IBM Cognos TM1 gère le comportementde verrouillage des sous-ensembles.


LorsqueSubsetElementBreatherCount=-1

le serveur Cognos TM1 ne déverrouille jamais un sous-ensemble si d'autresdemandes pour ce sous-ensemble sont en attente. Il s'agit du paramètre par défaut.Il permet d'optimiser les performances d'affichage pour un seul utilisateur, mais audétriment de l'accès simultané de plusieurs utilisateurs.

Si SubsetElementBreatherCount est défini sur une valeur supérieure à zéro (0), leserveur TM1 libère le verrou sur les sous-ensembles lorsque d'autres demandessont en attente pour le sous-ensemble, puis il acquiert à nouveau le verrou une foisque les demandes en attentes ont été traitées. Ce paramètre améliore lesperformances lorsque plusieurs utilisateurs tentent d'accéder au mêmesous-ensemble, notamment si celui-ci contient plus de 100 éléments.


SupportPreTLSv12ClientsDepuis TM1 10.2.2 groupe de correctifs 6 (10.2.2.6), toutes les communicationssécurisées par SSL entre les clients et les serveurs de TM1 utilisent le protocole TLS(Transport Layer Security) 1.2. Ce paramètre détermine si les clients antérieurs à laversion 10.2.2.6 peuvent se connecter au serveur TM1 version 10.2.2.6 ou ultérieure.


Pour permettre aux clients antérieurs à la version 10.2.2.6 de se connecter auserveur TM1 version 10.2.2.6 (ou ultérieure), ajoutez la ligne suivante au fichierTm1s.cfg :SupportPreTLSv12Clients=T

Si le serveur TM1 est configuré de sorte à autoriser les connexions à partir declients antérieurs à TLS version 1.2, la connexion avec de tels clients est établie àl'aide du protocole TLS 1.0.

Si SupportPreTLSv12Clients n'est pas présent dans le fichier Tm1s.cfg ou queSupportPreTLSv12Clients=F, les clients antérieurs à la version 10.2.2.6 ne peuventpas se connecter à un serveur TM1 version 10.2.2.6 ou ultérieure.

SvrSSLExportKeyIDSpécifie la clé d'identité utilisée pour exporter le certificat du serveur IBM CognosTM1 à partir du magasin de certificats de Microsoft Windows.


Dans la plupart des cas, la valeur de SvrSSLExportKeyID sera identique à celle deSSLCertificate.

SyncUnitSizeDéfinit la fréquence d'enregistrement d'un point de contrôle au cours d'unprocessus de synchronisation en cas d'échec d'une connexion réseau.


Remarque : Lorsque vous utilisez le paramètre SyncUnitSize, vous devez aussiconfigurer le paramètre MaximumSynchAttempts. Pour plus d'informations, voir«MaximumSynchAttempts», à la page 348.

Si vous configurez les deux paramètres SyncUnitSize et MaximumSynchAttemptset qu'un processus de synchronisation est interrompu à la suite d'une perte deconnexion réseau, le processus essaiera de se reconnecter et de terminer lasynchronisation à partir du dernier point de contrôle.

Pour définir ce paramètre, ajoutez la ligne suivante au fichier Tm1s.cfg du serveurPlanet :SyncUnitSize=n

où n représente le nombre d'enregistrements de synchronisation écrits dans lefichier journal de transactions, Tm1s.log, après l'enregistrement de tel ou tel pointde contrôle.

La valeur par défaut est de 1000.


La valeur recommandée est de 500.

tlsCipherListIndique une liste séparée par des virgules des suites de chiffrement prises encharge, par ordre de priorité.


Utilisez tlsCipherList pour indiquer les suites de chiffrement acceptables pourvotre système TM1. Les suites de chiffrement répertoriées sont présentées à lanégociation SSL selon l'ordre dans lequel elles sont répertoriées, pour les côtésclient et serveur de la négociation. Au moins l'une des suites de chiffrementrépertoriées pour le client et le serveur doit correspondre.

Les suites de chiffrement suivantes sont prises en charge :v RFC 2246 : "protocole TLS version 1.0 " (http://www.ietf.org/rfc/rfc2246.txt)v RFC 4346 : "protocole TLS (Transport Layer Security) version 1.1"

(http://www.ietf.org/rfc/rfc4346.txt)v RFC 5246 : "protocole TLS (Transport Layer Security) version 1.2"

(http://www.ietf.org/rfc/rfc5246.txt)v RFC 4492 : "suites de chiffrement ECC (Elliptic Curve Cryptography) pour TLS

(Transport Layer Security)" (http://www.ietf.org/rfc/rfc4492.txt)v RFC 5289 : suites de chiffrement ECC (Elliptic Curve Cryptography) pour TLS

avec SHA-256/384 et AES Galois Counter Mode (GCM) (http://www.ietf.org/rfc/rfc5289.txt)

Par exemple :tlsCipherList=TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_RC4_128_MD5, TLS_RSA_WITH_AES_128_CBC_SHA256

TM1ConnectorforSAPDéfinissez ce paramètre sur T pour utiliser le logiciel IBM Cognos TM1 Connectorfor SAP.


Remarque : Cette fonctionnalité est disponible uniquement pour les clients qui ontacheté le logiciel IBM Cognos TM1 Connector for SAP. Ce logiciel étaitprécédemment disponible indépendamment du logiciel IBM Cognos TM1. Il n'estplus commercialisé.

Si vous aviez acheté cette fonctionnalité, vous devez ajouter TM1ConnectorforSAP=Tet UseNewConnectorforSAP=T au fichier tm1s.cfg pour rendre le logiciel disponible.


UnicodeUpperLowerCaseCe paramètre de configuration indique au serveur TM1 d'identifier et de gérer lesnoms d'objets en Unicode de manière à empêcher la création de noms d'objet dontla seule différence résiderait dans la casse.

Type de paramètre :v Facultatif


http://www.ietf.org/rfc/rfc2246.txt







v StatiqueSi vous modifiez la valeur de ce paramètre, redémarrez le serveur TM1 pourappliquer la nouvelle valeur.

TM1 gère les noms d'objets en ASCII sans tenir compte des minuscules et desmajuscules. Le nom VENTES est équivalent à ventes. Une référence à VENTES,Ventes ou VeNteS est considérée comme une référence au même élément. De lamême façon, le nom de cube Projections équivaut à PROJECTIONS.

Cependant, les noms d'objet en Unicode ne sont pas gérés sans tenir compte de lacasse. En conséquence, un serveur peut créer deux noms d'objet identiques avec lacasse pour seule différence. Par exemple, les éléments SLOVÉNIE et slovéniepeuvent exister dans la même dimension tout en étant considérés comme deséléments uniques.

L'insertion du paramètre UnicodeUpperLowerCase=T dans le fichier TM1s.cfgempêche la création de noms d'objet dont la seule différence résiderait dans lacasse. Lorsque UnicodeUpperLowerCase=T, les noms d'objet en Unicode sont géréscomme des noms en ASCII, sans tenir compte des minuscules et des majuscules.

Si vous avez développé des applications qui utilisent la différence de casse desnoms d'objet en Unicode, et si vous souhaitez conserver cette fonctionnalité,n'ajoutez pas le paramètre de configuration UnicodeUpperLowerCase au fichierTm1s.cfg. Si ce paramètre n'est pas présent dans le fichier Tm1s.cfg (ou si sa valeurest F) TM1 continue à prendre en compte la casse des noms d'objet Unicode.

UseExcelSerialDateActive l'utilisation des numéros de date Microsoft Excel à la place des numéros dedate TM1.


Si UseExcelSerialDate est activé, les fonctions de règles de TM1 et les fonctions deTurboIntegrator utilisent le 1er janvier 1900 comme date de base des numéros dedate à la place du 1er janvier 1960.

Auparavant, les fonctions de règles TM1 utilisaient des numéros de date quireprésentaient le nombre de jours écoulés depuis le 1er janvier 1960. Cela est enconflit avec les numéros de date de Microsoft Excel, qui représentent le nombre dejours écoulés depuis le 1er janvier 1900. Les fonctions de formatage des nombresde TM1 supposent que les données des cubes utilisent les numéros de date deMicrosoft Excel, plutôt que ceux de TM1.

Pour éviter de devoir convertir les dates, activez UseExcelSerialDate pour que lesfonctions de règles utilisent les dates Microsoft Excel au lieu des dates TM1existantes.UseExcelSerialDate=T


Exemple

L'exemple qui suit met en évidence le problème des numéros de date.

La règle suivante renvoie la date 26 mai 2015.


[]= N:(DAYNO(’2015-05-26’));

Le résultat non formaté est 20234, qui indique que 20234 jours se sont écoulésdepuis le 1er janvier 1960. La fonction de règles utilise les anciens numéro de datede TM1.

Lorsque vous définissez le format d'affichage des dates dans TM1 (par exemple,jj mmmm aaaa, le résultat et le 25 mai 1955, car 20234 jours se sont écoulés entre le1er janvier 1900 et le 25 mai 1955. La valeur est interprétée comme un numéro dedate Microsoft Excel.

Une fois que vous avez ajouté UseExcelSerialDate=T au fichier tm1s.cfg et quevous avez redémarré le serveur TM1, le résultat attendu, le 26 mai 2015, s'affichedans TM1. La fonction de règles utilise désormais le 1er janvier 1900 comme datede base pour les numéros de date.

UseLocalCopiesforPublicDynamicSubsetsAméliore les performances des sous-ensembles dynamiques publiques et réduit lesverrouillages en utilisant des copies locales des sous-ensembles dès que cela estpossible.


Par défaut, ou si ce paramètre n'est pas présent dans le fichier Tm1s.cfg, leparamètre UseLocalCopiesforPublicDynamicSubsets est activé. Pour restaurerl'ancienne méthode d'enregistrement des sous-ensembles dynamiques, affectez lavaleur F à ce paramètre.

UseNewConnectorforSAPDéfinissez ce paramètre sur T pour utiliser le logiciel IBM Cognos TM1 Connectorfor SAP.


Remarque : Cette fonctionnalité est disponible uniquement pour les clients qui ontacheté le logiciel IBM Cognos TM1 Connector for SAP. Ce logiciel étaitprécédemment disponible indépendamment du logiciel IBM Cognos TM1. Il n'estplus commercialisé.

Si vous aviez acheté cette fonctionnalité, vous devez ajouterUseNewConnectorforSAP=T et TM1ConnectorforSAP=T au fichier tm1s.cfg pourrendre le logiciel disponible.


UserDefinedCalculationsActive les options Remonter et Insérer un sous-ensemble pour créer desconsolidations définies par l'utilisateur dans l'éditeur de sous-ensemble d'IBMCognos TM1 Perspectives et Architect, et active le bouton Créer une consolidationpersonnalisée dans les clients TM1 Web.


Par défaut, UserDefinedCalculations est activé.


Pour désactiver les consolidations définies par l'utilisateur dans TM1 Perspectives,dans Architect et dans les clients TM1 Web, ajoutez la ligne suivante dans le fichiertm1s.cfg :UserDefinedCalculations=F

Remarque : Lorsque la valeur est définie sur F, les utilisateurs peuvent voir :v Dans Architect et Perspectives, lorsque les utilisateurs cliquent sur l'option

Remonter ou Insérer un sous-ensemble, ils reçoivent un message d'erreurindiquant que les calculs définis par l'utilisateur ne sont pas activés.

v Dans TM1 Web, le bouton Créer une consolidation personnalisée est grisé.

UseSQLFetch UseSQLFetchScroll UseSQLExtendedFetchCes paramètres commandent à IBM Cognos TM1 d'utiliser un appel d'extractiondonné.


Lorsque vous exécutez un processus TurboIntegrator qui extrait des informationsd'une source de données ODBC, Cognos TM1 tente d'utiliser l'appel d'extractionSQL le plus efficace. Cognos TM1 interroge le pilote ODBC pour déterminer lesappels SQL Fetch à utiliser pour l'extraction des données :

SQLFetch(), une fonction ODBC 1

SQLExtendedFetch(), une fonction ODBC 2

SQLFetchScroll(), une fonction ODBC 3

Tous ces paramètres sont dynamiques.

Si Cognos TM1 ne reçoit pas de réponse lors de l'interrogation du pilote ODBC,votre processus Cognos TM1 renvoie une erreur, à moins qu'un des paramètressuivants ait la valeur T dans votre fichier Tm1s.cfg :

UseSQLFetch

UseSQLFetchScroll

UseSQLExtendedFetch

Ces paramètres commandent à Cognos TM1 d'utiliser un appel d'extraction donné.Vous devez vous assurer que l'appel spécifié dans Tm1s.cfg est approprié pour lepilote ODBC utilisé et vous ne pouvez spécifier qu'un seul de ces paramètres dansTm1s.cfg.

Par exemple, pour commander au serveur Cognos TM1 d'utiliser l'appelSQLExtendedFetch() pour extraire des données d'une source ODBC, ajoutez laligne suivante au fichier Tm1s.cfg :UseSQLExtendedFetch=T

UseSSLActive ou désactive SSL sur le serveur IBM Cognos TM1 .



Ce paramètre est activé par défaut.

Pour désactiver SSL, définissez UseSSL=F.

Si UseSSL=T, vous devez définir plusieurs autres paramètres de tm1s.cfg quigèrent l'implémentation de SSL. Pour de plus amples détails sur ces paramètres,voir «Utilisation de SSL pour la sécurisation de la transmission de données», à lapage 272.


UseStargateForRulesIndique si une règle utilise la vue Stargate.


Par défaut, chaque fois qu'une règle fait référence à une valeur calculée, celle-ci estrécupérée depuis une vue Stargate stockée en mémoire, si disponible. Dans laplupart des cas, l'emploi de la vue Stargate pour des règles permet d'améliorer lesperformances. Il est plus efficace de récupérer une valeur calculée en mémoire quede demander et récupérer un calcul de serveur.

Dans certains cas difficiles, voire impossibles, à déterminer à l'avance, etuniquement après des essais, la récupération d'une valeur calculée depuis une vueStargate est en fait plus lente que la demande/récupération de la valeur depuis leserveur. Dans ces cas, ajoutez la ligne suivante au fichier Tm1s.cfg afin que lesrègles Cognos TM1 récupèrent toujours les valeurs calculées depuis le serveur, cequi améliore les performances.UseStargateForRules=F

Veuillez contacter le support client avant d'ajouter le paramètreUseStargateForRules.

ViewConsolidationOptimizationActive ou désactive l'optimisation de la consolidation des vues sur le serveurCognos TM1.


L'utilisation de ce paramètre contribue à accroître les performances lors du calculdes éléments consolidés. Active ou désactive ViewConsolidationOptimization sur leserveur Cognos TM1 .

L'optimisation de la consolidation des vues stocke les valeurs consolidées utilisantdes composants simples sur l'axe des lignes ou des colonnes. Examinons parexemple la structure de dimension Year, 1Quarter ayant les valeurs Jan, Feb et Mar.

Quand un élément de ligne ou de colonne utilise l'élément Jan, les consolidations 1Quarter et Year sont calculées et stockées pour être utilisées comme référence parla suite. La performance en est améliorée mais la quantité de mémoire requisepour une vue donnée en est aussi accrue.

Pour désactiver l'optimisation de la consolidation des vues, ajoutez la lignesuivante dans le fichier Tm1s.cfg :


ViewConsolidationOptimization=F

ViewConsolidationOptimizationMethodCe paramètre définit la méthode utilisée pour obtenir l'optimisation deconsolidation de vue quand le paramètre ViewConsolidationOptimization estactivé sur le serveur IBM Cognos TM1.


Il existe deux méthodes que ViewConsolidationOptimization peut utiliser pourcalculer et stocker des consolidations : ARRAY ou TREE. La méthode ARRAYstocke les consolidations dans un tableau temporaire. La méthode TREE stocke lesconsolidations dans une arborescence.

ViewConsolidationOptimizationMethod doit être défini à TREE dans la plupart descas. Ce paramètre offre des performances optimales en fonctionnement normal.

Dans les rares cas, l'utilisation de la méthode TREE peut entraîner la dégradationdes performances. Dans un tel cas, essayez de définir le paramètre sur ARRAY. Parexemple, dans le cas rare où les dimensions ont seulement quelques élémentsfeuille dont l'agrégation (rollup) produit un grand nombre de consolidations,ViewConsolidationOptimizationMethod doit être défini à ARRAY.

Pour définir ce paramètre, ajoutez la ligne appropriée à votre fichier deconfiguration :ViewConsolidationOptimizationMethod=TREE

ouViewConsolidationOptimizationMethod=ARRAY

Si ViewConsolidationOptimizationMethod n'est pas explicitement défini dans lefichier Tm1s.cfg, la méthode ARRAY est utilisée par défaut, ce qui conserve lacohérence avec la version précédente de TM1, avant l'introduction de ce paramètre.

ZeroWeightOptimizationDétermine si les membres consolidés avec une pondération de 0 sont factoriséesdans le calcul des valeurs des cellules consolidées ou des fonctions deconsolidation. Les fonctions de consolidation sont ConsolidatedCount,ConsolidatedMax, ConsolidatedMin, ConsolidatedAvg, ConsolidatedCount etConsolidatedCountUnique.


Lorsque ce paramètre a la valeur true, les membres pour lesquels la pondérationest zéro sont éliminés de la liste de consolidation, et ne sont donc pas traités lorsdu calcul des valeurs des cellules consolidées ou des fonctions de consolidation. Ils'agit du comportement par défaut.

Lorsque ce paramètre a la valeur false, les membres pour lesquels la pondérationest zéro sont inclus dans la liste de consolidation, et sont donc factorisés dans lescalculs.



Annexe B. Fichier de configuration du client Tm1p.ini

Le fichier Tm1p.ini spécifie les informations d'environnement des clients IBMCognos TM1 (Cognos TM1 Perspectives, Cognos TM1 Architect et Cognos TM1Clients).

Emplacement du fichier Tm1p.iniIBM Cognos TM1 installe une version par défaut du fichier Tm1p.ini et créeégalement une version du fichier spécifique à l'utilisateur.

Les deux versions du fichier Tm1p.ini sont stockées dans des emplacementsdifférents.

Version système par défaut du fichier Tm1p.ini

La version système par défaut de Tm1p.ini permet à plusieurs utilisateurs d'utiliserCognos TM1 sur un ordinateur donné. Tm1p.ini doit être présent la première foisqu'un utilisateur démarre Cognos TM1 sur l'ordinateur, car les paramètres dans laversion système par défaut régissent le comportement du démarrage initial duclient Cognos TM1 à chaque utilisation.

L'emplacement d'installation de la version système par défaut du fichier Tm1p.inidépend de la version de Microsoft Windows que vous utilisez.

Pour Microsoft Windows XP ou Windows Server 2003 :

L'emplacement d'installation de la version système par défaut du fichierTm1p.ini est :

%ALLUSERSPROFILE%\Application Data\Applix\TM1\

Par exemple :

C:\Documents and Settings\All Users\Application Data\Applix\TM1\Tm1p.ini

Conseil : Pour connaître la valeur de la variable d'environnement%ALLUSERSPROFILE%, lancez echo %ALLUSERSPROFILE% sur une ligne decommande.

Pour Microsoft Windows 7 et Windows Server 2008 :

Pour des versions plus récentes de Microsoft Windows, l'emplacement dufichier système par défaut Tm1p.ini est déterminé par le paramètre%ProgramData%.

%ProgramData%\Applix\TM1\

Par exemple :

C:\ProgramData\Applix\TM1\Tm1p.ini

Conseil : Lancez echo %ProgramData% sur une ligne de commande pourconnaître l'emplacement exact.


Version spécifique à l'utilisateur du fichier Tm1p.ini

Dès qu'un utilisateur démarre Cognos TM1 sur l'ordinateur, une copie du fichierTm1p.ini est créée dans son répertoire %USERPROFILE%.

La copie de Tm1p.ini spécifique à l'utilisateur enregistre les définitions et lesmodifications de paramètre effectuées par celui-ci et régit le comportement duclient Cognos TM1 pour les futures versions de l'utilisateur.

La boîte de dialogue des options de Cognos TM1 stocke également un grandnombre de ces paramètres. Vous pouvez les modifier dans celle-ci ou en modifiantle fichier Tm1p.ini. Les paramètres de Tm1p.ini et les options de TM1 sont décritsci-dessous.

L'emplacement exact de %USERPROFILE% dépend de la version de MicrosoftWindows que vous utilisez.

Conseil : Lancez echo %USERPROFILE% sur une ligne de commande pour connaîtrel'emplacement exact.

Pour Microsoft Windows XP ou Windows Server 2003 :

L'emplacement d'installation de la version utilisateur du fichier Tm1p.iniest :

%USERPROFILE%\nom de l'utilisateur\Application Data\Applix\TM1\

Par exemple :

C:\Documents and Settings\nom de l'utilisateur\ApplicationData\Applix\TM1\Tm1p.ini

Pour Microsoft Windows 7 et Windows Server 2008 :

Pour les versions plus récentes de Microsoft Windows, la copie spécifique àl'utilisateur du fichier Tm1p.ini se trouve dans :

%USERPROFILE%\nom de l'utilisateur\AppData\Roaming\Applix\TM1\

Par exemple :

C:\Users\ADMIN\AppData\Roaming\Applix\TM1\Tm1p.ini

Paramètres du fichier Tm1p.iniLes paramètres suivants peuvent être utilisés dans le fichier Tm1p.ini.

AdminHostAffiche le nom de l'hôte Admin sur lequel un serveur Admin est exécuté. Dans laboîte de dialogue Options d'IBM Cognos TM1, utilisez l'option Hôte Admin desparamètres de connexion.

AdminSvrSSLCertAuthorityChemin complet du fichier d'autorité de certification qui a délivré le certificat duserveur Admin d'IBM Cognos TM1.

Dans la boîte de dialogue Options de Cognos TM1, utilisez l'option Autorité decertification.


AdminSvrSSLCertIDNom du principal auquel le certificat du serveur Admin IBM Cognos TM1 estdélivré.

Remarque : La valeur de ce paramètre doit être identique à celle du paramètreSSLCertificateIDparameter du serveur Admin Cognos TM1 tel qu'il est définidans IBM Cognos Configuration.

Pour les clients, ce paramètre peut aussi être défini pour les clients dans la zone IDde certificat de la fenêtre Options de Cognos TM1.

AdminSvrSSLCertRevListChemin complet du fichier de révocation de certificats délivré par l'autorité decertification ayant délivré le certificat du serveur Admin IBM Cognos TM1.

Un fichier de révocation de certificats n'existe qu'en cas de révocation de certificat.Dans la boîte de dialogue Options de Cognos TM1 , utilisez l'option Liste derévocation de certificats.

AdminSvrSSLExportKeyIDClé d'identité utilisée pour exporter le certificat de l'autorité de certification qui ainitialement délivré le certificat du serveur Admin IBM Cognos TM1, à partir dumagasin de certificats.

Ce paramètre est requis uniquement si vous choisissez d'utiliser le magasin decertificats en définissant ExportAdminSvrSSLCert=T.

Dans la boîte de dialogue Options de Cognos TM1, utilisez l'option ID du certificatd'exportation.

AdvancedRulesEditorIndique le type d'éditeur de règles utilisé.

L'interface de l'éditeur de règles avancé a été améliorée.v T - L'éditeur de règles avancé est utilisé.v F (réglage par défaut) - L'éditeur de règles standard est utilisé.

AllowImportCamClientsCe paramètre est requis uniquement lorsque vous configurez IBM Cognos TM1pour utiliser l'authentification CAM.

Il doit avoir la valeur T lorsque vous importez un utilisateur administratif de CAMdans Cognos TM1.

Si le serveur Cognos TM1 n'est pas configuré pour utiliser l'authentification CAM,ce paramètre doit avoir la valeur F ou être omis du fichier Tm1p.ini.

Pour plus d'informations, voir «Configuration de la sécurité Cognos dans TM1Server», à la page 258.

Annexe B. Fichier de configuration du client Tm1p.ini 379

BrowseDisplayReadsRightToLeftIndique comment les données sont orientées dans Cube Viewer.

Elles peuvent être affichées de droite à gauche ou de gauche à droite.v T - Données orientées de droite à gauche.v F (réglage par défaut) - Données orientées de gauche à droite.

ClassicSliceModeIndique si l'option Tranche de Cube Viewer génère des tranches classiques oudynamiques.v T - L'option Tranche génère des tranches classiques.v F - L'option Tranche génère des tranches dynamiques.

CognosGatewayURICe paramètre est requis uniquement lorsque vous configurez IBM Cognos TM1pour utiliser l'authentification de sécurité IBM Cognos (CAM).

Sa valeur doit être l'URI de votre passerelle IBM Cognos. L'URI doit avoir la formehttp[s]:/<hôte>/cognosx/cgi-bin/cognos.cgi ou http[s]:/<hôte>/ibmcognos/cgi-bin/cognos.cgi.

Par exemple, http://win2003test/ibmcognos/cgi-bin/cognos.cgi.

Si le serveur Cognos TM1 n'est pas configuré pour utiliser l'authentification CAM,ce paramètre doit être omis du fichier Tm1p.ini.

Pour plus d'informations, voir «Configuration de la sécurité Cognos dans TM1Server», à la page 258.

ConnectLocalAtStartupIndique si IBM Cognos TM1 Architect ou IBM Cognos TM1 Perspectives seconnecte automatiquement au serveur local au démarrage.v T - (réglage par défaut) - Cognos TM1 se connecte au serveur local au

démarrage.v F - Cognos TM1 ne se connecte pas au serveur local au démarrage.

DataBaseDirectoryUtilise le chemin d'accès complet du répertoire de données du serveur local.

Il est possible de spécifier plusieurs répertoires de données en séparant leurs nomspar un point-virgule.

DimensionDownloadMaxSizeValeur de seuil du nombre d'éléments d'une dimension au-delà de laquelle ladimension est téléchargée et mise en mémoire cache sur le client IBM Cognos TM1.

Le paramètre DimensionDownloadMaxSize parameter est applicable à une versionantérieure de TM1. Il n'est pas applicable à la version 10.2.2.


Pour améliorer la performance lorsque vous manipulez des dimensionsvolumineuses, ajoutez le paramètre DimensionDownloadMaxSize pour que cesdimensions soient mises en cache sur le client.

DisableAdminHostEntryS'il est activé dans le fichier Tm1p.ini, le paramètre DisableAdminHostEntryempêche les utilisateurs de modifier le paramètre Hôte Admin dans la boîte dedialogue Options TM1.

Si DisableAdminHostEntry=T, l'option Hôte Admin de la boîte de dialogue OptionsTM1 est désactivée. Cela empêche un utilisateur de modifier le paramètre HôteAdmin et de voir les autres serveurs TM1 dans votre environnement. SiDisableAdminHostEntry=F ou que ce paramètre n'est pas présent dans le fichierTm1p.ini, le paramètre Hôte Admin peut être édité.

DisableAdminHostEntry doit être présent dans la version utilisateur du fichierTm1p.ini. Si le paramètre DisableAdminHostEntry est ajouté dans le fichierTm1p.ini par défaut du système, le paramètre et sa valeur sont copiés dans laversion utilisateur du fichier Tm1p.ini la première fois qu'un utilisateur démarreArchitect ou Perspectives.

Si un utilisateur démarre Architect ou Perspectives et que le paramètreDisableAdminHostEntry n'est pas présent dans la version par défaut du système dufichier Tm1p.ini, DisableAdminHostEntry=F est ajouté à la version utilisateur dufichier Tm1p.ini.

DisableWritebackOnDisconnectLorsque le paramètre DisableWritebackOnDisconnect est activé dans le fichierTm1p.ini, les cellules de feuille de calcul contenant des formules TM1 qui écriventdans le serveur TM1 restent actives et continuent à écrire tant qu'une connexionserveur active est disponible.

Cependant, lorsque ce paramètre est activé et que le client TM1 Perspectives n'estpas connecté à un serveur TM1, les cellules contenant les formules TM1 quiécrivent sur le serveur ne sont plus protégées. Dans ce cas, la saisie dans unecellule de feuille de calcul contenant une formule TM1 qui écrit sur le serveur TM1écrase la formule.

Les formules TM1 qui écrivent sur le serveur sont DBR, DBRW, DBRA, DBS, DBSA, DBSSet DBSW.

Le paramètre DisableWritebackOnDisconnect=T restaure également plusieursniveaux d'annulation et de rétablissement et plusieurs opérations copier/collerdans une feuille de calcul contenant des formules TM1 lorsqu'aucune connexionserveur n'est active.

DisableWritebackOnDisconnect à un effet similaire àDisableWritebackOnTM1Formulas. La distinction importante entre ces deuxparamètres est que DisableWritebackOnDisconnect est applicable uniquementlorsqu'aucune connexion serveur n'est active, alors queDisableWritebackOnTM1Formulas s'applique tout le temps.


DisableWritebackOnTM1FormulasLorsqu'il est activé dans le fichier Tm1p.ini, le paramètreDisableWritebackOnTM1Formula empêche l'écriture différée sur le serveur TM1lorsque vous entrez une valeur dans une cellule contenant une formule d'unefeuille de calcul TM1.

Lorsque vous définissez le paramètre DisableWritebackOnTM1Formula=T dans lefichier Tm1p.ini, la saisie d'une valeur dans une cellule de feuille de calculcontenant une formule TM1 qui écrit sur le serveur TM1 entraîne l'écrasement dela formule.

Les formules TM1 qui écrivent sur le serveur sont DBR, DBRW, DBRA, DBS, DBSA, DBSSet DBSW.

Le paramètre DisableWritebackOnTM1Formula=T restaure également plusieursniveaux d'annulation et de rétablissement et plusieurs opérations copier/collerdans une feuille de calcul contenant des formules TM1.

DisplayApplicationsIndique si le groupe Applications est visible dans l'explorateur de serveur audémarrage.v T - Le groupe Applications est visible dans l'explorateur de serveur.v F - Le groupe Applications n'apparaît pas dans l'explorateur de serveur.

DisplayChoresIndique si le groupe Tâches est visible dans l'explorateur de serveur au démarrage.v T - Le groupe Tâches est visible dans l'explorateur de serveur.v F - Le groupe Tâches n'apparaît pas dans l'explorateur de serveur.

DisplayControlCubesIndique si le groupe Cube de contrôle est visible dans l'explorateur de serveur audémarrage.v T - Le groupe ControlCube est visible dans l'explorateur de serveur.v F - Le groupe ControlCube n'apparaît pas dans l'explorateur de serveur.

DisplayCubesIndique si le groupe Cubes est visible dans l'explorateur de serveur au démarrage.v T - Le groupe Cubes est visible dans l'explorateur de serveur.v F - Le groupe Cubes n'apparaît pas dans l'explorateur de serveur.

DisplayDimensionsIndique si le groupe Dimensions est visible dans l'explorateur de serveur audémarrage.v T - Le groupe Dimensions est visible dans l'explorateur de serveur.v F - Le groupe Dimensions n'apparaît pas dans l'explorateur de serveur.

DisplayExplorerPropertiesWindowIndique si la sous-fenêtre Propriétés est affichée dans la fenêtre de l'explorateur deserveur au démarrage.v T - La sous-fenêtre Propriétés est visible.


v F (réglage par défaut) - La sous-fenêtre Propriétés n'est pas affichée.

DisplayProcessesIndique si le groupe Processus est visible dans la fenêtre de l'explorateur deserveur au démarrage.v T - Le groupe Processus est visible dans l'explorateur de serveur.v F - Le groupe Processus n'apparaît pas dans l'explorateur de serveur.

DisplayReplicationsIndique si le groupe Réplications est visible dans la fenêtre de l'explorateur deserveur au démarrage.v T - Le groupe Réplications est visible dans l'explorateur de serveur.v F - Le groupe Réplications n'apparaît pas dans l'explorateur de serveur.

ExpandRowHeaderWidthIndique si les en-têtes de ligne seront étendus automatiquement jusqu'à la largeurde la plus longue entrée de la colonne.v T (réglage par défaut) - Les en-têtes de ligne sont étendus automatiquement.v F - L'en-tête de ligne doit être étendu manuellement, si nécessaire.

ExportAdminSvrSSLCertSélectionnez cette option pour que le certificat de l'autorité de certification qui adélivré initialement le certificat du serveur Admin IBM Cognos TM1 soit exporté àpartir du magasin de certificats Microsoft Windows lors de l'exécution.v T (réglage par défaut) - Le certificat d'origine est exporté du magasin de

certificats Windows.v F - Le certificat d'origine n'est pas exporté.

Dans la boîte de dialogue Options de Cognos TM1, sélectionnez l'option Utiliser lemagasin de certificats.

Quand cette option est sélectionnée, vous devez aussi définir une valeur pour l'IDd'exportation du certificat dans la boîte de dialogue Options de Cognos TM1 oudans AdminSvrSSLExportKeyID.

InSpreadsheetBrowserIndique si le navigateur de feuille de calcul ou Cube Viewer est le navigateur pardéfaut.v T - Le Navigateur de feuille de calcul est le navigateur par défaut. Quand vous

cliquez deux fois sur un cube ou une vue, le programme l'ouvre dans undocument Excel.

v F (réglage par défaut) - Cube Viewer est le navigateur par défaut. Quand vouscliquez deux fois sur un cube ou une vue, ils s'ouvrent dans Cube Viewer.

IntegratedLoginIndique si le client IBM Cognos TM1 utilise la connexion intégrée ou la sécuritéCognos TM1 standard pour se connecter au serveur Cognos TM1 et aux autrescomposants Cognos TM1 .


v T - Le client utilise la connexion intégrée où le nom d'utilisateur et le mot depasse de connexion Microsoft Windows permettent d'accéder au serveur et auxautres composants Cognos TM1 .

v F (Par défaut) - Le client utilise la sécurité Cognos TM1 standard où un nomd'utilisateur et un mot de passe doivent explicitement être fournis lors de laconnexion au serveur et aux autres composants Cognos TM1 .

Avant d'activer ce paramètre, consultez l'administrateur Cognos TM1 pourdéterminer si la connexion intégrée est utilisée sur votre serveur Cognos TM1 .

Dans la boîte de dialogue Options de Cognos TM1, utilisez la connexion intégrée.

LanguageIndique la langue utilisée dans l'interface du client IBM Cognos TM1 .

Les clients vont tenter de lire les paramètres régionaux, et s'en serviront pourdéfinir la langue. Cette langue sera utilisée si elle correspond à l'une des languesprises en charge. Si la langue n'est pas prise en charge, l'anglais est utilisé.

Pour remplacer la valeur par défaut, vous pouvez définir la langue de façonexplicite dans le fichier tm1p.ini à l'aide des codes suivants :

Language Code


Croate hrv

Tchèque csy



Danois dan

Néerlandais nld

Allemand deu

Finnois fin

Français fra

Hongrois hun

Italien ita

Japonais jpn

Kazakh kaz

Coréen kor

Norvégien nor

Polonais pol

Roumain rom

Russe rus

Espagnol esp

Slovène vli

Suédois sve

Thaï tha

Turc trk


LocalServernetworkProtocolDétermine le protocole utilisé par le serveur IBM Cognos TM1 local pourcommuniquer avec des clients. Actuellement, le seul réglage valide est TCP.

MainWindowLayoutInfoGénère les coordonnées de dimension et de position de la fenêtre de l'explorateurde serveur et permet de conserver les dimensions et la position de la fenêtre del'explorateur de serveur entre les sessions.

Ces coordonnées sont générées automatiquement lorsque vous déplacez ouredimensionnez la fenêtre de l'explorateur de serveur.

PreviousAdminHostsIndique jusqu'à six des derniers hôtes Admin utilisés récemment dans la liste HôteAdmin de la boîte de dialogue Options d'IBM Cognos TM1.

PreviousDataDirectoriesIndique jusqu'à six des derniers répertoires de données utilisés dans la listeRépertoire de données du serveur local de la boîte de dialogue Options IBMCognos TM1.

Les répertoires auxquels vous avez accédé au cours d'une seule session sontséparés par un point-virgule Les répertoires auxquels vous avez accédé lors desessions différentes sont séparés par une virgule.

SecurityAssignmentWindowLayoutInfoGénère les coordonnées de dimension et de position de la fenêtre Clients/Groupeset permet de conserver les dimensions et la position de la fenêtre Clients/Groupesentre les sessions.

Ces coordonnées sont générées automatiquement lorsque vous déplacez ouredimensionnez la fenêtre Clients/Groupes.

SentMsgsToServerCountWarningLe paramètre SentMsgsToServerCountWarning est réservé au développement. Savaleur par défaut est F.

Ne modifiez pas la valeur par défaut.

ShowAdminHostChangeWarningCe paramètre règle l'affichage ou la suppression d'un avertissement lors duchangement de l'hôte Admin.v T (réglage par défaut)- Quand un hôte Admin est changé, un message

d'avertissement s'affiche.v F - Pas de message affiché quand un hôte Admin est changé.

ShowAliasAttributeWarningCe paramètre règle l'affichage d'affichage ou la suppression d'un avertissement lorsdu changement de l'attribut d'alias.v T (réglage par défaut) - Quand un attribut d'alias est changé un message

d'avertissement s'affiche.


v F - Pas de message affiché quand un attribut d'alias est changé.

ShowChoresSchedulingWarningCe paramètre règle l'affichage ou de suppression d'un avertissement lors duchangement d'une planification de tâche.v T (réglage par défaut) - Quand une planification de tâche est changée, un

message d'avertissement s'affiche.v F - Pas de message affiché quand une planification de tâche est changée.

ShowCubeReplicationWarningStockage entre les sessions de réglage d'affichage ou de suppression d'unavertissement lors de la réplication d'un cube.v T (réglage par défaut)- Quand un cube est répliqué un message d'avertissement

s'affiche.v F - Pas de message affiché quand un cube est répliqué.

ShowDimDeleteElementWarningStockage entre les sessions de réglage d'affichage ou de suppression d'unavertissement quand un élément de dimension est supprimé.v T (réglage par défaut)- Quand un élément de dimension est supprimé, un

message d'avertissement s'affiche.v F - Pas de message affiché quand un élément de dimension est supprimé.

ShowDimensionAccessWarningStockage entre les sessions de réglage d'affichage ou de suppression d'unavertissement lorsqu'un utilisateur accède à une dimension.v T (réglage par défaut)- Quand un utilisateur accède à une dimension, un

message d'avertissement s'affiche.v F - Pas de message affiché quand un utilisateur accède à une dimension.

ShowDynamicSubsetWarningStockage entre les sessions de réglage d'affichage ou de suppression d'unavertissement quand un sous-ensemble dynamique est modifié.v T (réglage par défaut)- Quand un sous-ensemble dynamique est modifié, un

message d'avertissement s'affiche.v F - Pas de message affiché quand un sous-ensemble dynamique est modifié.

ShowPickOperationWarningStockage entre les sessions de réglage d'affichage ou de suppression d'unavertissement quand des données sont copiées à l'aide de l'option Choisir leséléments.v T (réglage par défaut)- Un message d'erreur s'affiche chaque fois que des

données sont copiées à l'aide de l'option Choisir les éléments.v R - Aucun message d'erreur ne s'affiche quand des données sont copiées à l'aide

de l'option Choisir les éléments.

ShowProcessUNASCIIWarningStockage entre les sessions de réglage d'affichage ou de suppression d'unavertissement quand une source de données ASCII est traitée.


v T (réglage par défaut)- Quand une source de données ASCII est traitée, unmessage d'avertissement s'affiche.

v F - Pas de message affiché quand une source de données ASCII est traitée.

ShowProcessUNODBCWarningStockage entre les sessions de réglage d'affichage ou de suppression d'unavertissement quand une source de données ODBC est traitée.v T (réglage par défaut)- Chaque fois qu'une source de données ODBC est traitée,

un message d'avertissement s'affiche.v F - Pas de message affiché quand une source de données ODBC est traitée.

SliceNewWorkbookCe paramètre contrôle la création des tranches dans Cube Viewer.v T - Les tranches sont insérées dans un nouveau classeur.v F (réglage par défaut) - Les tranches sont insérées dans une nouvelle feuille du

classeur courant.

SubsetWindowLayoutInfoGénère les coordonnées de dimension et de position pour la fenêtre de l'éditeur dedimension et permet de conserver les dimensions et la position de la fenêtre entreles sessions.

Ces coordonnées sont générées automatiquement lorsque vous déplacez ouredimensionnez la fenêtre de l'éditeur de sous-ensemble.

TM1RebuildDefaultCe paramètre détermine si les feuilles de calcul sont recalculées par défaut àl'ouverture des classeurs.

Par défaut, lorsqu'une tranche est créée dans une vue Microsoft Excel depuis IBMIBM Cognos TM1, le classeur contient une variable classeur nommée,TM1RebuildOption, dont la valeur par défaut est 1. Elle provoque la régénérationdes feuilles du livre à l'ouverture, ce qui force le recalcul de toutes les feuilles.Cette opération est nécessaire si les feuilles contiennent des formulaires actifs. Sivous n'utilisez pas de formulaires actifs, vous ne souhaitez peut-être pas appliquerce comportement par défaut à tous les classeurs.

A l'ouverture d'un classeur Cognos TM1, toutes les feuilles sont recalculées. Leclasseur a été créé par le découpage de tranches dans Cognos TM1 Perspectives etcontient la variable classeur nommée TM1RebuildOption = 1.

Par défaut, à partir de Cognos TM1 9.4.1, tous les nouveaux classeurs créés par ledécoupage de tranches contiennent la variable classeur nomméeTM1RebuildOption=1. Elle provoque la régénération du classeur à l'ouverture, etdonc le recalcul de toutes les feuilles. Ce comportement est nécessaire pour lesformulaires actifs, mais n'est pas forcément souhaitable si vos feuilles de calculn'en contiennent pas.

Pour éviter l'application du comportement par défaut consistant à toujoursrégénérer les feuilles en cas de découpage de tranches, remplacez la valeur T de lavariable TM1RebuildDefault par F (ou ajoutez TM1RebuildDefault=F si la variableest absente) dans le fichier tm1p.ini. Lorsque TM1RebuildDefault=F, les classeursdéfinissent la variable nommée de niveau classeur TM1RebuildOption=0 au moment


du découpage de tranches. Le comportement de Cognos TM1 antérieur àl'introduction des formulaires actifs est rétabli.

Si cette option a la valeur ou n'est pas définie, le découpage de tranches dans unevue Cognos TM1 Perspectives affecte la valeur 1 à la variable classeur nomméeTM1RebuildOption, ce qui force la régénération du classeur à l'ouverture. Sil'option a la valeur F, la variable nommée TM1RebuildOption prend la valeur 0,qui n'engendre pas de régénération. Il est possible d'affecter la valeur 1 à la placede la valeur par défaut 0 pour un rapport spécifique, par exemple pour unformulaire actif.

Par défaut, le paramètre TM1RebuildDefault n'est pas défini dans une nouvelleinstallation, ce qui génère le comportement par défaut en cas de découpage avecTM1RebuildOption=1.


Annexe C. Définitions d'installations et de configurationssans surveillance

Définissez une installation et une configuration sans surveillance pour installer uneconfiguration identique sur plusieurs ordinateurs de votre réseau, ou pourautomatiser le processus d'installation et de configuration en définissant desoptions et des paramètres personnalisés pour les utilisateurs.

Avant d'exécuter une installation et une configuration sans surveillance,assurez-vous que la configuration système requise soit entièrement respectée et quetous les produits tiers soient dûment installés et configurés.

Procédure1. Configurez un fichier de spécification de transfert (.ats) contenant les options

d'installation.2. Exécutez l'outil d'installation en mode silencieux.3. Utilisez un fichier de configuration pré-configuré provenant d'un autre

ordinateur.4. Exécutez l'outil de configuration en mode silencieux.

Installations sans surveillanceUtilisez un fichier de spécification de transfert (.ats) pour copier les composantsd'IBM Cognos sur votre ordinateur sans que le système vous demande de saisirdes informations.

Par défaut, chaque fois que vous installez des composants d'IBM Cognos à l'aidede l'assistant d'installation, les options que vous sélectionnez sont enregistrées dansun fichier de spécification de transfert. Par conséquent, si vous avez déjà installédes composants d'IBM Cognos sur un ordinateur, vous pouvez utiliser le fichier despécification de transfert créé par l'installation comme modèle pour desinstallations sans surveillance sur d'autres ordinateurs.

Si vous n'utilisez pas l'assistant d'installation pour installer des composants, vouspouvez utiliser le fichier de spécification de transfert par défaut nomméresponse.ats, disponible sur le CD. Vous devez modifier le fichier response.ats enfonction de votre environnement avant de l'utiliser pour une installationautomatique.

Pour contrôler le bon déroulement de l'installation automatique, vérifiez le statutrenvoyé. Une valeur nulle (0) indique que l'installation s'est effectuée correctement.Toute autre valeur indique qu'une erreur s'est produite.

Définition d'une installation sans surveillanceUtilisez les codes produit TM1 ci-après pour une installation sans surveillance.

Procédure

Suivez les instructions de la rubrique Use a response file from an installation onanother computer (http://www.ibm.com/support/knowledgecenter/


http://www.ibm.com/support/knowledgecenter/SSEP7J_10.2.2/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.2.doc/t_c8bi_setupunattendedinstallation.html

http://www.ibm.com/support/knowledgecenter/SSEP7J_10.2.2/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.2.doc/t_c8bi_setupunattendedinstallation.html

SSEP7J_10.2.2/com.ibm.swg.ba.cognos.inst_cr_winux.10.2.2.doc/t_c8bi_setupunattendedinstallation.html) en remplaçant les codes produit par lescodes TM1 ci-après.

Tableau 38. Codes produit TM1 pour une installation sans surveillance.

Code produit Produit

TM1APPTIER_APP=1 TM1 Data Tier

TM1SERVER_APP=1 TM1 Server

TM1ADMINSERVER_APP=1 TM1 Admin Server

TM1TOOLS_APP=1 TM1 Tools

TM1WEBAPPTIER_APP=1 TM1 Web Tier

TM1CONTRIBGATEWAY_APP=1 TM1 Applications Gateway

TM1CONTRIBSERVICE_APP=1 TM1 Application Server

TM1WEB_APP=1 TM1 Web

TM1OPERATIONSCONSOLE_APP=1 TM1 Operations Console

TM1CLIENTTIER_APP=1 TM1 Rich Tier

TM1PERSPECTIVES_APP=1 TM1 Perspectives

TM1COGNOSINSIGHT_APP=1 Cognos Insight

TM1APIS_APP=1 TM1 API

TM1DEVTIER_APP=1 TM1 Rich Tier

TM1ARCHITECT_APP=1 TM1 Architect

TM1PERFMOD_APP=1 TM1 Performance Modeler

TM1SAMPLETIER_APP=1 TM1 Samples

Le contenu de ce fichier est visualisable dans le fichier .ats du répertoirerépertoire_TM1/instlog.

Définition d'une configuration sans surveillanceAvant d'exécuter une configuration sans surveillance, vous devez exporter uneconfiguration à partir d'un autre ordinateur, sur lequel sont installés les mêmescomposants IBM Cognos TM1. Vous pouvez ensuite exécuter IBM CognosConfiguration en mode silencieux.

La configuration exportée contient les propriétés des composants Cognos TM1 quevous avez installés sur l'ordinateur source. Si vous avez modifié la configurationglobale, vous devez également copier le fichier de configuration globale del'ordinateur source sur l'ordinateur sur lequel vous prévoyez d'exécuter uneconfiguration sans surveillance.

Avant de commencer

Assurez-vous que les paramètres de configuration sur l'ordinateur local sontappropriés pour configurer un autre ordinateur sur lequel les mêmes composantssont installés.

Procédure1. Dans IBM Cognos Configuration, dans le menu Fichier, cliquez sur Exporter en

tant que.


2. Si vous voulez exporter la configuration actuelle vers un autre dossier, dans lazone Rechercher dans, localisez et ouvrez le dossier.

3. Dans la zone Nom de fichier, saisissez un nom pour le fichier de configuration.4. Cliquez sur Enregistrer.5. Copiez le fichier de configuration exporté de l'ordinateur source ou de

l'emplacement de réseau vers le répertoire répertoire TM1/configuration del'ordinateur sur lequel vous prévoyez d'effectuer la configuration sanssurveillance.

6. Renommez le fichier cogstartup.xml.7. Si vous avez modifié la configuration globale sur l'ordinateur source, copiez le

fichier coglocale.xml de l'ordinateur source dans le répertoire répertoireTM1/logs de l'ordinateur sur lequel vous prévoyez d'effectuer la configurationsans surveillance.

8. Accédez au répertoire répertoire TM1/bin.9. Saisissez la commande de configuration :

cogconfig.bat -s

Pour consulter les messages de journal générés au cours d'une configurationsans surveillance, ouvrez le fichier cogconfig_response.csv situé dans lerépertoire répertoire TM1/logs.

Résultats

Pour contrôler le bon déroulement de la configuration automatique, vérifiez lestatut renvoyé. Une valeur nulle (0) indique que l'installation s'est effectuéecorrectement. Toute autre valeur indique qu'une erreur s'est produite.

Cognos Configuration applique les paramètres de configuration définis dans lacopie locale du fichier cogstartup.xml, chiffre les données d'identification, crée descertificats numériques et, le cas échéant, démarre le service ou le processus IBMCognos.

Définition d'une désinstallation sans surveillanceDéfinissez une désinstallation sans surveillance pour automatiser la suppressiondes composants sur plusieurs ordinateurs ayant les mêmes composants ou poursupprimer des composants dans un environnement UNIX ou Linux ne disposantpas de Microsoft XWindows.

Procédure1. Accédez au répertoire répertoire TM1/instlog.2. Ouvrez le fichier .ats de spécification de transfert pour le produit dans un

éditeur de texte.Le format de nom du fichier .ats de spécification de transfert est ts-codeproduit-version-aaaammjj_hhmm.ats.Voir la liste des codes produit de TM1 à la rubrique «Définition d'uneinstallation sans surveillance», à la page 389.Il vous suffit d'éditer un seul fichier .ats par produit.

3. Dans la section nommée [Component List], spécifiez les composants àsupprimer.v Pour supprimer le composant, saisissez 1

v Pour ne pas désinstaller le composant, saisissez 0

Annexe C. Définitions d'installations et de configurations sans surveillance 391

Par défaut, tous les composants installés sont configurés pour la suppression.4. Enregistrez et fermez le fichier.5. Répétez les étapes 2 à 4 pour produit installé.6. Depuis la ligne de commande, accédez au répertoire répertoire

TM1/uninstall.7. A l'invite de commande, saisissez :v Sous Windows,

uninst -u -s

v Sur UNIX ou Linux,./uninst -u -s

v Sous UNIX ou Linux sans XWindows,./uninstnx -u -s


Annexe D. Traitement des incidents

Le traitement des incidents est une méthode systématique de résolution desproblèmes. Son objectif consiste à déterminer pour quelle raison un élément nefonctionne pas comme prévu et comment résoudre l'incident.

Les réponses aux questions suivantes peuvent vous aider à identifier la source d'unproblème lié à un produit IBM Cognos :1. La configuration est-elle prise en charge ?2. Que faites-vous au moment où le problème se produit ?v Des activités de planificationv L'installation du produitv La mise à niveau ou la migration du produitv Des tâches d'administration ou de configuration du systèmev Du développement d'applicationv Le lancement ou le déploiement du produitv L'exécution du produitv L'installation ou la modification des matériels ou des logiciels associésv La récupération ou le redémarrage du produit ou du systèmev Le diagnostic d'un problème ou l'exécution de l'aide au diagnostic

3. Le problème est-il lié au logiciel IBM Cognos ? Si oui, des messages ou descodes d'erreur ont-il été émis, et lesquels ?

4. Pouvez-vous reproduire le problème afin de vérifier qu'il ne s'agit pas d'unesimple erreur ?

5. Avez-vous vérifié les emplacements, les répertoires, les chemins et les droitsd'accès aux fichiers ?

6. Avez-vous examiné tous les documents pertinents, y compris les notes surl'édition et des notes techniques ?

7. Avez-vous vérifié que le problème n'était pas lié à des changements récentsdans votre environnement informatique ?

8. Si ces questions et réponses ne vous permettent pas de trouver la solution,vous avez peut-être besoin de collecter des informations supplémentaires oudes données de diagnostic. Ces données sont nécessaires à un interlocuteur duservice d'assistance IBM pour qu'il puisse vous aider efficacement à identifier età résoudre le problème.

IBM Knowledge CenterIBM Knowledge Center contient la documentation de chaque édition. Ladocumentation est également disponible via les menus d'aide du produit.

Pour rechercher la documentation produit sur le Web, y compris tous lesdocuments traduits, accédez à IBM Knowledge Center (http://www.ibm.com/support/knowledgecenter).

Pour trouver des liens vers les derniers problèmes connus et les rapports officielsd'analyse de programme (APAR), accédez aux Notes sur l'édition.


http://www.ibm.com/support/knowledgecenter/

Support PortalIBM Support Portal est une vue unifiée et centralisée de tous les outils de supporttechnique et de toutes les informations relatifs aux systèmes, logiciels et servicesIBM.

IBM Support Portal vous permet d'accéder à toutes les ressources IBM de supportdepuis le même emplacement. Vous pouvez personnaliser les pages pour mettrel'accent sur les informations et ressources dont vous avez besoin pour laprévention des problèmes et une résolution plus rapide. .

Trouvez le contenu Cognos dont vous avez besoin en sélectionnant les produitsdans IBM Support Portal.

Collecte des informationsAvant de contacter le support IBM, vous devrez collecter les données de diagnostic(informations système, symptômes, fichiers journaux, traces, etc.) qui sontnécessaires pour résoudre un problème. La collecte de ces informations vouspermettra de vous familiariser avec le processus de traitement des incidents etvous fera gagner du temps.

Les informations sur les données à collecter sont disponibles sous la forme denotes techniques MustGather.

Demandes de serviceLes demandes de service sont également appelées PMR (Problem ManagementReports). Il existe plusieurs méthodes pour soumettre des informations dediagnostic au service de support logiciel d'IBM.

Pour ouvrir une PMR ou pour échanger des informations avec le supporttechnique, consultez la page Enhanced Customer Data Repository. Les PMRpeuvent également être soumises directement à l'aide de l'outil dédié auxdemandes de service (PMR), ou de l'une des autres méthodes détaillées surla page d'informations relative aux échanges.

Support Assistant LiteIBM Support Assistant est une offre logicielle gratuite constituée d'un plan detravail dédié à l'identification des problèmes.

Actuellement, IBM prend en charge IBM Support Assistant Lite. Cet utilitaireautomatise la collecte des données spécifiques du produit. Il identifie les fichiers dedonnées dont les analystes du support IBM ont besoin pour identifier et résoudreles problèmes opérationnels occasionnellement liés aux produits IBM.

Fix CentralLe site Fix Central contient des correctifs et des mises à jour pour les logiciels, lesmatériels et les systèmes d'exploitation.

Utilisez le menu déroulant pour naviguer jusqu'aux correctifs destinés à vosproduits sur la page Fix Central. Vous pouvez également consulter l'aide de FixCentral.


http://www.ibm.com/support/entry/portal/

http://www-01.ibm.com/software/data/support/cognos_mustgather.html

http://www-01.ibm.com/software/support/exchangeinfo.html

http://www-947.ibm.com/support/entry/portal/Open_service_request/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management

http://www-947.ibm.com/support/entry/portal/Open_service_request/Software/Information_Management/Cognos_Business_Intelligence_and_Financial_Performance_Management


http://www-933.ibm.com/support/fixcentral/

https://www-945.ibm.com/support/fixcentral/help?page=start

https://www-945.ibm.com/support/fixcentral/help?page=start

Communauté IBM Planning AnalyticsLa communauté IBM Planning Analytics offre un espace de partage d'idées et desolutions avec vos homologues.

Visitez la communauté IBM Planning Analytics à l'adresse https://www.ibm.com/communities/analytics/planning-analytics/.

Flux RSS du support logicielLes flux RSS du support logiciel IBM constituent un format rapide, simple et légerpour superviser les nouveaux contenus ajoutés aux sites Web.

Après avoir téléchargé un lecteur de flux RSS ou un plug-in de navigateur, vouspouvez vous abonner à des flux sur les produits IBM à la page IBM SoftwareSupport RSS.

Recherche et navigation dans les produits IBML'accès aux informations sur les produits IBM est désormais configurable dans leportail du support IBM, qui vous permet d'afficher tous vos liens sur unemême page.

Annexe D. Traitement des incidents 395

https://www.ibm.com/communities/analytics/planning-analytics/

https://www.ibm.com/communities/analytics/planning-analytics/

https://www-01.ibm.com/software/support/rss/

https://www-01.ibm.com/software/support/rss/

Remarques

Le présent document a été mis au point pour les produits et services proposésdans le monde entier.

Il peut être mis à disposition par IBM dans d'autres langues. Toutefois, il peut êtrenécessaire de posséder une copie du produit ou de la version du produit danscette langue pour pouvoir y accéder.

Dans les autres pays, ces logiciels ou services IBM ne sont pas annoncés. Pour plusde détails, référez-vous aux documents d'annonce disponibles dans votre pays, ouadressez-vous à votre partenaire commercial IBM. Toute référence à un produit,logiciel ou service IBM n'implique pas que seul ce produit, logiciel ou servicepuisse être utilisé. Tout autre élément fonctionnellement équivalent peut êtreutilisé, s'il n'enfreint aucun droit d'IBM. Il est de la responsabilité de l'utilisateurd'évaluer et de vérifier lui-même les installations et applications réalisées avec desproduits, logiciels ou services non expressément référencés par IBM. Ce documentpeut décrire des produits, des services ou des fonctions qui ne sont pas couvertspar l'autorisation de licence ou ne font pas partie du logiciel que vous avez acquis.

IBM peut détenir des brevets ou des demandes de brevet couvrant les produitsmentionnés dans le présent document. La remise de ce document ne vous donneaucun droit de licence sur ces brevets ou demandes de brevet. Si vous désirezrecevoir des informations concernant l'acquisition de licences, veuillez en faire lademande par écrit à l'adresse suivante :

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

Pour le Canada, veuillez adresser votre courrier à :

IBM Director of Commercial RelationsIBM Canada Ltd.3600 Steeles Avenue EastMarkham, OntarioL3R 9Z7Canada

Les informations sur les licences concernant les produits utilisant un jeu decaractères double octet peuvent être obtenues par écrit à l'adresse suivante :

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.19-21, Nihonbashi-Hakozakicho, Chuo-kuTokyo 103-8510, Japon

Le paragraphe suivant ne s'applique ni au Royaume-Uni, ni dans aucun pays danslequel il serait contraire aux lois locales : LE PRESENT DOCUMENT EST LIVREEN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM


DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CESINFORMATIONS EN CAS DE CONTREFACON AINSI QU'EN CAS DE DEFAUTD'APTITUDE A L'EXECUTION D'UN TRAVAIL DONNE. Certaines juridictionsn'autorisent pas l'exclusion des garanties implicites, auquel cas l'exclusion ci-dessusne vous sera pas applicable.

Le présent document peut contenir des inexactitudes ou des coquilles. Cedocument est mis à jour périodiquement. Chaque nouvelle édition inclut les misesà jour. IBM peut, à tout moment et sans préavis, modifier les produits et logicielsdécrits dans ce document.

Les références à des sites Web non IBM sont fournies à titre d'informationuniquement et n'impliquent en aucun cas une adhésion aux données qu'ilscontiennent. Les éléments figurant sur ces sites Web ne font pas partie deséléments du présent produit IBM et l'utilisation de ces sites relève de votre seuleresponsabilité.

IBM pourra utiliser ou diffuser, de toute manière qu'elle jugera appropriée et sansaucune obligation de sa part, tout ou partie des informations qui lui serontfournies.

Les licenciés souhaitant obtenir des informations permettant : (i) l'échange desdonnées entre des logiciels créés de façon indépendante et d'autres logiciels (dontcelui-ci), et (ii) l'utilisation mutuelle des données ainsi échangées, doivent adresserleur demande à :

IBM Software GroupAttention: Licensing3755 Riverside Dr.Ottawa, ONK1V 1B7Canada

Ces informations peuvent être soumises à des conditions particulières, prévoyantnotamment le paiement d'une redevance.

Le logiciel sous licence décrit dans ce document et tous les éléments sous licencedisponibles s'y rapportant sont fournis par IBM conformément aux dispositions del'ICA, des Conditions internationales d'utilisation des logiciels IBM ou de toutautre accord équivalent. .

Les données de performance indiquées dans ce document ont été déterminées dansun environnement contrôlé. Par conséquent, les résultats peuvent varier de manièresignificative selon l'environnement d'exploitation utilisé. Certaines mesuresévaluées sur des systèmes en cours de développement ne sont pas garanties surtous les systèmes disponibles. En outre, elles peuvent résulter d'extrapolations. Lesrésultats peuvent donc varier. Il incombe aux utilisateurs de ce document devérifier si ces données sont applicables à leur environnement d'exploitation.

Les informations concernant des produits non IBM ont été obtenues auprès desfournisseurs de ces produits, par l'intermédiaire d'annonces publiques ou viad'autres sources disponibles. IBM n'a pas testé ces produits et ne peut confirmerl'exactitude de leurs performances ni leur compatibilité. Elle ne peut recevoiraucune réclamation concernant des produits non IBM. Toute question concernantles performances de produits non IBM doit être adressée aux fournisseurs de cesproduits.


Toute instruction relative aux intentions d'IBM pour ses opérations à venir estsusceptible d'être modifiée ou annulée sans préavis, et doit être considéréeuniquement comme un objectif.

Le présent document peut contenir des exemples de données et de rapports utiliséscouramment dans l'environnement professionnel. Ces exemples mentionnent desnoms fictifs de personnes, de sociétés, de marques ou de produits à des finsillustratives ou explicatives uniquement. Toute ressemblance avec des noms depersonnes, de sociétés ou des données réelles serait purement fortuite.

Si vous visualisez ces informations en ligne, il se peut que les photographies etillustrations en couleur n'apparaissent pas à l'écran.

Cette Offre Logiciels n'utilise pas de cookies ou d'autres techniques pour collecterdes informations personnelles identifiables.

Marques

IBM, le logo IBM et ibm.com sont des marques d'International Business MachinesCorp. dans de nombreux pays. Les autres noms de produits et de services peuventêtre des marques d'IBM ou d'autres sociétés. La liste actualisée de toutes lesmarques d'IBM est disponible sur la page Web « Copyright and trademarkinformation » à l'adresse suivante : www.ibm.com/legal/copytrade.shtml.

Les termes qui suivent sont des marques d'autres sociétés :v Adobe, le logo Adobe, PostScript et le logo PostScript sont des marques d'Adobe

Systems Incorporated aux Etats-Unis et/ou dans d'autres pays.v Microsoft, Windows, Windows NT et le logo Windows sont des marques de

Microsoft Corporation aux Etats-Unis et/ou dans d'autres pays.v Linux est une marque de Linus Torvalds aux Etats-Unis et/ou dans certains

autres pays.v UNIX est une marque enregistrée de The Open Group aux Etats-Unis et/ou

dans certains autres pays.v Java ainsi que tous les logos et toutes les marques incluant Java sont des

marques d'Oracle et/ou de ses sociétés affiliées.

Les captures d'écran des produits Microsoft sont utilisées avec l'autorisation deMicrosoft.

Remarques 399

http://www.ibm.com/legal/copytrade.shtml

http://www.ibm.com/legal/copytrade.shtml

Index

Caractères spéciaux.cfg, fichier 26, 311.ini, fichier 26, 377.NET Framework 14, 194, 195, 196

traitement des incidents 202version 201

.rej, fichier 23

Nombres32 bits 3364 bits 33

Aaccès

configuration requise pour installer Planning Analytics forMicrosoft Excel 198

configuration requise pour utiliser Planning Analytics forMicrosoft Excel 199

privilèges, répertoire de données 26activation des macros 70activer Business Viewpoint 140activer la publication depuis Cognos Insight 140AdminHost 313, 378AdminHost, paramètre

SSL 277administration

tm1web_config.xml 113AdminSvrSSLCertAuthority 277, 378AdminSvrSSLCertID 277, 379AdminSvrSSLCertRevList 277, 379AdminSvrSSLExportKeyID 277, 379adresse IP 335AdvancedRulesEditor 379affectations de groupe 256ajout d'un serveur 90ajout et suppression de programmes 49AllowImportCamClients 379AllowImportCAMClients 264AllowReadOnlyChoreReschedule 313AllowSeparateNandCRules 71, 313AllRuleCalcStargateOptimization 314analystes financiers

rôle 191analystes métier

rôle 191Apache Tomcat

annulation du déploiement 304API TM1

installation 188application Web 31ApplyMaximumViewSizeToEntireTransaction 315arborescence de navigation

noeud Vues 128Architect 25Architect, mise à niveau 51architecture 21, 163architecture Web 27arrêt de TM1 Contributor 47

arrêt des services 47, 302assemblages d'interopérabilité de base

Voir assemblages d'interopérabilité de base (PIA)assemblages d'interopérabilité de base (PIA) 201

installation 195assistant d'installation 198AuditLogMaxFileSize 315AuditLogMaxQueryMemory 315AuditLogOn 316AuditLogUpdateInterval 316authentication modes 163authentification 226, 228, 257

connexion intégrée 226diagramme de connexion intégrée 227importation de groupes dans TM1 263

authentification Cognos 228, 257définition d'un administrateur 261

authentification LDAP 226, 251, 257configuration de la validation 256ETLDAP 256modification des affectations de groupe 256paramètres 251TM1S.cfg 256validation d'utilisateurs 251

AutomaticallyAddCubeDependencies 316autoriser la mise à disposition des installations 140autoriser la mise à disposition des mises à jour 140autorité de certification (CA)

ne parvient pas à créer une relation d'approbation 205avec la sécurité Cognos 263

Bbase de données d'exemple GOSALES 214base de données OLE TM1 10bases de données d'exemple installées 212boîte de dialogue LDAP Load Tool (outil de chargement

LDAP) 231BrowseDisplayReadsRightToLeft 380

CCacheFriendlyMalloc 317CalculationThresholdFor Storage 317CAM authentication 164CAMID 228, 257CAMPortalVariableFile 317CAMUseSSL 318caractères ASCII dans le nom des répertoires 68caractères non ASCII et transfert 85certificat 289

autorité 274magasin 274révocation 274

CertificateVersion 277certificats 273, 289, 290certificats de sécurité 169CheckFeedersMaximumCells 318chemin d'accès aux classes 99chemin du répertoire de données 25


chemins qualifiés imposés 140chiffrer 274ClassicSliceMode 380clé d'identité 274clé privée 274ClientCAMURI 318ClientExportSSLSvrCert 277, 319ClientExportSSLSvrKeyID 277, 319ClientMessagePortNumber 319ClientPingCAMPassport 319ClientPropertiesSyncInterval 320clients 22, 25clients non-SSL 274clients Web 30ClientVersionMaximum 320ClientVersionMinimum 321ClientVersionPrecision 321codage des caractères 85codes de langue 86, 87codes produit 389Cognos Configuration 68, 78, 140Cognos Connection 69Cognos Insight 68

exécution 73installation 73, 184journalisation 188

Cognos Planning 3Cognos Query Studio 63Cognos Report Studio 63Cognos TM1 Applications

présentation de l'architecture 29Cognos TM1 Operations Console 99Cognos TM1 Performance Modeler

installation 180journalisation 183

Cognos Workspace 64CognosGatewayURI 264, 380CognosMDX.AggregateByAncestorRef 322CognosMDX.CellCacheEnable 323CognosMDX.PrefilterWithPXJ 323CognosMDX.SimpleCellsUseOPTSDK 323CognosMDX.UseProviderCrossJoinThreshold 324CognosOfficeBI.xll 200CognosOfficeTM1.xll 200CognosTM1InterfacePath 324commandes système 64 bits 99composant du niveau de données 5composants 67composants client 5composants du niveau Web TM1 7composants serveur 5composants supplémentaires 297composants TM1 5compte de service TM1 18conditions requises pour TM1 Package Connector 59configuration 17, 69, 78Configuration

TM1 166configuration de la langue 86, 88, 89configuration de la validation 256configuration des composants 82configuration requise 14

pour installer Planning Analytics for Microsoft Excel 196,198, 199

pour mettre à niveau Planning Analytics for MicrosoftExcel 44

pour utiliser IBM Cognos Analysis for Microsoft Excel 199

configurer la page de connexion 120connectivité SAP 61ConnectLocalAtStartup 380connexion 105connexion à un serveur 236connexion de réplication 272connexion intégrée 226, 227, 249, 251, 384

}ClientProperties, cube 239Architect 250configuration manuelle 242droits d'accès 241paramétrage 240présentation 239TM1 Perspectives 250UniqueID, zone 239

connexionsajout 197

conversion en .xls 55conversion en formules

erreurs 201, 204CreateNewCAMClients 324Cube Viewer

taille de page 129Cube Viewer, exporter des feuilles 129CubeviewerStringWrap 129

DDataBaseDirectory 325, 380déchiffrer 274DefaultMeasuresDimension 325délai d'expiration de session (en minutes) 140démarrage

serveur Cognos TM1 Applications 137services 69, 78

démarrage d'IBM Cognos Configuration 82Dépannage 393déploiement 31

TM1 Application Server 149TM1 Applications Web 111TM1 Operations Console 98, 100, 101, 103, 104TM1 Web 110, 111

désinstallation 299, 301, 391IBM Cognos Analysis for Microsoft Excel 196Planning Analytics for Microsoft Excel 199

DHFile-1024 277DHFile-2048 277DHFile-512 277diagramme de l'authentification LDAP 228Diffie-Hellman 274DimensionDownloadMaxSize 380DisableMemoryCache 325DisableSandboxing 326Display_Info_DBType_R8 326DisplayApplications 382DisplayChores 382DisplayControlCubes 382DisplayCubes 382DisplayDimensions 382DisplayExplorerPropertiesWindow 382DisplayProcesses 383DisplayReplications 383DistributedPlanningOutputDir 71, 327Docker 165documentation traduite 10documents publiés

ouverture dans Microsoft Office 201


domainescompte 35installation sans 19

données d'échantillon 198données d'identification pour la connexion 71DownTime 327

Eéléments de requête

LDAP 235emplacements 14EnableNewHierarchyCreation 328EnableTIDebugging 328enregistrement des données 23erreur de chaînage de certificats Java 169erreur DPR-ERR-2079 203ETLDAP

attribut d'enregistrement LDAP modifié 238bouton Export (Exporter) 231bouton Search (Rechercher) 231configuration des paramètres de connexion LDAP 233connexion à un serveur 236création d'une requête LDAP 235éléments de requête LDAP 235exécution depuis DOS 231exécution en mode Mise à jour 238exportation d'utilisateurs LDAP vers TM1 238mappage des attributs LDAP sur des zones TM1 237mise à jour de TM1 avec les nouveaux utilisateurs

LDAP 238modification d'attributs LDAP 230option Search Scope (Portée de la recherche) 231options d'exportation 237tableau des résultats 231zone Attributes (Attributs) 231zone Filter (Filtre) 231zone Search DN (Nom distinct de recherche) 231

ETLDAP, authentification LDAP 256ExcelWebPublishEnabled 328, 371exécution en tant qu'administrateur 68exemple Planning

démarrage 78exemples 211ExpandRowHeaderWidth 383ExportAdminSvrSSLCert 277, 383exportation des données au format PDF 75, 189exporter

nombre maximal de feuilles 129ExportSvrSSLCert 277extension COM

fermeture inattendue d'un classeur Excel 202extension de fichier .blb 24extension de fichier .cho 24extension de fichier .cub 24extension de fichier .dim 24extension de fichier .dit 24extension de fichier .pro 24extension de fichier .rux 24extension de fichier .sub 24extension de fichier .tbu 24extension de fichier .tqu 24extension de fichier .tru 24extension de fichier .vue 24extension de fichier .xdi 24extension de fichier .xru 24extensions de fichier 24

FFederal Information Processing Standards (FIPS) 330fenêtre de commande DOS 231feuille de calcul .xlsx 55feuilles Web 73fichier d'initialisation 26, 377fichier journal de transactions 23fichier response.ats 389fichiers de configuration 18FileRetry.Count 329FileRetry.Delay 329FileRetry.FileSpec 329FIPSOperationMode 330Firefox 249fonctions d'accessibilité 309fonctions TurboIntegrator 160

restriction de l'exécution 161fournisseur de notifications 140fréquence de ping de Cognos Insight (secondes) 140

Ggestion de l'installation 297GO_Contributor 213GO_New_Stores

démarrage 69, 78guillemets 312

HHTTPPortNumber 331HTTPSessionTimeoutMinutes 332

IIBM AIX

commandes non prises en charge avec TM1 84exécution de TM1 avec 83limites de ressources mémoire 83optimisation des performances 83

IBM Cognos for Microsoft Officerejet du pare-feu de sécurité 203

IBM Cognos Office Reporting TM1, macrocomplémentaire 200

IBM Cognos Officeapplications Microsoft Office prises en charge 205échec de l'initialisation dans Microsoft Office 201messages d'erreur numérotés 205problèmes de sécurité 204traitement des incidents liés à l'ouverture de documents

publiés 201IBM Planning Analytics for Microsoft Excel

messages d'erreur numérotés 207ID utilisateur et mot de passe 140IdleConnectionTimeOutSeconds 332imprimante par défaut 75, 189IndexStoreDirectory 332Insight

fonctions TurboIntegrator, restrictions 160InSpreadsheetBrowser 383installation 14, 223

IBM Cognos Analytics 389IBM Planning Analytics for Microsoft Excel for Microsoft

Excel 193installation automatique 389

Index 403

installation (suite)Microsoft .NET Framework 194Microsoft windows 168utilisation de fichiers de spécification de transfert

(.ats) 389installation client 3, 175installation de TM1 Applications 31installation de TM1 Operations Console sur une machine

séparée 98installation des clients TM1 175installation du serveur TM1 sous Linux 80installation du serveur TM1 sous Unix 80installation du serveur TM1 sous Windows 77installation Linux 3installation multiposte 78installation overview 164installation répartie 34installation sans surveillance 389, 391installation silencieuse 389installation UNIX 3installation Web multiposte 108installation Windows 32 bits 3installation Windows 64 bits 3installations

extension COM 201installing

Docker 165Planning Analytics Workspace 165

IntegratedSecurityMode 332intégration à TM1 57intégrée, connexion 239interaction parallèle

paramètre JobQueueThreadPoolSize 337Internet Explorer 249interopérabilité 317interopérabilité de TM1 57intervalle 22introduction xvIPAddressV4 334IPAddressV6 334iWidgets 64, 317iWidgets TM1 317

JJava 38

SSL 288JavaClassPath 336JavaJVMArgs 336JavaJVMPath 336JobQueueMaxWaitTime 337JobQueueThreadPoolSize 337JobQueueThreadSleepTime 338journal

fichier 23

KKerberos 363keyfile 338keylabel 338keystashfile 338

LLanguage 339langue 35langue des clients 384langues

traitement des incidents liés aux sous-clés de module 202LDAP

attribut d'enregistrement modifié 238authentification 226, 228configuration des paramètres de connexion 233création d'une requête 235exécution d'ETLDAP en mode Mise à jour 238exportation d'utilisateurs vers TM1 238mappage d'attributs sur des zones TM1 237mise à jour de TM1 avec les nouveaux utilisateurs 238modification d'attributs 230

LDAPHost 251, 252, 339LDAPPasswordFile 251, 252, 340LDAPPasswordKeyFile 251, 252, 340LDAPPort 251, 252, 340LDAPSearchBase 251, 253, 340LDAPSearchField 251, 253, 340LDAPSkipSSLCertVerification 251, 253, 341LDAPSkipSSLCRLVerification 251, 253, 257, 341LDAPUseServerAccount 251, 254, 341LDAPVerifyCertServerName 251, 254, 257, 341LDAPVerifyServerSSLCert 251, 254, 257, 342LDAPWellKnownUserName 251, 255, 343Les numéros de ports 14limitation 29Linux 165, 171

démarrage d'un serveur TM1 83installation 81installation du serveur TM1 80

LoadPrivateSubsetsOnStartup 343LocalServernetworkProtocol 385LockPagesInMemory 343log files 171LoggingDirectory 344logiciel client

installation 198mise à niveau 44

logiciels et matériel 14logiciels prérequis 67LogReleaseLineCount 344

Mmacros complémentaires, enregistrement 200MagnitudeDifferenceToBeZero 344MainWindowLayoutInfo 385MaskUserNameInServerTools 345MaximumCubeLoadThreads 345MaximumLoginAttempts 346MaximumMemoryForSubsetUndo 346MaximumSynchAttempts 348MaximumTILockObject 348MaximumUserSandboxSize 349MaximumViewSize 349MDXSelectCalculatedMemberInputs 349MessageCompression 351messages d'erreur

Aucune valeur affichée lors d'une conversion enformules 201

COI-ERR-2002 Type de bloc non valide 205


messages d'erreur (suite)COI-ERR-2005 Cette version de Microsoft Office n'est pas

prise en charge. 205COI-ERR-2006 Ce produit Microsoft Office n'est pas pris en

charge 206COI-ERR-2008 Extraction à partir des ressources

impossible 206COI-ERR-2009 Impossible d'effectuer cette opération, car

Microsoft Excel est en mode d'édition 206COI-ERR-2010 Le nom {0} n'est pas valide. Un nom ne

peut pas contenir à la fois des guillemets (") et uneapostrophe (') 206

COI-ERR-2016 Feuille de calcul protégée, les styles d'IBMCognos Styles ne peuvent pas être remplis 207

COR-ERR-2004 La spécification de l'axe n'est pasvalide 207

COR-ERR-2007 Erreur lors de l'extraction à partir desressources 207

COR-ERR-2009 Nom de formule incorrect 208COR-ERR-2010 Formule incorrecte 208COR-ERR-2011 Plage non valide : Veuillez indiquer une

plage de tableau croisé ou de liste valide 208COR-ERR-2013 L'exploration ne peut être convertie en

analyse basée sur une formule 208COR-ERR-2014 Les résultats risquent d'être tronqués en

raison des restrictions des feuilles de calcul d'Excel 208COR-ERR-2015 Impossible d'afficher l'exploration actuelle à

cet emplacement de la feuille de calcul 208COR-ERR-2016 Impossible d'extraire le pack 208COR-ERR-2017 La sélection en cours n'a retourné aucune

donnée 209Echec de l'initialisation d'IBM Cognos Office dans

Microsoft Office 201Erreur : Exception HRESULT:<emplacement> 204fermeture inattendue d'un classeur Excel 202IBM Cognos Office ne parvient pas à créer une relation

d'approbation 205impossible de développer cet élément 204les résultats ont dépassé la limite du nombre de lignes ou

de colonnes Excel 204Microsoft Office Excel ne peut pas ouvrir un classeur

publié à partir d'IBM Cognos Office 201métadonnées 23Microsoft .NET 67Microsoft .NET Framework 194

installation 194Microsoft Excel

actualisation du contenu, traitement des incidents 206fermeture inattendue d'un classeur 202restrictions des lignes et des colonnes, résolution 204

Microsoft Internet Explorer 249Microsoft Visual C++ 67Microsoft Windows 165, 168mise à niveau 97mise à niveau de Contributor vers TM1 Applications 51mise à niveau des composants serveur sous Linux 50mise à niveau des composants serveur sous Unix 50mise à niveau des composants serveur sous Windows 50mise à niveau monoposte 50mise à niveau vers Cognos TM1 Applications 51mise à niveau Web 51Mise en file d'attente des travaux 336mode d'authentification de sécurité

TM1 Application Web 137, 147, 153TM1 Applications 36, 228

modélisateurs de donnéesrôle 191

modificationaffectations de groupe 256

modification de l'installation 298modification de tm1web_config.xml 113modification des composants 298mot de passe

valeurs par défaut pour les exemples 14Mozilla 249MTCubeLoad 351MTCubeLoad.MinFileSize 352MTCubeLoad.UseBookmarkFiles 352MTCubeLoad.Weight 352MTFeeders 347MTFeeders.AtomicWeight 347MTFeeders.AtStartup 347MTQ 353MTQ.CTreeRedundancyReducer 353MTQ.OperationProgressCheckSkipLoopSize 354MTQ.SingleCellConsolidation 354

NNegotiate 363NetRecvBlockingWaitLimitSeconds 354NetRecvMaxClientIOWaitWithinAPIsSeconds 355NIST_SP800_131A_MODE 355niveau 2 31niveau 3 32niveau riche 8nom d'utilisateur 20

valeurs par défaut pour les exemples 14nom du dossier Cognos Connection 140noms d'objet TM1 85noms non ASCII et paramètre régional 85norme de chiffrement SP800-131A 355nouveaux clients 263NTLM 363numéro de port 197

OODBCLibraryPath 355OLE DB 33optimisation des performances 83options de déploiement 33OracleErrorForceRowStatus 356Outdoors Company 213outils 223

Ppack redistribuable des assemblages d'interopérabilité de base

(PIA)installation 196

Package Connector Windows 7 60page de connexion, configuration 120paramètre AdminHost 281paramètre de configuration CognosTM1InterfacePath 62paramètre de langue du serveur 88paramètre de langue pour les clients 89paramètre DisableAdminHostEntry 381paramètre DisableWritebackOnDisconnect 381paramètre DisableWritebackOnTM1Formulas 382paramètre facultatif de Tm1s.cfg 252, 340

AllowReadOnlyChoreReschedule 313AllowSeparateNandCRules 313

Index 405

paramètre facultatif de Tm1s.cfg (suite)AllRuleCalcStargateOptimization 314ApplyMaximumViewSizeToEntireTransaction 315AuditLogMaxFileSize 315AuditLogMaxQueryMemory 315AuditLogOn 316AuditLogUpdateInterval 316AutomaticallyAddCubeDependencies 316CacheFriendlyMalloc 317CalculationThresholdForStorage 317CAMUseSSL 318CheckFeedersMaximumCells 318ClientCAMURI 318ClientExportSSLSvrCert 319ClientExportSSLSvrKeyID 319ClientMessagePortNumber 319ClientPingCAMPassport 319ClientPropertiesSyncInterval 320ClientVersionMaximum 320ClientVersionMinimum 321ClientVersionPrecision 321CognosMDX.AggregateByAncestorRef 322CognosMDX.CellCacheEnable 323CognosMDX.PrefilterWithPXJ 323CognosMDX.SimpleCellsUseOPTSDK 323CognosMDX.UseProviderCrossJoinThreshold 324CognosTM1InterfacePath 324CreateNewCAMClients 324DefaultMeasuresDimension (peut être obligatoire pour

OLAP) 325DisableMemoryCache 325DisableSandboxing 326Display_Info_DBType_R8 326DistributedPlanningOutputDir 327DownTime 327ExcelWebPublishEnabled 328FIPSOperationMode 330ForceReevaluationOfFeedersForFedCellsOnDataChange 330HTTPPortNumber 331HTTPSessionTimeoutMinutes 332IdleConnectionTimeOutSeconds 332IndexStoreDirectory 332IntegratedSecurityMode 332IPAddressV4 334IPAddressV6 334IPv6 335JavaClassPath 336JavaJVMArgs 336JavaJVMPath 336JobQueueMaxWaitTime 337JobQueueThreadPoolSize 337JobQueueThreadSleepTime 338JobQueuing 336keyfile 338keylabel 338keystashfile 338Language 339LDAPHost 252, 339LDAPPasswordKeyFile 252, 340LDAPPort 252, 340LDAPSearchBase 253, 340LDAPSearchField 253, 340LDAPSkipSSLCertVerification 253, 341LDAPSkipSSLCRLVerification 253, 341LDAPUseServerAccount 254, 341LDAPVerifyCertServerName 254, 341LDAPVerifyServerSSLCert 254, 342

paramètre facultatif de Tm1s.cfg (suite)LDAPWellKnownUserName 255, 343LoadPrivateSubsetsOnStartup 343LockPagesInMemory 343LoggingDirectory 344LogReleaseLineCount 344MagnitudeDifferenceToBeZero 344MaskUserNameInServerTools 345MaximumCubeLoadThreads 345MaximumLoginAttempts 346MaximumMemoryForSubsetUndo 346MaximumSynchAttempts 348MaximumTILockObject 348MaximumUserSandboxSize 349MaximumViewSize 349MDXSelectCalculatedMemberInputs 349MessageCompression 351MTCubeLoad 351MTCubeLoad.MinFileSize 352MTCubeLoad.UseBookmarkFiles 352MTCubeLoad.Weight 352MTFeeders 347MTFeeders.AtomicWeight 347MTFeeders.AtStartup 347MTQ 353MTQ.CTreeRedundancyReducer 353MTQ.OperationProgressCheckSkipLoopSize 354MTQ.SingleCellConsolidation 354NetRecvBlockingWaitLimitSeconds 354NetRecvMaxClientIOWaitWithinAPIsSeconds 355NIST_SP800_131A_MODE 355ODBCLibraryPath 355OracleErrorForceRowStatus 356PasswordMinimumLength 356PasswordSource 251, 356PerfMonIsActive 356PerformanceMonitorOn 357PersistentFeeders 357PortNumber 358PreallocatedMemory.BeforeLoad 358PreallocatedMemory.Size 358PreallocatedMemory.ThreadNumber 358PrivilegeGenerationOptimization 358ProgressMessage 359ProportionSpreadToZeroCells 360PullInvalidationSubset 361RawStoreDirectory 361ReceiveProgressResponseTimeoutSecs 361RulesOverwriteCellsOnLoad 362RunningInBackground 363SaveTime 363SecurityPackageName 363ServerCAMURI 363ServerCAMURIRetryAttempts 364ServerLogging 364ServerName 365ServicePrincipalName 365SkipLoadingAliases 365SkipSSLCAMHostCheck 366SpreadErrorInTIDiscardsAllChanges 367SpreadingPrecision 366SSLCertAuthority 367SSLCertificate 367SSLCertificateID 368StartupChores 368SubsetElementBreatherCount 368SupportPreTLSv12Clients 369


paramètre facultatif de Tm1s.cfg (suite)SvrSSLExportKeyID 369SyncUnitSize 369tlsCipherList 370TM1ConnectorforSAP 370UnicodeUpperLowerCase 370UseExcelSerialDate 371UseExtendedFetch 373UseLocalCopiesforPublicDynamicSubsets 372UseNewConnectorforSAP 372UserDefinedCalculations 372UseSQLFetch 373UseSQLFetchScroll 373UseSSL 373UseStargateForRules 374ViewConsolidationOptimization 374ViewConsolidationOptimizationMethod 375ZeroWeightOptimization 375

paramètre obligatoire de Tm1s.cfgAdminHost 313CAMPortalVariableFile 317DataBaseDirectory 325

paramètre UNIX de Tm1s.cfgODBCLibraryPath 355RunningInBackground 363

paramètres, tm1web_config.xml 113paramètres de configuration

TM1 Web 113paramètres par défaut 14paramètres régionaux 35paramètres SSL

ClientExportSSLSvrCert 319ClientExportSSLSvrKeyID 319SSLCertAuthority 367SSLCertificate 367SSLCertificateID 368SvrSSLExportKeyID 369UseSSL 373

passeport 228, 257passeport de sécurité Cognos 228, 257PasswordMinimumLength 356PasswordSource 251, 356pdata 25PerfMonIsActive 356Performance Modeler 68

installation 72PerformanceMonitorOn 357performances

sources de données Cognos TM1 203PersistentFeeders 357Perspectives, mise à niveau 51PIA (Primary Interop Assemblies) 194, 196

installation 195sous-clés d'installation 201

planification des mises à niveau 42Planning Analytics

sécurité Cognos 58Planning Analytics for Microsoft Excel

désinstallation 199proxy 156, 157, 159rôles et responsabilités des utilisateurs 191test de l'installation des composants client 199

Planning Analytics Workspaceaccessing 166installing 165

Planning Sampledémarrage 69

plusieurs hôtes Admin 22plusieurs serveurs 28pmhub.war 101pmpsvc.war 149, 150point comme domaine local 20port SSL 14portail Cognos Connection 65PortNumber 358PreallocatedMemory.BeforeLoad 358PreallocatedMemory.Size 358PreallocatedMemory.ThreadNumber 358prerequisites 164présentation de la mise à niveau 41PreviousAdminHosts 385PreviousDataDirectories 385prise en charge de la programmabilité .NET 201PrivilegeGenerationOptimization 358privilèges

requis pour installer Planning Analytics for MicrosoftExcel 198

requis pour utiliser Planning Analytics for MicrosoftExcel 199

privilèges d'administrateur 68privilèges du compte de service 18problèmes de sécurité 204ProgressMessage 359ProportionSpreadToZeroCells 360proxy 156, 157, 158

traitement des incidents 159PullInvalidationSubset 361

QQueuing 336

Rraccourcis-clavier 309

Cognos Configuration 310rapports

exécution de rapports IBM Cognos for Microsoft Officeaprès expiration de la session 203

RawStoreDirectory 361ReceiveProgressResponseTimeoutSecs 361recherche d'informations xvRegister Cognos XLL.vbs 200règles de connexion 271rejet du pare-feu de sécurité 203Remonter 372remote access 171répertoire de données

accès réseau requis 26chemin 25définition 25multiples 26privilèges d'accès 26sécurité 26serveur distant 26serveur local 26

restauration d'une base de données d'exemple sur DB2 214restauration des données après mise à niveau 54, 305restauration des fichiers de sauvegarde de Microsoft SQL 220restauration des fichiers de sauvegarde pour Oracle 217retour à la ligne dans les cellules 129révocation 274RulesOverwriteCellsOnLoad 362

Index 407

RunningInBackground 363

SSAP 370sauvegarde

TM1 Applications 297, 301sauvegarde de la version antérieure 48sauvegarde des données 48, 297SaveTime 363scénario d'installation 67sdata 25SData

démarrage 69, 78se connecter sous 272sécurité 226sécurité Cognos 159, 257, 265

accès anonyme 261avec le délai d'expiration de la session de TM1

Applications 270considérations pour l'administrateur 271considérations pour l'utilisateur 271proxy 158

sécurité Cognos Analyticsavec TM1 Applications 267

security 163SecurityAssignmentWindowLayoutInfo 385SecurityPackageName 363self-contained installation 168SentMsgsToServerCountWarning 385ServerCAMURI 363ServerCAMURIRetryAttempts 364ServerLogging 364ServerName 365serveur 23, 34

multiple 28Serveur Admin 22, 23, 34Serveur Admin TM1

démarrage 69serveur Cognos TM1 Applications

démarrage 137serveur distant 311

opérations 23répertoire de données 26

serveur local 26serveur TM1

démarrage sous Linux 83démarrage sous UNIX 83

Serveur TM1démarrage 69

serveur Web 29serveurs

ajout 90serveurs TM1

API REST 197connexion 197

service Admin Server 47service Cognos Analytics 47service Excel 47service TM1 Server 47ServicePrincipalName 365services 17

restarting 167starting 167stopping 167

sessions arrivées à expiration 203ShowAdminHostChangeWarning 385

ShowAliasAttributeWarning 385ShowChoresSchedulingWarning 386ShowCubeReplicationWarning 386ShowDimDeleteElementWarning 386ShowDimensionAccessWarning 386ShowDynamicSubsetWarning 386ShowPickOperationWarning 386ShowProcessUNASCIIWarning 387ShowProcessUNODBCWarning 387SkipLoadingAliases 365SkipSSLCAMHostCheck 366SliceNewWorkbook 387Solaris 18sources de données Cognos TM1

amélioration des performances 203SpreadErrorInTIDiscardsAllChanges 367SpreadingPrecision 366SSL 168, 169, 272, 274, 292

TM1 Web 282SSLCertAuthority 277, 367SSLCertificate 277, 367SSLCertificateID 277, 368SSLCertRevocationFile 277SSLPrivateKeyPwdFile 277SSLPwdKeyFile 277StartupChores 368SubsetElementBreatherCount 368SubsetWindowLayoutInfo 387suites de chiffrement 370SupportPreTLSv12Clients 369suppression d'une ancienne version 49suppression des zéros 349surveillance des serveurs 9.5.2 97SvrSSLExportKeyID 277, 369SyncUnitSize 369syntaxe de la machine locale 20système d'exploitation non anglais

traitement des incidents liés à .NET Framework 202

Ttest

installation d'IBM Cognos Analysis for MicrosoftExcel 199

ThirdPartyCertificateTool 294tlsCipherList 370TM1 Admin Server

démarrage 78TM1 Application

installation sur des ordinateurs distincts 38TM1 Application Server 37, 38

déploiement sur IBM WebSphere 150journalisation 144options de déploiement 36proxy 157

TM1 Application Web 143configuration du serveur 138, 148, 154exécution 71, 73mode d'authentification de sécurité 137, 147, 153URL 141utilisation de plusieurs serveurs TM1 156

TM1 Applications 301avec la sécurité IBM Cognos Analytics 267avec le délai d'expiration de la session de la sécurité IBM

Cognos 270certificats SSL tiers 286désinstallations d'Applications 303


TM1 Applications (suite)enregistrement des droits de sécurité 56installation monoposte 37mode d'authentification de sécurité 36, 228niveau données 32options de déploiement 36portail Cognos Connection 65restauration des fichiers d'application 307restauration des fichiers de configuration 307utilisation avec la sécurité Cognos Analytics 267

TM1 Applications Web 110, 111TM1 Architect

exécution 71TM1 Operations Console 74, 101, 103, 104, 105

ajout de certificats 99démarrage 98installation 97sécurité Cognos 265

TM1 Package Connector 58, 74TM1 Perspectives

exécution 70TM1 Server

avec la sécurité Cognos et l'accès anonyme 261démarrage 78sécurité Cognos 258

TM1 Web 110, 111, 251configuration du navigateur Web 131connexion intégrée 242exécution 71Kerberos 242page d'accueil 122paramètres de configuration 113paramètres de lancement 126sécurité Cognos 264SSL 282UNIX 109

TM1ConnectorforSAP 370TM1Crypt 290TM1Functions.cfg 161tm1p.ini

emplacement 377paramètres 377

Tm1p.ini, fichier 26, 377TM1RebuildDefault 387TM1S.cfg 256Tm1s.cfg, fichier 26, 311

emplacement 311exemple 311paramètres 312

Tm1s.cfg file 164tm1web_config.xml

définition 113édition 119paramètres de lancement 126

tm1web.html 264tm1web.war 111tm1xfer 85touches de raccourci 309

IBM Cognos Configuration 310traitement des incidents 200

SSL 169troubleshooting 167, 171TurboIntegrator

restriction de l'exécution des fonctions 160

types d'installation 3types de fichiers

enregistrer 201réenregistrement 202

UUnicodeUpperLowerCase 370uninstall 173UNIX

démarrage d'un serveur TM1 83installation 81installation du serveur TM1 80serveur 311

upgrade 173URI de distribution 140URI de la passerelle 61URI du répartiteur 61URI du répartiteur de service d'application TM1 140UseNewConnectorforSAP 372UserDefinedCalculations 372users 172UseSQLExtendedFetch 373UseSQLFetch 373UseSQLFetchScroll 373UseSSL 277, 373UseStargateForRules 374utilisateurs

ajout avec ETLDAP 229utilitaire ETLDAP 229

Vvalidation 256variable d'environnement TM1_Package_Connector 61variable système TEMP 68variables_TM1.xml 264Version du certificat du serveur TM1 Admin 274ViewConsolidationOptimization 374ViewConsolidationOptimizationMethod 375virtual machine 170Vista

Package Connector 60Visual C++ 2010 Redistributable Package 14vues Stargate 349

Wweb.config 119Websphere 149

désinstallation 304WebSphere 101, 103, 104, 110, 111, 150Windows

installation 78Windows 7 68Windows 7 Package Connector 60Windows Server 2008 68Windows Vista 68

ZZeroWeightOptimization 375

Index 409

Installation et configuration de...

Documents

Transcript of Installation et configuration de...