Installer et configurer la passerelle EM4C
Affichage: Installer sous WindowsInstaller sous Linux et UNIX
Dans cette rubrique
- Installer la passerelle EM4C
- Configurer la passerelle EM4C
- Configurer le serveur Web
- Tester la configuration.
La passerelle EM4C doit être installée sur chaque ordinateur passerelle IBM Cognos dans votre environnement.
La passerelle EM4C peut être installée et configurée de façon autonome ou en association avec le serveur EM4C et le répartiteur EM4C. Pour plus d'informations, reportez-vous à la rubrique Séquence d'installation des composants serveur. Pour consulter un exemple de déploiement Esri Maps for IBM Cognos, reportez-vous à la rubrique Architecture Esri Maps for IBM Cognos.
Installer la passerelle EM4C
Avant de démarrer l'installation, assurez-vous qu'il y a bien un répertoire de passerelle IBM Cognos sur tous les ordinateurs sur lesquels vous installez la passerelle EM4C.
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.
- 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 - Sur la page Bienvenue, cliquez sur Suivant.
- Si vous acceptez les termes du contrat de licence, cliquez sur Suivant. Sinon, cliquez sur Quitter pour quitter l'installation.
- Sélectionnez le dossier d'installation, puis cliquez sur Suivant.
- Sélectionnez la version d'IBM Cognos sur laquelle Esri Maps for IBM Cognos va être installé, puis cliquez sur Suivant.
- Assurez-vous que seul le composant Passerelle EM4C est sélectionné, puis cliquez sur Suivant.
- Spécifiez le répertoire de la passerelle IBM Cognos webcontent et cliquez sur Suivant.
- Cliquez sur Suivant pour poursuivre l'installation.
- Attendez que les fichiers soient copiés à l'emplacement spécifié, puis cliquez sur Suivant.
- 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.
- Cliquez sur Terminé.
- Accédez à <em4c_location>/bin et entrez ce qui suit :
[cognosuser@server1]$ chmod +x setPermissions.sh [cognosuser@server1]$ ./setPermissions.sh
Configurer la passerelle EM4C
La configuration de la passerelle EM4C nécessite une liste ordonnée des ordinateurs serveurs EM4C de votre environnement, séparés par une virgule. Pour plus d'informations, reportez-vous à la rubrique Configuration.
Exécutez la configuration d'Esri Maps for IBM Cognos en tant qu'utilisateur propriétaire de l'emplacement d'installation d'Esri Maps for IBM Cognos (cet utilisateur doit détenir les droits d'accès READ/WRITE/EXECUTE sur <em4c_location> et sur <ibmcognos_location>).
- Localisez le répertoire <em4c_location>/bin et exécutez ./configure.sh.
- Dans la fenêtre Explorateur, cliquez sur Configuration locale.
- 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.
- Cliquez sur Appliquer.
- Dans le menu Fichier, cliquez sur Quitter.
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).
| Alias | Emplacement |
|---|---|
ibmcognos/em4c | <em4c_location>/webcontent |
ibmcognos/em4c/cgi-bin | <em4c_location>/cgi-bin or <em4c_location>/cgi-bin-64bit, selon votre environnement (x86 ou x64) |
Pour en savoir plus sur la configuration du serveur Web, reportez-vous à la rubrique A propos de la configuration du serveur Web.
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.
- Effectuez les tests suivants pour vérifier que la passerelle EM4C fonctionne comme prévu :
- 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 - 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 - 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=pjsonInstance Portal for ArcGIS :
http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://myPortal/gis/sharing/?f=pjsonSi le test réussit, la version actuelle est retournée, par exemple, "currentVersion":"x.x".
Remarque :
Si les tests ci-dessus ne permettent pas de produire les résultats escomptés, deux raisons sont possibles : la configuration d'Esri Maps for IBM Cognos n'a pas été utilisée (les modifications apportées à la configuration n'ont pas été enregistrées et appliquées) ou le serveur Web n'est pas configuré correctement.
- 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) :
Vous avez un commentaire à formuler concernant cette rubrique ?