Esri Maps for IBM Cognos (Archive v6.0.2)

Dans cette rubrique
  1. Installer Esri Maps for IBM Cognos
  2. Configurer Esri Maps for IBM Cognos
  3. Démarrer le serveur EM4C
  4. Configurer le serveur Web
  5. Redémarrer le service IBM Cognos
  6. Créer la fonctionnalité Esri Maps for IBM Cognos
  7. Tester la configuration.

Cette archive est relative à une version précédente d'Esri Maps for IBM Cognos. La version actuelle est disponible sur cette page : http://doc.arcgis.com/fr/maps-for-cognos/

Installer et configurer sur un seul ordinateur

Installer Esri Maps for IBM Cognos

Pour effectuer une installation complète d'Esri Maps for IBM Cognos, vous devez installer des composants sur votre serveur, puis les configurer afin qu'ils fonctionnent dans votre environnement. Avant de commencer, vous devez connaître les options d'installation et vérifier que vous possédez le programme d'installation approprié au système d'exploitation sur lequel vous allez réaliser l'installation.

Il est recommandé de réaliser les étapes suivantes en tant qu'utilisateur propriétaire de l'emplacement d'installation d'IBM Cognos.

Installez les composants Esri Maps for IBM Cognos dans un répertoire dont le chemin d'accès renferme uniquement des caractères ASCII.

Sous les plates-formes Linux et UNIX, les installations et les configurations interactives s'effectuent généralement à partir d'une station de travail X Window System (X11), d'un terminal X ou d'un PC sur lequel un logiciel de serveur X est installé. Vérifiez que le transfert X11 est configuré correctement avant d'installer le logiciel.

  1. Dans le terminal, localisez le répertoire em4c sur le support d'installation et exécutez le script d'environnement d'exécution du programme d'installation (.sh). Par exemple :

    [cognosuser@server1]$ ./launchInstaller.sh

  2. Sur la page Bienvenue, cliquez sur Suivant.
  3. Si vous acceptez les termes du contrat de licence, cliquez sur Suivant. Sinon, cliquez sur Quitter pour quitter l'installation.
  4. Sélectionnez le dossier d'installation, puis cliquez sur Suivant.
  5. Sélectionnez la version d'IBM Cognos sur laquelle Esri Maps for IBM Cognos va être installé, puis cliquez sur Suivant.
  6. Assurez-vous que les composants Passerelle EM4C, Répartiteur EM4C et Serveur EM4C sont sélectionnés, puis cliquez sur Suivant.
  7. Spécifiez le répertoire de la passerelle IBM Cognos webcontent et cliquez sur Suivant.
  8. Spécifiez le répertoire du répartiteur IBM Cognos et cliquez sur Suivant.
  9. Cliquez sur Suivant pour poursuivre l'installation.
  10. Attendez que les fichiers soient copiés à l'emplacement spécifié, puis cliquez sur Suivant.
  11. Vous pouvez également cliquer sur l'option de génération d'un script d'installation automatique pour enregistrer un fichier XML contenant tous les paramètres que vous avez définis dans les pages précédentes.
  12. Cliquez sur Terminé.
  13. Accédez à em4c_location/bin et entrez ce qui suit :
    [cognosuser@server1]$ chmod +x setPermissions.sh
[cognosuser@server1]$ ./setPermissions.sh

Configurer Esri Maps for IBM Cognos

Avant de suivre les étapes ci-dessous, vous devez connaître les paramètres de configuration disponibles.

Sous les plates-formes Linux et UNIX, les installations et les configurations interactives s'effectuent généralement à partir d'une station de travail X Window System (X11), d'un terminal X ou d'un PC sur lequel un logiciel de serveur X est installé. Vérifiez que le transfert X11 est configuré correctement avant d'installer le logiciel.

Exécutez la configuration d'Esri Maps for IBM Cognos en tant qu'utilisateur doté des privilèges d'administrateur.

  1. Localisez le répertoire em4c_location/bin et exécutez ./configure.sh.
  2. Dans la fenêtre Explorateur, cliquez sur Configuration locale.
  3. Modifiez les paramètres de la configuration locale afin qu'ils reflètent votre environnement (par exemple, la partie du nom d'hôte des URI "localhost" doit être remplacée par une adresse IP ou un nom d'hôte réseau). L'application de configuration Esri Maps for IBM Cognos reconnaît les composants EM4C qui sont installés et répertorie uniquement les paramètres de configuration qui doivent être définis.
  4. Cliquez sur Appliquer.
  5. Dans le menu Fichier, cliquez sur Quitter.

Démarrer le serveur EM4C

Le serveur EM4C Esri Maps for IBM Cognos doit être démarré pour tous les emplacements dans lesquels le composant Serveur EM4C a été installé.

Le processus du serveur EM4C est démarré et arrêté à l'aide des scripts d'environnement d'exécution suivants.

  • Démarrer : start-em4c.sh
  • Arrêter : stop-em4c.sh

Par exemple :

[cognosuser@server1]$ cd /opt/em4c/bin 
[cognosuser@server1]$ ./start-em4c.sh

ou

[cognosuser@server1]$ /opt/em4c/bin/start-em4c.sh

Ces scripts se situent dans em4c_location/bin et doivent être exécutés en tant qu'utilisateur propriétaire de l'emplacement d'installation d'Esri Maps for IBM Cognos.

Pour démarrer automatiquement le processus Esri Maps for IBM Cognos sur Linux et UNIX, vous devez configurer le processus en tant que démon. Pour plus d'informations, consultez la documentation du système d'exploitation.

