IBM Cognos Incentive Compensation Management Version 9.0.1
Guide d'installation et de configuration
IBM
Important
Avant d'utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à la section «Remarques», à la page 107.
LE PRESENT DOCUMENT EST LIVRE EN L'ETAT SANS AUCUNE GARANTIE EXPLICITE OU IMPLICITE. IBM DECLINE NOTAMMENT TOUTE RESPONSABILITE RELATIVE A CES INFORMATIONS EN CAS DE
CONTREFACON 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 y sont fournies sont susceptibles d'être modifiées avant que les produits décrits ne deviennent eux-mêmes
disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou services 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 partenaire
commercial.
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 France
Direction Qualité 17, avenue de l'Europe 92275 Bois-Colombes Cedex
Ce document s'applique à IBM Cognos Incentive Compensation Management version 9.0.1 et peut aussi s'appliquer aux éditions ultérieures de ce produit.
Licensed Materials - Property of IBM. Eléments sous licence - Propriété d'IBM.
Table des matières
Avis aux lecteurs canadiens . . . .. vii
Introduction . . . .. ix
Chapitre 1. Préparation de l'installation du client . . . .. 1
Présentation de l'application . . . .. 1
Fichiers d'installation . . . .. 2
Liste de contrôle de préinstallation . . . .. 3
Droits sur la base de données et composants requis pour les déploiements sur Microsoft SQL Server . . . . .. 4
Configuration d'IBM Cognos Incentive Compensation Management en tant que propriétaire de la base de données pour Microsoft SQL Server . . . .. 5
Modification du paramètre DEFAULT_SCHEMA dans Microsoft SQL Server Management Studio . . . . .. 5
Modification du paramètre DEFAULT_SCHEMA à l'aide d'une requête . . . .. 5
Chapitre 2. Client et service Windows d'IBM Cognos Incentive Compensation Management . . . .. 7
Installation du client . . . .. 7
Installation du service Windows . . . .. 7
Configuration du démarrage automatique du service Windows . . . .. 8
Fichiers de configuration . . . .. 8
Fichier de configuration du client . . . .. 8
Fichier de configuration du service . . . .. 10
Mises à niveau . . . .. 17
Mises à niveau standard . . . .. 17
Instances simultanées d'IBM Cognos Incentive Compensation Management . . . .. 22
Vérification de l'installation . . . .. 24
Ouverture d'un modèle existant pour vérifier l'installation. . . .. 24
Ajout d'un modèle pour vérifier l'installation . . . .. 24
Intégration de LDAP au client . . . .. 25
Configuration de l'authentification LDAP dans le fichier de configuration du service Windows . . . . .. 26
Accès au client pour les utilisateurs ou les groupes LDAP . . . .. 27
Optimisation des performances de la couche de données . . . .. 27
Intégration de Common language runtime (CLR) . . . .. 27
Activation de l'optimisation des performances de la couche de données dans le client . . . .. 28
Chapitre 3. Outils client . . . .. 29
Service de la console . . . .. 29
Installation du service de la console . . . .. 29
Edition du fichier de configuration du service de la console . . . .. 29
Démarrage du service de la console . . . .. 29
Chiffrement du fichier de configuration . . . .. 30
Installation du programme de chiffrement des fichiers de configuration . . . .. 30
Exécution du programme de chiffrement des fichiers de configuration. . . .. 30
Convertisseur de modèle . . . .. 31
Installation du convertisseur de modèle . . . .. 31
Conversion d'un modèle Microsoft SQL 2000 ou 2005 vers un modèle 2008 . . . .. 31
Conversion d'un modèle Microsoft SQL Standard vers un modèle Enterprise . . . .. 32
Conversion d'un modèle Microsoft SQL 2005 Standard Edition vers un modèle 2008 Enterprise Edition . .. 33
Réduction de la taille de la base de données et de la durée des calculs . . . .. 33
Certificats . . . .. 34
Logiciels requis pour l'utilisation des certificats numériques . . . .. 34
Génération de certificats numériques pour les tests ou le traitement des incidents . . . .. 34
Configuration de l'utilisation des certificats numériques par Microsoft Management Console . . . .. 36
Certificats serveur et racine . . . .. 36
Adresse IP et port du serveur . . . .. 37
Configuration d'IBM Cognos Incentive Compensation Management en vue de l'utilisation de certificats . .. 39
Interface de ligne de commande . . . .. 40
Préparation de l'installation de l'interface de ligne de commande . . . .. 40
Installation de l'interface de ligne de commande d'IBM Cognos Incentive Compensation Management . . .. 41
Utilisation de l'interface de ligne de commande pour la configuration des certificats numériques . . . . .. 41
Utilisation de l'interface de ligne de commande pour la connexion à un modèle . . . .. 41
Commandes de l'interface de ligne de commande . . . .. 42
Code de retour de l'interface de ligne de commande. . . .. 43
API . . . .. 44
Architecture de l'API . . . .. 45
Accès à l'API . . . .. 45
Spécifications de l'API pour le traitement et le calcul . . . .. 46
Spécifications de l'API pour la gestion des données . . . .. 48
Spécifications de l'API pour le magasin de données . . . .. 50
Définitions d'objet . . . .. 52
Définitions d'exception . . . .. 55
Module d’extension pour Microsoft Excel . . . .. 56
Configuration côté service pour l'installation du module d’extension pour Microsoft Excel . . . .. 56
Configuration côté client pour l'installation du module d’extension pour Microsoft Excel . . . .. 58
Chapitre 4. Client Web d'IBM Cognos Incentive Compensation Management. . . . .. 63
Installation du client Web sur le système d'exploitation Solaris . . . .. 63
Déploiement du client Web avec Apache Tomcat . . . .. 63
Installation et configuration de Java . . . .. 63
Installation et configuration d'Apache Tomcat . . . .. 64
Utilisation d'Apache Tomcat pour déployer le client Web . . . .. 64
Utilisation d'Apache Tomcat pour configurer l'accès à la base de données . . . .. 64
Configuration du support des données multilingues et Unicode pour Apache Tomcat . . . .. 65
Déploiement du client Web avec JBoss . . . .. 66
Installation et configuration de Java pour JBoss . . . .. 66
Installation et configuration de JBoss . . . .. 66
Utilisation de JBoss pour configurer l'accès à la base de données . . . .. 66
Utilisation de JBoss pour déployer le client Web . . . .. 67
Configuration du support des données multilingues et Unicode pour JBoss . . . .. 68
Déploiement du client Web avec IBM WebSphere 7 . . . .. 68
Déploiement du client Web sur WebSphere 7 . . . .. 69
Configuration de l'accès à la base de données à l'aide de WebSphere . . . .. 69
Utilisation de la console d'administration WebSphere pour démarrer le client Web. . . .. 70
Définition d'une propriété personnalisée de conteneur Web dans WebSphere . . . .. 71
Configuration du support des données multilingues et Unicode pour WebSphere . . . .. 71
Déploiement du client Web avec WebSphere 8 . . . .. 72
Configuration de WebSphere 8 . . . .. 72
Déploiement du client Web sur WebSphere 8 . . . .. 72
Configuration de l'accès à la base de données à l'aide de WebSphere . . . .. 73
Utilisation de la console d'administration WebSphere pour démarrer le client Web. . . .. 74
Chiffrement des fichiers de propriétés . . . .. 74
Obtention des mots de passe chiffrés . . . .. 75
Configuration du chiffrement des mots de passe du client Web . . . .. 75
Configuration du chiffrement des mots de passe du client Web dans un environnement Windows . . . .. 76
Déploiement du client Web avec des mots de passe chiffrés . . . .. 76
Configuration du support des données multilingues et Unicode pour l'environnement local . . . .. 76
Envoi automatique d'un courrier électronique aux utilisateurs lorsqu'une demande est en attente. . . .. 77
Limitation de la quantité de données chargées dans les rapports Presenter . . . .. 78
Nombre maximal de lignes dans la grille de données des rapports Presenter . . . .. 78
Désactivation de la collecte des informations sur les rapports Presenter . . . .. 78
Apparence du client Web . . . .. 79
Configuration des onglets Web . . . .. 79
Modification du thème du client Web. . . .. 81
Chapitre 5. Authentification et connexion . . . .. 83
Options des chemins de communication . . . .. 83
Options de sécurité des communications entre le client et le serveur d'applications . . . .. 83
Options de sécurité des communications entre le serveur d'applications et le serveur de base de données . .. 83
Méthodes de communication entre le client Web et l'application Web . . . .. 84
Méthodes de chiffrement des communications entre le serveur d'applications Web et le serveur de base de données . . . .. 84
Options d'authentification . . . .. 84
Configuration de SiteMinder . . . .. 85
Configuration du client Web pour l'autorité de certification SiteMinder . . . .. 85
Accès au client Web avec SiteMinder . . . .. 86
Configuration d'OpenSSO . . . .. 86
Téléchargement et installation d'OpenSSO . . . .. 87
Configuration d'OpenSSO . . . .. 87
Configuration du fournisseur d'identité . . . .. 88
Configuration du fournisseur de services . . . .. 88
Configuration LDAP pour le client Web . . . .. 90
Configuration requise pour la validation. . . .. 91
Configuration du fichier ldap.properties . . . .. 91
Configuration du fichier web.xml . . . .. 92
Chapitre 6. Intégration . . . .. 93
Connexion à IBM Cognos Territory and Quota Management . . . .. 93
Connexion à IBM Producer Lifecycle and Credential Management . . . .. 93
Configuration du client Web d'IBM Cognos Incentive Compensation Management pour Salesforce.com . . .. 94
Accès à IBM Cognos Incentive Compensation Management depuis Salesforce.com. . . .. 94
Intégration du client Web à Oracle CRM. . . .. 95
Configuration du client IBM Cognos Incentive Compensation Management pour une intégration avec Oracle CRM . . . .. 95
Configuration du client Web d'IBM Cognos Incentive Compensation Management pour une utilisation avec Oracle CRM . . . .. 96
Personnalisation de l'aspect du client IBM Cognos Incentive Compensation Management pour Salesforce.com .. 97
Modification du thème de Salesforce.com dans IBM Cognos Incentive Compensation Management . . . .. 97
Intégration au serveur Web Microsoft IIS . . . .. 97
Configuration du client Web en vue de l'intégration avec le serveur Web Microsoft IIS . . . .. 98
Configuration de l'acceptation des demandes transmises par un proxy dans Apache Tomcat . . . .. 98
Configuration de la transmission des demandes à IBM Cognos Incentive Compensation Management dans IIS 98 Intégration à l'authentification Windows intégrée (IWA) . . . .. 101
Configuration de l'authentification Windows intégrée pour Internet Explorer . . . .. 102
Configuration de l'authentification Windows intégrée pour Mozilla Firefox . . . .. 102
Configuration de l'authentification Windows intégrée pour Google Chrome . . . .. 102
Création d'un fichier de configuration Kerberos pour l'authentification Windows intégrée . . . .. 103
Configuration du nom principal du service et du fichier keytab pour l'authentification Windows intégrée .. 103
Configuration du client Web pour l'authentification Windows intégrée . . . .. 104
Remarques . . . .. 107
Glossaire . . . .. 111
A . . . .. 111
B . . . .. 111
C . . . .. 111
D . . . .. 112
F . . . .. 112
J . . . .. 112
L . . . .. 112
O . . . .. 113
P . . . .. 113
R . . . .. 113
S . . . .. 113
T . . . .. 113
V . . . .. 114
Index . . . .. 115
Avis aux lecteurs canadiens
Le présent document a été traduit en France. Voici les principales différences et particularités dont vous devez tenir compte.
Illustrations
Les illustrations sont fournies à titre d'exemple. Certaines peuvent contenir des données propres à la France.
Terminologie
La terminologie des titres IBM peut différer d'un pays à l'autre. Reportez-vous au tableau 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, et le 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ées
différemment selon qu'il s'agit du clavier de la France, du clavier du Canada ou du clavier des États-Unis. Reportez-vous à ce tableau pour faire correspondre les touches françaises figurant dans le présent document aux touches de votre clavier.
Brevets
Il est possible qu'IBM détienne des brevets ou qu'elle ait déposé des demandes de brevets portant sur certains sujets abordés dans ce document. Le fait qu'IBM vous fournisse le présent document ne signifie pas qu'elle vous accorde un permis d'utilisation de ces brevets. Vous pouvez envoyer, par écrit, vos demandes de renseignements relatives aux permis d'utilisation au directeur général des relations commerciales 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, des logiciels et des publications IBM, contactez IBM direct au 1 800 465-1234.
Introduction
Le présent document est destiné à être utilisé avec IBM Cognos Incentive Compensation Management version 9.0.1.
Cognos Incentive Compensation Management permet aux organisations
d'automatiser le processus d'administration, de calcul, de génération de rapports et d'analyse des programmes de rémunération variable. L'exactitude des données, la réduction des coûts, et la visibilité accrue sur les performances de ventes et les plans de rémunération apportées par la solution simplifient la gestion de la rémunération des primes par les organisations.
Audience
Le présent guide est destiné aux utilisateurs du client et du client Web de Cognos Incentive Compensation Management.
Recherche d'informations
Pour rechercher la documentation sur le Web, y compris tous les documents traduits, accédez à IBM®Knowledge Center (http://www.ibm.com/support/
knowledgecenter).
Date de publication
Ce document a été publié le 2 septembre 2015.
Fonctions d'accessibilité
Les fonctions d'accessibilité permettent aux utilisateurs souffrant d'un handicap physique, comme une mobilité réduite ou une vision limitée, d'utiliser les produits informatiques.
Instructions prospectives
La présente documentation décrit les fonctionnalités actuelles du produit. Elle peut contenir 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 telles références ne constituent en aucun cas un engagement, une promesse ou une obligation légale de fournir un élément, un code ou une fonctionnalité. Le
développement, la disponibilité et le calendrier de mise à disposition des fonctions demeurent à la seule discrétion d'IBM.
Chapitre 1. Préparation de l'installation du client
IBM Cognos Incentive Compensation Management est un outil efficace qui permet de gérer la paie des personnes qui reçoivent une rémunération variable (par exemple, forces de vente, encadrement et canaux de distribution).
Cognos Incentive Compensation Management permet aux organisations de concevoir, gérer et automatiser le calcul de la rémunération variable pour des dizaines de plans et des milliers d'employés simultanément. L'application contient des boîtes de dialogue et des assistants contextuels destinés à vous guider dans la réalisation des tâches.
Pour accéder à la liste des environnements pris en charge par Cognos Incentive Compensation Management (systèmes d'exploitation, navigateurs, serveurs Web, serveurs de base de données et serveurs d'applications), voir les logiciels requis (http://www.ibm.com/support/docview.wss?uid=swg27045752).
Présentation de l'application
IBM Cognos Incentive Compensation Management est une application répartie à n niveaux.
Les applications suivantes constituent la solution intégrée :
Client Contient l'interface utilisateur dédiée à la réalisation des tâches.
Serveur d'applications
Contient la logique métier, le moteur de calcul et le planificateur des événements métier.
Serveur de base de données
Stocke les données du modèle Cognos Incentive Compensation
Management, telles que les informations sur les dimensions et les résultats calculés.
Un certain nombre de serveurs de base de données, dont Microsoft SQL Server (2005, 2008 ou 2012), sont pris en charge.
Les principales caractéristiques du client sont les suivantes :
v Il fournit à l'administrateur du modèle différentes fonctions d'administration, notamment la création de nouveaux modèles, la personnalisation des tables, l'importation des données, les calculs et plusieurs modes pour la génération de rapports.
v Il réside sur le poste de travail de chaque administrateur de modèle.
v Il communique avec le serveur dans un environnement véritablement réparti et utilise un fichier de configuration pour définir l'emplacement du serveur d'applications.
v Il communique avec le serveur d'applications par un canal chiffré écrit en C#
grâce à Microsoft .NET Framework.
Les principales caractéristiques du serveur d'applications sont les suivantes : v La couche applicative peut être exécutée en tant que processus sur un ou
plusieurs serveurs pour garantir l'évolutivité du système.
v Il contient la logique métier du modèle.
v Il héberge le moteur de calcul pour le traitement des données.
v Il utilise la couche données pour communiquer avec la base de données définie.
v Il contient le module Scheduler de Cognos Incentive Compensation Management, qui planifie et exécute les événements métier.
v Son développement en C# avec Microsoft .NET Framework garantit la stabilité du produit.
Fichiers d'installation
L'application IBM Cognos Incentive Compensation Management est livrée avec plusieurs fichiers d'installation.
Pour utiliser l'application, vous devez installer le client sur le poste de travail de l'administrateur, mais également installer et exécuter le service Windows de Cognos Incentive Compensation Management sur le serveur. Les outils, tels que le programme de mise à niveau des modèles, le convertisseur de modèle, l'interface de ligne de commande, le module d'extension de Cognos Incentive Compensation Management pour Microsoft et le programme de chiffrement des fichiers de configuration, peuvent être installés mais ne sont pas indispensables au fonctionnement de l'application.
Tous les outils et les composants du client doivent être à la même version du produit. Si vous mettez à niveau le client et le service, tous les autres outils Cognos Incentive Compensation Management utilisés conjointement à l'application
d'administration principale doivent être aussi mis à niveau.
Tableau 1. Fichiers d'installation Composants et outils de l'application
Nom du fichier
d'installation Description Client Cognos Incentive
Compensation Management
ICM-client.exe Le client Cognos Incentive Compensation Management doit être installé pour que l'application fonctionne.
Service Windows de Cognos Incentive Compensation Management
ICM-service.exe Le service Windows de Cognos Incentive
Compensation Management (ou le service de la console) doit être installé et
fonctionner.
Service de la console ICM-console.exe Le service de la console peut constituer une alternative au service Windows de Cognos Incentive Compensation Management. Il n'est pas nécessaire si le service Windows de Cognos Incentive Compensation Management est utilisé.
Tableau 1. Fichiers d'installation (suite) Composants et outils de
l'application
Nom du fichier
d'installation Description Interface de ligne de
commande (CLI)
ICM-cli.exe Si vous souhaitez utiliser l'interface de ligne de commande (CLI), vous devez exécuter son programme d'installation. Ce module n'est pas indispensable à l'application principale.
Module d'extension de Cognos Incentive
Compensation Management pour Microsoft Excel
ICM-exceladdin.exe Si vous souhaitez utiliser le programme d'installation du module d'extension de Cognos Incentive
Compensation Management pour Microsoft Excel, vous devez exécuter son
programme d'installation. Ce module n'est pas
indispensable à l'application principale.
Programme de chiffrement des fichiers de configuration
ICM-encrypter.exe Si vous souhaitez utiliser le programme de chiffrement des fichiers de configuration, vous devez exécuter son programme d'installation. Ce module n'est pas
indispensable à l'application principale.
Convertisseur de modèle ICM-modelconverter.exe Si vous souhaitez convertir des modèles dans une autre version de Microsoft SQL Server, exécutez le
programme d'installation du convertisseur de modèle. Il ne sert qu'à la conversion des modèles.
Programme de mise à niveau des modèles
ICM-modelupgrader.exe Si vous souhaitez mettre à niveau un modèle vers une version plus récente, exécutez le programme d'installation du programme de mise à niveau des modèles. Si le client et le service sont mis à niveau, les modèles existants doivent l'être aussi pour fonctionner avec la nouvelle version des logiciels.
Liste de contrôle de préinstallation
Certaines tâches doivent être réalisées avant l'installation de l'application IBM Cognos Incentive Compensation Management.
Avant de commencer l'installation, réalisez les opérations suivantes :
1. Téléchargez les fichiers d'installation de Cognos Incentive Compensation Management.
2. Installez Microsoft .NET Framework 4.5 à la fois sur le serveur et sur le client (téléchargeable depuis le site http://www.microsoft.com/downloads).
3. Installez Java™6.
4. Donnez à l'administrateur l'accès à tous les ordinateurs impliqués.
5. Vous disposez de droits suffisants sur la base de données, ou vous êtes son propriétaire.
Droits sur la base de données et composants requis pour les déploiements sur Microsoft SQL Server
Lorsque vous déployez IBM Cognos Incentive Compensation Management sur Microsoft SQL Server, Cognos Incentive Compensation Management n'a pas besoin des droits d'administration sur le serveur de la base de données. Vous devez en revanche lui accorder les droits de propriété sur la base pour lui permettre d'y accéder.
Lorsque vous installez un modèle, vérifiez que Cognos Incentive Compensation Management est défini comme le propriétaire de la base de données (DBO).
S'il n'est pas possible d'accorder les droits DBO, vous devez créer un utilisateur disposant au minimum des droits suivants :
v Connexion v Création de table v Création de vue v Exécution v Sélection v Suppression v Insertion v Mise à jour
v Affichage de l'état de la base de données
Important : Il est préférable d'accorder à Cognos Incentive Compensation Management les droits DBO.
Vous devez également installer les composants suivants sur Microsoft SQL Server.
Ces composants doivent être installés sur le même serveur que le service Varicent : v Connectivité des outils clients
v Integration Services
v Compatibilité descendante des outils clients
v Kit de développement logiciel (SDK) des outils clients
Les composants SSIS doivent être installés sur le serveur d'applications, sur lequel est hébergé le service Cognos Incentive Compensation Management, et non sur le serveur de base de données. Pour installer ces composants, vous devez lancer le programme d'installation Microsoft SQL Server et cocher les cases en regard de chaque composant à l'étape Sélection des composants. Ces composants peuvent aussi être installés de la même manière sur les installations SQL Server
pré-existantes.
Important : Les services Windows pour SQL Server Integration Services n'ont pas besoin d'être démarrés pour importer les données dans Cognos Incentive
Compensation Management. Cela libère de la mémoire sur le serveur d'applications.
Configuration d'IBM Cognos Incentive Compensation
Management en tant que propriétaire de la base de données pour Microsoft SQL Server
Vous devez créer un utilisateur de base de données destiné à permettre à IBM Cognos Incentive Compensation Management d'accéder à la base de données, puis lui donner la propriété de la base de données.
Procédure
1. Créez un utilisateur de base de données (ICMDBUser) destiné à permettre à Cognos Incentive Compensation Management d'accéder à la base de données.
2. Connectez-vous à Microsoft SQL Server en tant qu'administrateur.
3. Connectez-vous à la base de données utilisée par Cognos Incentive Compensation Management (ICMDatabase).
4. Exécutez le script suivant : USE [ICMDatabase]
GO
IF EXISTS (SELECT*FROM dbo.sysusers WHERE name=N’ICMDBUser’) EXEC dbo.sp_revokedbaccess N’ICMDBUser’;
GO
sp_changedbowner N’ICMDBUser’
5. Si vous utilisez Microsoft SQL Server 2005, des règles de sécurité supplémentaires doivent être respectées :
v ICMDBUser doit disposer du droit de création sur ICMDatabase
v La propriété DEFAULT_SCHEMAd'ICMDBUser doit avoir la valeur dbo. Cette modification peut être réalisée dans Microsoft SQL Server Management Studio ou à l'aide d'une requête.
Modification du paramètre DEFAULT_SCHEMA dans Microsoft SQL Server Management Studio
Microsoft SQL Server Management Studio permet de modifier le schéma par défaut de l'utilisateur de la base de données IBM Cognos Incentive Compensation Management et de le définir en tant que propriétaire de la base de données.
Procédure
1. Dans Microsoft SQL Server Management Studio, développez le dossier ICMDatabase.
2. Développez le dossier Security.
3. Développez le dossier Users.
4. Cliquez avec le bouton droit sur ICMDBUser, puis cliquez sur Propriétés.
5. Entrez ou sélectionnez dbo dans la zone Default Schema.
Modification du paramètre DEFAULT_SCHEMA à l'aide d'une requête
Une requête permet de modifier le schéma par défaut de l'utilisateur de la base de données IBM Cognos Incentive Compensation Management et de le définir en tant que propriétaire de la base de données.
Procédure
1. Connectez-vous à la base de données ICMDatabaseavec un client SQL.
2. Connectez-vous avec un compte administrateur.
3. Lancez la requête suivante :
ALTER USER "ICMDBUser" WITH DEFAULT_SCHEMA dbo;
Chapitre 2. Client et service Windows d'IBM Cognos Incentive Compensation Management
Le client et le service Windows de IBM Cognos Incentive Compensation Management doivent être installés et s'exécuter sur le serveur pour que vous puissiez utiliser l'application Cognos Incentive Compensation Management.
Le client est nécessaire pour permettre aux utilisateurs autorisés de créer des modèles, personnaliser des tables, importer des données, créer des calculs et générer des rapports sur les résultats. Le service (ou le service de la console) doit également être installé et en cours d'exécution pour que le client fonctionne correctement.
Installation du client
Le client IBM Cognos Incentive Compensation Management doit être installé pour que l'application fonctionne. Le client doit être installé sur le bureau de
l'administrateur.
Procédure
1. Cliquez deux fois sur le fichier d'installation ICM-client.exesitué dans le dossier de votre version.
Important : Si vous effectuez une mise à niveau de Cognos Incentive Compensation Management, reportez-vous aux instructions relatives à cette opération.
2. Suivez les étapes de l'assistant d'installation.
Installation du service Windows
Le service Windows de IBM Cognos Incentive Compensation Management doit être installé et s'exécuter sur le serveur pour que l'application fonctionne correctement.
Pourquoi et quand exécuter cette tâche
Le service Windows doit être installé sur le serveur d'applications. Le service Windows ou le service de la console de Cognos Incentive Compensation Management doit être installé et en fonctionnement pour que la connexion au client soit possible.
Procédure
1. Cliquez deux fois sur le fichier d'installation ICM-service.exesitué dans le dossier de votre version.
2. Sélectionnez l'option d'installation par défaut et cliquez sur Suivant dans l'écran d'accueil du programme d'installation.
Important : Si vous effectuez une mise à niveau de Cognos Incentive Compensation Management, reportez-vous aux instructions relatives à cette opération.
3. Suivez les étapes de l'assistant d'installation.
Important : Par défaut, le type de démarrage du service Windows de Cognos Incentive Compensation Management est manuel, ce qui signifie que vous devez le démarrer manuellement à chaque fois que vous ouvrez le client.
Configuration du démarrage automatique du service Windows
Vous pouvez changer le type de démarrage du service Windows de IBM Cognos Incentive Compensation Management de manuel à automatique.
Procédure
1. Cliquez sur Panneau de configuration > Outils d'administration > Services.
2. Dans la sous-fenêtre Services, sélectionnez IBM Cognos ICM Service.
3. Cliquez avec le bouton droit et cliquez sur Propriétés.
4. Sélectionnez Automatique comme Type de démarrage.
Fichiers de configuration
Lors de l'installation ou de la mise à niveau de IBM Cognos Incentive
Compensation Management, vous devez modifier les fichiers de configuration.
Les fichiers de configuration suivants doivent être édités :
v Le fichier ICM.exe.config d'IBM Cognos sur le poste de travail de l'administrateur
v service.exe.config du service Windows d'IBM Cognos ICM sur le serveur d'applications
Si vous mettez à niveau une version existante de Cognos Incentive Compensation Management, faites une copie de sauvegarde des fichiers Service.exe.config du service Windows d'IBM Cognos ICM et ICM.exe.config d'IBM Cognos afin de les comparer aux fichiers de configuration mis à niveau. Vérifiez que les paramètres de l'application dans les nouveaux fichiers de configuration correspondent à ceux des fichiers enregistrés de la version précédente.
Conseil : Vous pouvez mettre en commentaire dans le fichier de configuration les lignes que vous ne voulez pas utiliser, en insérant <!--au début de ces lignes. Si vous mettez des lignes en commentaire, vous devez mettre en commentaire toute la section, et non uniquement sa première ligne.
Fichier de configuration du client
Vous devez éditer le fichier ICM.exe.config d'IBM Cognos pour définir la manière dont le client IBM Cognos Incentive Compensation Management communique avec le serveur d'applications.
Lors de l'installation de Cognos Incentive Compensation Management, vous devez remplacer toutes les instances de localhost par le nom et l'adresse IP de votre serveur d'applications. Cette modification doit être effectuée dans le fichier de configuration qui se trouve dans le même répertoire que le fichier IBM Cognos ICM.exe.
Vous devez éditer les sections de configuration suivantes dans le fichier ICM.exe.config d'IBM Cognos :
v Environments v appSettings
Configuration de l'environnement des modèles
Vous pouvez définir les environnements de vos modèles à la section Environments du fichier de configuration Windows de IBM Cognos Incentive Compensation Management.
Procédure
1. Editez le paramètre environment name.
Il s'agit du nom que vous choisissez d'attribuer à l'environnement. Par exemple : Production, Développement ou Contrôle qualité.
2. Editez le paramètre securityMode. Il détermine la façon dont la communication doit être chiffrée entre le client et le service Windows. Les paramètres suivants sont disponibles :
Mode TLS (Transport Layer Security)
Les clients sont authentifiés par Windows Communication Framework.
Le serveur doit fournir un certificat de confiance pour l'authentification.
Mode de sécurité Windows
Les clients et les serveurs sont authentifiés par Kerberos avec le contrôleur de domaine comme tiers de confiance. Aucun certificat n'est requis.
Mode non protégé
Toute la sécurité est désactivée.
3. Editez le paramètre serviceAddress.
Il s'agit du port utilisé par le service. Chaque environnement doit être configuré de manière à utiliser un port distinct.
Important : Le mode de sécurité choisi doit être le même pour le fichier de configuration du service (fichier Service.exe.config du service Windows d'IBM Cognos ICM) et celui du client (fichier ICM.exe.config d'IBM Cognos). Les deux fichiers doivent être mis à jour de façon concordante.
Configuration d'appSettings
Dans le fichier de configuration de IBM Cognos Incentive Compensation Management, la valeur de AllowMultipleInstancesdétermines si plusieurs modèles peuvent être ouverts simultanément sur le même ordinateur. La langue par défaut du client peut également être définie dans cette section.
La plupart des utilisateurs ont besoin d'une seule instance du client sur un ordinateur. Cependant, il peut être nécessaire de faire fonctionner le client sur un serveur de terminaux, et donc de disposer de plusieurs instances.
L'exemple suivant représente une configuration du fichier ICM.exe.config d'IBM Cognosqui permet aux utilisateurs d'avoir plusieurs modèles ouverts en même temps sur un ordinateur :
<appSettings>
<!-- Allowing Multiple Instance -->
<add key="AllowMultipleInstances" value="true"/>
Pour définir la langue par défaut du client, annulez la mise en commentaire et modifiez le paramètre suivant :
<add key="DefaultLanguage" value="EnglishUS"/>
Fichier de configuration du service
Le fichier de configuration du service IBM Cognos Incentive Compensation
Management définit la manière dont le serveur d'applications communique avec le serveur de base de données.
Le fichier de configuration du service (service.exe.config du service Windows d'IBM Cognos ICM) est dans le même répertoire que le fichier de configuration de Cognos Incentive Compensation Management (IBM Cognos ICM Windows
Service.exe).
Configuration des paramètres du serveur de base de données
Vous devez adapter à votre serveur de base de données le bloc <databaseServers>
du fichier de configuration du service Windows de IBM Cognos Incentive
Compensation Management. Par défaut, le fichier est configuré pour se connecter à une base de données Microsoft SQL Server 2008.
Procédure
1. Ouvrez le fichier service.exe.config du service Windows d'IBM Cognos. 2. A la section databaseServers, effectuez les opérations suivantes :
a. Editez le serveur de base de données name.
Il s'agit d'un nom de votre choix, par exemple Super Serveur, destiné à identifier de façon distinctive le serveur de base de données. Si la base de données est une instance Microsoft SQL Server 2000 nommée, ou si vous utilisez une base de données Microsoft SQL Server 2005, la valeur de la zone DB Server doit être au format suivant : SERVER_NAME\INSTANCE_NAME. b. Editez le paramètre User.
Userest identique à l'utilisateur de la base de données. Dans le cas des serveurs Microsoft SQL, Cognos Incentive Compensation Management exige l'authentification SQL ou l'authentification Windows pour se connecter. Vous devez donc vous connecter avec un utilisateur local de la base de données.
Si vous utilisez l'authentification Windows, les paramètres user et password doivent rester vides.
c. Saisissez la valeur du paramètre Password.
Il s'agit du mot de passe de l'utilisateur de la base de données.
d. Editez le paramètre Address.
Cette adresse pointe vers l'emplacement de la base de données. Utilisez le format d'adresse suivant : SERVER_NAME\INSTANCE_NAME. Si SQL Server n'utilise pas le port par défaut 1433, vous devez ajouter le numéro du port utilisé à l'adresse (par exemple, SERVER_NAME\INSTANCE_NAME, PORT_NUMBER).
e. Editez le Typede la base de données.
f. Editez le paramètre DiskPath.
Il s'agit de l'emplacement dans lequel les bases de données sont créées et stockées.
g. Editez le paramètre LogPath.
Il s'agit de l'emplacement dans lequel le fichier journal est créé et stocké.
h. Modifiez le paramètre TimeoutSeconds.
Il s'agit de la durée en secondes du délai d'attente. La valeur par défaut pour la base de données est 90 secondes. C'est la durée minimale de l'attente des clients avant que Cognos Incentive Compensation Management puisse signaler un problème de réseau ou de serveur. Dans le cas des
modèles qui effectuent des calculs longs, cette valeur peut être augmentée pour éviter qu'un dépassement du délai d'attente ne se produise au cours d'un calcul.
Configuration de l'accès à plusieurs bases de données
Si vous disposez de plusieurs serveurs de base de données pour IBM Cognos Incentive Compensation Management, vous pouvez configurer pour eux plusieurs sections dans le fichier service.exe.config du service Windows d'IBM Cognos ICM. Pourquoi et quand exécuter cette tâche
Lorsque vous configurez les paramètres de plusieurs bases de données, vous pouvez accéder aux modèles SQL Unicode et non-Unicode avec le même service.
Par défaut, le fichier de configuration contient une seule section, mais vous pouvez en ajouter. Tous les modèles contenus sur chaque serveur de base de données dans le fichier de configuration du service sont accessibles depuis l'écran de connexion.
Procédure
1. Ouvrez le fichier de configuration du service Windows de Cognos Incentive Compensation Management.
2. Rédigez une section <databaseServer>pour chaque serveur.
Important : Cognos Incentive Compensation Management ne fonctionne pas sans service. Il n'est pas possible d'entrer des informations sur la base de données dans le fichier ICM.exe.config d'IBM Cognos pour contourner le service et accéder directement à la base de données.
Voici un exemple de configuration pour un modèle Microsoft SQL Server non-Unicode et un modèle Microsoft SQL Server Unicode exécutés par le même service Windows de Cognos Incentive Compensation Management.
<databaseServers>
<databaseServer Name="NonUnicodeModel"
Address="(local)"
Type="SQLServer2008"
User="sa"
Password=""
DiskPath="D:\"
LogPath="D:\"
TimeoutSeconds="90">
</databaseServer>
<databaseServer Name="UnicodeModel"
Address="(local)"
Type="SQLServer2008unicode"
User="sa"
Password=""
DiskPath="D:\"
LogPath="D:\"
TimeoutSeconds="90">
</databaseServer>
</databaseServers>
Configuration des paramètres du service Windows
Après avoir configuré les paramètres des serveurs de base de données, vous pouvez éditer différentes sections du fichier de configuration du service Windows de IBM Cognos Incentive Compensation Management en fonction de vos besoins.
Procédure
1. Editez les valeurs de ServiceAddresset de portpour les faire pointer vers le nom et le port du serveur sur lequel le service Windows de Cognos Incentive Compensation Management est installé et exécuté, par exemple
localhost:13105.
2. Editez la valeur de SecurityMode. Elle détermine la façon dont la
communication doit être chiffrée entre le client et le service Windows. Les paramètres suivants sont disponibles :
Mode TLS (Transport Layer Security)
Les clients sont authentifiés par Windows Communication Framework.
Le serveur doit fournir un certificat de confiance pour l'authentification.
Mode de sécurité Windows
Les clients et les serveurs sont authentifiés par Kerberos avec le contrôleur de domaine comme tiers de confiance. Aucun certificat n'est requis.
Mode non protégé
Toute la sécurité est désactivée.
Important : Le mode de sécurité choisi doit être le même pour le service Windows de Cognos Incentive Compensation Management (fichier
Service.exe.config du service Windows d'IBM Cognos ICM) et le client (fichier ICM.exe.config d'IBM Cognos). Les deux fichiers doivent être mis à jour de façon concordante.
3. Si vous utilisez le mode TLS, définissez dans le paramètre
ServiceCertificateNamele nom de sujet d'un certificat stocké dans la Banque de certificats personnels Windows qui servira à l'authentification dans le service Windows de Cognos Incentive Compensation Management.
4. Si vous utilisez le service de l'API Cognos Incentive Compensation
Management, éditez les paramètres APIAddresset value pour les faire pointer vers le nom et le port du serveur sur lequel il est installé et exécuté, par exemple localhost:13115.
5. Si vous utilisez des certificats avec le service de l'API de Cognos Incentive Compensation Management, faites pointer les paramètres APISecureAddresset value sur le nom et le port du serveur sur lequel il est installé et fonctionne de façon sécurisée en utilisant des certificats pour la fonction d'authentification (par exemple, MobileAPI:13125).
6. Si vous utilisez des certificats avec le service de l'API de Cognos Incentive Compensation Management, remplacez la valeur du paramètre
APICertificateNamepar le nom de sujet (CN) d'un certificat stocké dans la Banque de certificats personnels Windows, et qui doit servir à l'authentification dans le service.
Remplacement du protocole de communication du service Windows par HTTP ou HTTPS
La méthode de communication entre le client IBM Cognos Incentive Compensation Management et le service Windows peut être modifiée en communication HTTP ou HTTPS si vous éditez les paramètres du fichier de configuration du service
Windows et le fichier de configuration du client. Par défaut, le protocole TCP est utilisé.
Procédure
1. Dans le fichier de configuration du service Windows de Cognos Incentive Compensation Management, annulez la mise en commentaire de la section HTTP Communication modeet mettez en commentaire la section TCP Communication mode.
2. Pour utiliser le protocole de communication HTTP, affectez au paramètre SecurityModela valeur None.
3. Pour utiliser le protocole de communication HTTPS, affectez au paramètre SecurityModela valeur TLS.
a. Remplacez les valeurs de HttpsDefaultUsernameet HttpsDefaultPassword par le nom et le mot de passe utilisés pour l'authentification de
l'environnement et de la base de données Cognos Incentive Compensation Management.
4. Remplacez les valeurs des paramètres CommunicationModeet SecurityModedu fichier de configuration du client par celles du fichier de configuration du service Windows. Si vous utilisez le protocole de communication HTTPS, remplacez les valeurs des paramètres HttpsDefaultUsernameet
HttpsDefaultPassworddu fichier de configuration du client par celles du fichier de configuration du service Windows.
Important : Le mode de sécurité choisi doit être le même pour le service Windows de Cognos Incentive Compensation Management (fichier
Service.exe.config du service Windows d'IBM Cognos ICM) et le client (fichier ICM.exe.config d'IBM Cognos). Les deux fichiers doivent être mis à jour de façon concordante.
Configuration des paramètres
Après avoir configuré l'accès aux bases de données, vous pouvez configurer les paramètres de Scheduler et de Task Manager dans le fichier de configuration du service Windows de IBM Cognos Incentive Compensation Management.
Procédure
1. A la section ICM, éditez les valeurs de SchedulerUser et de SchedulerPassword pour les faire correspondre à l'ID utilisateur et au mot de passe de l'utilisateur doté du rôle Scheduler dans la fenêtre Gérer les utilisateurs dans le client Cognos Incentive Compensation Management. Si les paramètres SchedulerUser et SchedulerPasswordne sont pas mis à jour dans cette section après avoir été modifiés dans le client, les processus planifiés ne s'exécutent pas.
Important : Pour exécuter Scheduler, le service Windows de Cognos Incentive Compensation Management doit être lancé en tant que service Windows. Avant de planifier un processus, assurez-vous que Scheduler et le service Windows de l'API Cognos Incentive Compensation Management sont démarrés.
2. Vous pouvez mettre à jour l'emplacement du journal Scheduler dans le paramètre SchedulerLogPath. Par défaut, ce journal est dans le répertoire Service. Le paramètre SchedulerLogPathdoit être mis à jour si le service Windows n'est pas installé dans le répertoire par défaut.
3. Vous pouvez mettre à jour l'emplacement du journal Task Manager dans le paramètre TaskManagerLogPath. Par défaut, ce journal est dans le répertoire Service. Le paramètre TaskManagerLogPathdoit être mis à jour si le service Windows n'est pas installé dans le répertoire par défaut.
4. La valeur de AllowAnonymousModelCreation permet d'autoriser les administrateurs à créer de nouveaux modèles. La valeur Falseinterdit la création de nouveaux modèles.
5. La valeur de Languagepermet de définir la langue à utiliser dans les journaux du module Audit.
v Si vous définissez EnglishUSpour Language, le format de date est month/day/year.
v Si vous définissez EnglishGBpour Language, le format de date est day/month/year.
6. Vous pouvez annuler la mise en commentaire de la section Saved Import File Directory et l'éditer pour la faire pointer vers l'emplacement dans lequel Cognos Incentive Compensation Management recherche les fichiers source pour ses importations de données. Ce paramètre doit être défini avant toute
importation de données dans Cognos Incentive Compensation Management, et doit faire référence à un répertoire situé sur le même ordinateur que le service Windows.
7. Vous pouvez annuler la mise en commentaire de la section Saved Publisher File Directoryet l'éditer pour la faire pointer vers l'emplacement dans lequel Cognos Incentive Compensation Management place les fichiers publiés dont la publication est planifiée dans Scheduler. Ce paramètre doit être défini avant toute planification d'une publication, et il doit faire référence à un répertoire situé sur le même ordinateur que le service Windows.
8. Vous pouvez annuler la mise en commentaire de la section Saved Image File Directory et l'éditer pour la faire pointer vers l'emplacement dans lequel Cognos Incentive Compensation Management recherche les fichiers image à utiliser comme graphiques d'en-tête pour la publication planifiée des PDF. Ce paramètre doit faire référence à un répertoire situé sur le même ordinateur que le service Windows.
Configuration des outils externes
La section External Toolsdétermine les éléments qui peuvent être utilisés pour planifier et exécuter des processus qui existent hors de IBM Cognos Incentive Compensation Management. Les outils externes auxquels s'appliquera la planification de Scheduler doivent figurer dans la section External Tools.
Procédure
1. Annuler la mise en commentaire de ExternalToolDirectory éditez cette valeur pour la faire pointer vers l'emplacement dans lequel Cognos Incentive
Compensation Management recherche les éléments exterieurs à lui-même.
2. Pour modifier la durée maximale d'exécution allouée aux outils par Scheduler, cliquez sur le bouton Propriétés du module Scheduler dans le client Cognos Incentive Compensation Management. Une fois ce temps écoulé, Scheduler reprend sa liste d'actions à effectuer.
Stockage des requêtes de calcul et des exceptions dans les fichiers journaux
IBM Cognos Incentive Compensation Management permet de configurer le nombre maximal de fichiers journaux et la taille de chacun d'eux.
Pourquoi et quand exécuter cette tâche
Les fichiers journaux sont stockés sur le disque. Si le nombre de fichiers journaux atteint la limite, le plus ancien est supprimé.
Procédure
1. Ouvrez le fichier service.exe.config du service Windows d'IBM Cognos ICM.
2. Annulez la mise en commentaire des sections suivantes :
v Calculation Log Folder v Calculation Log File Number
v Calculation Log File Size in Kilobyte
3. A la section Calculation Log Folder, définissez l'emplacement dans lequel les fichiers journaux doivent être stockés.
4. A la section Calculation Log File Number, définissez le nombre maximal de fichiers journaux autorisé pour chaque modèle.
5. A la section Calculation Log File Size in Kilobyte, définissez la taille maximale, en kilooctets, de chaque fichier journal.
Configuration des paramètres SSL de la messagerie
Dans IBM Cognos Incentive Compensation Management, si le serveur est configuré pour envoyer des courriers électroniques, la connexion au serveur de messagerie peut être chiffrée avec SSL (Secure Sockets Layer).
Procédure
1. Annulez la mise en commentaire de la ligne située sous Email SSL Settings.
2. Affectez la valeur Trueau paramètre EnableSSLForServerEmails.
Configuration des paramètres de messagerie pour Portal Access et Scheduler
Pour utiliser le service de rappel par courrier électronique de Portal Access, les paramètres de messagerie doivent être configurés dans le fichier de configuration du service Windows de IBM Cognos Incentive Compensation Management. Le client Web utilise aussi le service de rappel par courrier électronique de Portal Access pour envoyer des messages provenant de Scheduler.
Pourquoi et quand exécuter cette tâche
Procurez-vous les informations relatives au serveur de messagerie de votre organisation auprès de l'administrateur du système.
Le client Web Cognos Incentive Compensation Management utilise l'adresse électronique et le serveur définis dans le fichier de configuration du service Windows de Cognos Incentive Compensation Management pour envoyer des courriers provenant de Scheduler, par exemple, en cas d'échec d'une tâche dans Portal Access ou lorsqu'un administrateur force l'approbation d'une période.
La zone d'origine de smtp contient généralement l'adresse électronique de
l'administrateur. Les courriers électroniques générés par Portal Access sont envoyés depuis l'adresse contenue dans cette zone.
Procédure
Pour envoyer des adresses électroniques depuis Portal Access, éditez la section suivante du fichier de configuration du service Windows de Cognos Incentive Compensation Management :
<system.net>
<mailSettings>
<smtp from="softco@softco.com">
<!-- Set defaultCredentials="false" if using SSL for Email -->
<network host="mail.softco.com" port="25" userName="username" password="password"
defaultCredentials="true"/>
</smtp>
</mailSettings>
</system.net>
Configuration des paramètres de messagerie de Portal Access pour signaler aux utilisateurs les validations en attente
Vous pouvez envoyer aux utilisateurs des courriers électroniques pour les avertir des validations et des demandes en attente dans le client Web de IBM Cognos Incentive Compensation Management.
Procédure
1. Ouvrez en édition le fichier de configuration du service.
v Si vous utilisez le service Windows de Cognos Incentive Compensation Management, ouvrez le fichier de configuration de ce service.
v Si vous utilisez le service de la console, ouvrez le fichier de configuration de ce service.
2. Pour configurer Portal Access de manière à envoyer des courriers électroniques aux utilisateurs lorsqu'une validation est en attente, éditez la section suivante du fichier de configuration :
<system.net>
<mailSettings>
<smtp from="softco@softco.com">
<!-- Set defaultCredentials="false" if using SSL for Email -->
<network host="mail.softco.com" port="25" userName="username"
password="password" defaultCredentials="true"/>
</smtp>
</mailSettings>
</system.net>
3. Dans le client, cliquez sur Admin > Options d'administration.
4. Sous l'onglet Portal Access, sélectionnez Envoyer un courrier électronique aux utilisateurs lorsqu'unevalidation est en attente.
5. Cliquez sur OK.
Configuration des paramètres de messagerie de Portal Access pour signaler aux utilisateurs les demandes en attente
Vous pouvez envoyer aux utilisateurs des courriers électroniques pour les avertir des demandes en attente dans le client Web de IBM Cognos Incentive
Compensation Management.
Pourquoi et quand exécuter cette tâche
Les courriers électroniques envoyés aux utilisateurs lorsque des demandes sont en attente sont initiés par le client Web de Cognos Incentive Compensation
Management. Les paramètres de messagerie doivent donc être configurés dans le fichier mail.properties. Le fichier mail.propertiesse trouve dans le répertoire suivant : ...\webapps\IBM Cognos ICM\WEB-INF.
Procédure
1. Pour configurer Portal Access de manière à envoyer des courriers électroniques aux utilisateurs lorsqu'une demande est en attente, éditez la section suivante du fichier mail.properties.
mail.host=smtp.yourdomain.com mail.port=25
mail.username=username mail.password=secret
mail.from=varicent@yourdomain.com
2. Dans le client, cliquez sur Admin > Options d'administration.
3. Sous l'onglet Portal Access, sélectionnez Envoyer un courrier électronique aux utilisateurs lorsqu'une demande est en attente.
4. Cliquez sur OK.
5. Après avoir édité le fichier de configuration mail.properties, rechargez le fichier ICM.war.
Définition de l'adresse électronique de l'administrateur
L'adresse électronique de l'administrateur IBM Cognos Incentive Compensation Management doit être définie dans le client.
Procédure
1. Connectez-vous au client Cognos Incentive Compensation Management.
2. Cliquez sur Administration > Gérer les utilisateurs.
3. Sélectionnez l'administrateur.
4. Cliquez sur Editer.
5. Définissez l'adresse électronique.
Configuration des paramètres de mobilité
IBM Cognos Incentive Compensation Management peut être configuré pour envoyer des données à des ordinateurs de poche.
Procédure
1. Pour activer la configuration de la mobilité des ordinateurs de poche dans Cognos Incentive Compensation Management, affectez la valeur Trueau paramètre EnableHandheldet annulez la mise en commentaire de la ligne.
2. Vous pouvez éditer la valeur de MobileDataSynchFrequencypour définir la fréquence (en secondes) de synchronisation des données d'un ordinateur de poche qui exécute Cognos Incentive Compensation Management Mobile avec les données du service de l'API Cognos Incentive Compensation Management, par exemple, 3600.
Mises à niveau
L'application IBM Cognos Incentive Compensation Management peut être mise à jour avec les derniers correctifs et les améliorations.
Il y a deux manières d'effectuer une mise à niveau : réaliser une mise à niveau standard pour remplacer l'installation initiale, ou installer un nouveau service qui s'exécute en parallèle avec l'installation initiale.
Mises à niveau standard
Une mise à niveau standard remplace la version existante de IBM Cognos Incentive Compensation Management par une nouvelle version du produit.
Par exemple, si vous effectuez une mise à niveau de la version 7 à la version 8, la version 7 n'est plus disponible sur votre ordinateur après la mise à niveau. Si vous mettez à niveau un modèle plus ancien que la version 8.1.0, supprimez la version précédente de Cognos Incentive Compensation Management avant d'installer la nouvelle version. Lorsque vous mettez à niveau des modèles version 8.1.0 ou plus récents, le processus de mise à jour remplace la version existante.
Tous les outils et les composants de Cognos Incentive Compensation Management doivent être à la même version. Pour cette raison, même les outils facultatifs, tels que le module d'extension de Cognos Incentive Compensation Management pour Microsoft Excel et l'interface graphique de Cognos Incentive Compensation Management, doivent être retirés et remplacés par leur nouvelle version.
Préparation de la mise à niveau
Avant de mettre à niveau votre installation IBM Cognos Incentive Compensation Management, vous devez la préparer pour garantir le succès de l'opération.
Pourquoi et quand exécuter cette tâche
Sauvegardez les modèles Cognos Incentive Compensation Management avant de procéder à la mise à niveau. Enregistrez une copie des fichiers de configuration pour pouvoir comparer leurs paramètres d'environnement et de base de données avec ceux de la nouvelle version. Lors de la mise à niveau, vous devrez mettre à jour manuellement les paramètres des fichiers de configuration de Cognos Incentive Compensation Management et de son service Windows.
Important : Les tentatives de mise à niveau des modèles contenant des schémas en étoile créés avec des calculs se soldent par des messages d'erreur. A partir de la version 8.0.4, les schémas en étoile doivent être créés avec des magasins de données. Avant de mettre à niveau votre modèle, vous devez supprimer les schémas en étoile créés avec des calculs et les recréer avec des magasins de données.
Procédure
1. Sauvegardez les fichiers de configuration. Si vous mettez à niveau une version existante de Cognos Incentive Compensation Management, vous devez
sauvegarder les fichiers suivants : v ICM.exe.config d'IBM Cognos
v service.exe.config du service Windows d'IBM Cognos ICM v jdbc.properties
Important : Les fichiers de configuration existants ne sont pas utilisables avec une version mise à niveau.
2. Désinstallez la version en place de Cognos Incentive Compensation
Management, de son serveur d'applications, du client, du programme de mise à niveau des modèles, et de tous les autres outils Cognos Incentive
Compensation Management, tels que le module d'extension de Cognos
Incentive Compensation Management pour Microsoft Excel, l'interface de ligne de commande de Cognos Incentive Compensation Management et le
programme de chiffrement des fichiers de configuration.
Si vous mettez à niveau un modèle version 8.1.0 ou plus récent, il n'est pas nécessaire de désinstaller la version actuelle. A partir de la version 8.1.0, le processus de mise à niveau remplace la version actuelle.
3. Sauvegardez vos modèles Cognos Incentive Compensation Management.
Sauvegarde et restauration de la base de données Microsoft SQL Server
La sauvegarde de la base de données duplique toutes les données de la base IBM Cognos Incentive Compensation Management et en crée une copie complète.
La base de données peut ensuite être recrée dans son ensemble à l'aide de la commande restore. La base de données restaurée est une copie parfaite de la base d'origine telle qu'elle était à la fin de la sauvegarde.
Sauvegarde d'une base de données :
Vous pouvez utiliser Microsoft SQL Server Enterprise Manager pour sauvegarder la base de données IBM Cognos Incentive Compensation Management.
Procédure
1. Dans Microsoft SQL Server Enterprise Manager, cliquez sur Outils >
Sauvegarder la base de données.
2. Sélectionnez l'un des types de sauvegarde suivants : Complete backup
Effectue une sauvegarde complète de la base de données. Commencez votre procédure de sauvegarde par une sauvegarde complète de votre base de données.
Sauvegarde différentielle
Enregistre toutes les modifications réalisées depuis la dernière sauvegarde complète.
3. Vous pouvez modifier l'emplacement du fichier de sauvegarde. Par défaut, le fichier de sauvegarde est stocké à l'emplacement suivant : C:\Program Files\Microsoft SQL Server\MSSQL\BACKUP\.
Conseil : La base de données peut rester en ligne et accessible aux utilisateurs pendant la sauvegarde.
Restauration d'une sauvegarde de base de données :
Dans le fichier de sauvegarde, Microsoft SQL Server stocke le nom et
l'emplacement des fichiers utilisés dans la base de données IBM Cognos Incentive Compensation Management. Après la restauration de la base de données, SQL Server recrée tous les fichiers nécessaires, et la base de données est restaurée telle qu'elle était au moment de la sauvegarde.
Procédure
1. Dans Microsoft SQL Server Enterprise Manager, cliquez sur Outils > Restaurer la base de données.
2. La zone Restaurer en tant que base de données est le nom de la nouvelle base de données qui vient d'être restaurée. Elle ne doit pas obligatoirement porter le nom de la base de données d'origine (la base de données sauvegardée).
3. Pour définir les paramètres de la restauration, sélectionnez le nom de la base de données d'origine et la sauvegarde stockée à restaurer.
Utilisation de la fonction de sauvegarde et restauration pour transférer des bases de données entre des serveurs :
Pour restaurer une sauvegarde d'une base de données IBM Cognos Incentive Compensation Management sur un nouveau serveur, vous devez créer la
sauvegarde et l'enregistrer à un emplacement accessible depuis le serveur cible de la restauration.
Procédure
1. Sur le serveur sur lequel vous voulez transférer la base de données, ouvrez Enterprise Manager.
2. Cliquez sur Tools > Restaurer la base de données.
3. Entrez le nom choisi pour la base de données restaurée dans la zone Restaurer en tant que base de données.
4. Sélectionnez l'option A partir d'une unité.
5. Sélectionnez le nom de fichier et entrez l'emplacement du fichier de sauvegarde.
Mise à niveau de l'application
Après avoir suivi la procédure de mise à niveau, vous pouvez installer la nouvelle version de IBM Cognos Incentive Compensation Management.
Procédure
1. Installez le client Cognos Incentive Compensation Management.
Pour plus d'informations, reportez-vous à la rubrique «Installation du client», à la page 7.
2. Installez le service Windows de Cognos Incentive Compensation Management en sélectionnant l'option Gérer ou mettre à niveau une instance existante.
Pour plus d'informations, reportez-vous à la rubrique «Installation du service Windows», à la page 7.
3. Editez les fichiers ICM.exe.config d'IBM Cognoset Service.exe.config du service Windows d'IBM Cognos ICM de sorte qu'ils soient identiques aux versions sauvegardées du modèle précédent.
Pour plus d'informations, reportez-vous à la rubrique «Fichiers de configuration», à la page 8.
4. Installez les autres outils Cognos Incentive Compensation Management, par exemple l'interface CLI.
Mise à niveau des modèles
Vous pouvez utiliser le programme de mise à niveau des modèles de IBM Cognos Incentive Compensation Management pour mettre à niveau les modèles et les rendre compatibles avec la version mise à niveau.
Après avoir mis à niveau une version existante de Cognos Incentive Compensation Management, vous devez mettre à niveau les modèles dans la nouvelle version.
Les options de mise à niveau vous permettent de contrôler le processus de mise à niveau des modèles Microsoft SQL Server et de réduire la taille des fichiers journaux des transactions sur Microsoft SQL Server.
Conseil : Dans le cas d'une nouvelle installation de Cognos Incentive
Compensation Management, la mise à niveau des modèles n'est pas nécessaire. Les modèles ne doivent être mis à niveau qu'en cas de mise à niveau de Cognos Incentive Compensation Management.
Installation du programme de mise à niveau des modèles
Le programme de mise à niveau des modèles est nécessaire pour rendre le modèle IBM Cognos Incentive Compensation Management compatible avec votre
application mise à niveau.
Pourquoi et quand exécuter cette tâche
Si une ancienne version du programme de mise à niveau des modèles est installée, vous devez la retirer avant d'installer la nouvelle. Si vous mettez à niveau un modèle version 8.1.0 ou plus récent, il n'est pas nécessaire de désinstaller la version
actuelle. A partir de la version 8.1.0, le processus de mise à niveau remplace la version actuelle.
Procédure
1. Cliquez deux fois sur le fichier d'installation ICM-modelupgrader.exesitué dans le dossier de votre version.
2. Suivez les étapes de l'assistant d'installation.
Exécution du programme de mise à niveau des modèles
Une fois le programme de mise à niveau des modèles installé, vous devez
l'exécuter pour mettre à niveau le modèle en cours et le rendre compatible avec la nouvelle version de IBM Cognos Incentive Compensation Management.
Procédure
1. Dans l'emplacement spécifié lors de l'installation de l'outil Programme de mise à niveau des modèles, cliquez deux fois sur le fichier ICM-modelupgrader.exe. 2. Dans l'outil Programme de mise à niveau des modèles, entrez le nom du
serveur. Il s'agit du nom du serveur de base de données contenant le modèle. Si la base de données est une instance Microsoft SQL Server 2000 nommée, ou si vous utilisez une base de données Microsoft SQL Server 2005, la valeur de la zone DBServer doit être au format suivant : SERVER_NAME\INSTANCE_NAME.
3. Sélectionnez le type de base de données dans le menu. Il s'agit du type de la base de données à laquelle vous vous connectez (par exemple, Microsoft SQL Server 2000 ou 2005).
4. Entrez le nom de la base de données. Il s'agit du nom de la base de données qui contient le modèle Cognos Incentive Compensation Management.
a. Si vous ne connaissez pas le nom de la base de données, cliquez sur Browse.
b. Sélectionnez un modèle.
5. Entrez une valeur dans la zone de délai d'attente de la base de données. La valeur par défaut est 90 secondes et ne nécessite probablement pas de modification. Vous devez cependant la modifier à cet endroit si vous avez augmenté la valeur par défaut du délai d'attente dans le fichier de
configuration du service Windows de Cognos Incentive Compensation Management.
6. Entrez votre ID utilisateur et votre mot de passe. Il s'agit de l'identifiant de l'utilisateur qui possède les droits de modification sur la base de données. Ce n'est pas le même que le mot de passe administrateur de Cognos Incentive Compensation Management.
7. Cliquez sur Upgrade.
Options du programme de mise à niveau des modèles
Si vous cliquez sur le bouton Options lors de l'exécution de l'outil Programme de mise à niveau des modèles dans IBM Cognos Incentive Compensation
Management, vous pouvez définir la protection contre les erreurs.
Les options suivantes sont disponibles pour la protection des erreurs : Aucune
Cette option utilise le minimum de ressources, mais n'offre aucune protection au modèle en cas d'erreur. Si une erreur se produit pendant la mise à niveau, le modèle concerné est irrécupérable et doit être restauré à partir d'une sauvegarde.