Configurer le serveur Web

Pour qu'Esri Maps for IBM Cognos et IBM Cognos puissent communiquer, vous devez créer les répertoires virtuels (alias) répertoriés dans le tableau suivant. Notez qu'IBM Cognos est censé être exposé sur votre serveur Web en tant que ibmcognos (modifiez ce paramètre en fonction de votre environnement).

AliasEmplacement

ibmcognos/em4c

em4c_location/webcontent

ibmcognos/em4c/cgi-bin

em4c_location/cgi-bin ou em4c_location/cgi-bin-64bit, selon votre environnement (x86 ou x64)

Répertoires virtuels d'Esri Maps for IBM Cognos

Pour en savoir plus sur la configuration du serveur Web, reportez-vous à la rubrique A propos de la configuration du serveur Web.

Redémarrer le service IBM Cognos

Les modifications appliquées à la configuration d'Esri Maps for IBM Cognos exigent le redémarrage du service IBM Cognos sur tous les ordinateurs répartiteurs IBM Cognos exécutant le service de rapports ou le service Presentation.

reportez-vous au Guide d'installation et de configuration d'IBM Cognos de votre version d'IBM Cognos pour obtenir des détails sur la façon de redémarrer le service IBM Cognos.

A ce stade, tous les auteurs de rapports Esri Maps for IBM Cognos et les utilisateurs doivent effacer le cache de leur navigateur Web. Les instructions se rapportant à cette opération varient selon les navigateurs, mais Ctrl+Maj+Suppr fonctionne sur la plupart d'entre eux.

Créer la fonctionnalité Esri Maps for IBM Cognos

Pour permettre l'utilisation de Esri Maps for IBM Cognos, vous devez d'abord créer la fonctionnalité Esri Maps. Les utilisateurs ne disposant pas des autorisations requises pour cette fonctionnalité ne peuvent pas utiliser Esri Maps Designer ni afficher des rapports activés par une carte Esri Maps.

L'administrateur système IBM Cognos crée cette fonctionnalité en ouvrant Esri Maps Designer dans le menu Lancer de Cognos Connection. Lorsque vous créez la fonctionnalité Esri Maps, des utilisateurs et groupes sont ajoutés selon les paramètres par défaut pour les fonctionnalités Cognos et ces utilisateurs et groupes par défaut se voient octroyer des autorisation de cheminement et d'exécution pour Esri Maps for IBM Cognos. Pour désactiver l'utilisation de Esri Maps for IBM Cognos, supprimez les autorisations d'exécution de l'utilisateur ou du groupe en question. Les autorisations se modifient dans Cognos Administration.

  1. Pour créer la fonctionnalité Esri Maps, procédez de la manière suivante :
    1. Connectez-vous à IBM Cognos en tant qu'administrateur système.
    2. Ouvrez Cognos Connection.
    3. Sélectionnez Lancer > Esri Maps Designer.

    La fonctionnalité est créée.

  2. Pour gérer les autorisations pour les utilisateurs et les groupes, procédez de la manière suivante :
    1. Ouvrez Cognos Administration.
    2. Ajoutez ou supprimez des utilisateurs et groupes ou modifiez les autorisations selon vos besoins.

Tester la configuration.

Une fois Esri Maps for IBM Cognos installé et configuré, effacez le cache de votre navigateur Web (Ctrl+Maj+Suppr sur la plupart des navigateurs) si vous ne l'avez pas encore fait. Vous pouvez ensuite tester différents aspects du processus d'installation et de configuration.

Les exemples suivants partent du principe qu'IBM Cognos est exposé par un alias ibmcognos.

  1. Vérifiez que le serveur EM4C écoute sur le port indiqué, comme suit. Notez que le port par défaut 9896 est utilisé (vous pouvez le modifier si vous le souhaitez) : 
    http://<em4c_server>:9896/em4c/version.txt

    Si ce test échoue, vérifiez que le serveur EM4C a démarré dans tous les endroits où il est installé.

  2. Effectuez les tests suivants pour vérifier que la passerelle EM4C fonctionne comme prévu :
    1. Vérifiez que le répertoire virtuel du serveur Web EM4C (alias) est configuré correctement (cette opération permet également de contrôler si Appliquer a été sélectionné dans la configuration d'Esri Maps for IBM Cognos) :
      http://<cognos_gateway>/ibmcognos/em4c/version.txt
    2. Vérifiez que le script CGI de la passerelle EM4C fonctionne correctement (connexion au serveur EM4C). S'il fonctionne, l'URL suivante génère un message avec un horodatage dans le navigateur : 
      http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi
    3. Vérifiez que le script CGI de la passerelle EM4C peut accéder aux ressources externes. Par exemple, chacune des URL suivantes doit retourner un objet JSON décrivant la version du logiciel installé sur le serveur.

      ArcGIS Online :

      http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://www.arcgis.com/sharing?f=pjson

      Instance Portal for ArcGIS :

      http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://myPortal/gis/sharing/?f=pjson

      Si le test réussit, la version actuelle est retournée, par exemple, "currentVersion":"x.x".

  3. Le répartiteur EM4C s'exécute au sein de l'espace de traitement IBM Cognos et seuls des tests limités peuvent être réalisés manuellement. Pour savoir si le répartiteur EM4C est installé et configuré correctement, démarrez Cognos Connection et vérifiez qu'Esri Maps Designer apparaît dans le menu de lancement (Lancer).