Esri Maps for IBM Cognos

В этом разделе
  1. Установите Esri Maps for IBM Cognos
  2. Настройка Esri Maps for IBM Cognos
  3. Запуск EM4C Server
  4. Настройка веб-сервера
  5. Перезапустите сервис IBM Cognos
  6. Задать функцию Esri Maps for IBM Cognos
  7. Протестируйте конфигурацию

Установка и настройка на отдельном компьютере

Установите Esri Maps for IBM Cognos

Полная установка Esri Maps for IBM Cognos включает в себя установку компонентов на вашем сервере и их настройку для работы в вашей среде. Перед началом убедитесь в том, что вам известны параметры установки, и что у вас имеется надлежащий установщик для операционной системы, в которой будет производиться установка.

Следующие шаги должны быть выполнены администратором.

  1. В директории em4c на установочном носителе, запустите файл пакетной установки (.bat). Например:

    G:\em4c\launchInstaller.bat

  2. На странице Добро пожаловать нажмите Далее.
  3. Если вы согласны с условиями лицензионного соглашения, нажмите Далее; в противном случае нажмите Выйти.
  4. Выберите путь для установки и нажмите Далее.
  5. Выберите версию IBM Cognos, на которую будет устанавливаться Esri Maps for IBM Cognos, и нажмите Далее.
  6. Убедитесь в том, что выбраны EM4C Gateway, EM4C Dispatcher и EM4C Server, затем щелкните Далее.
  7. Укажите директорию webcontent для IBM Cognos Gateway и щелкните Далее.
  8. Укажите директорию для IBM Cognos Dispatcher и щелкните Далее.
  9. Нажмите Далее, чтобы продолжить процесс установки.
  10. Дождитесь завершения копирования файлов в указанное местоположение и нажмите Далее.
  11. Дополнительно щелкните Создать сценарий автоматической инсталляции, чтобы сохранить XML-файл со всеми параметрами, которые были заданы на предыдущих страницах.
  12. Щелкните Готово.

Настройка Esri Maps for IBM Cognos

Перед тем, как вы начнете выполнять следующие шаги, убедитесь, что вам известны доступные параметры конфигурации.

Запустите конфигурацию Esri Maps for IBM Cognos от имени пользователя с правами доступа администратора.

  1. Перейдите к директории <em4c_location>\bin и запустите configure.bat.
  2. В окне настройки Проводник щёлкните Локальная конфигурация.
  3. Измените параметры локальной конфигурации так, чтобы она соответствовала вашей среде (например, часть имени хоста любого URI следует изменить с localhost на IP-адрес или сетевое имя хоста). Приложение Конфигурация Esri Maps for IBM Cognos распознает, какие из компонентов EM4C установлены, и выведет список именно тех параметров конфигурации, которые необходимо установить.
  4. Нажмите кнопку Применить.
  5. В меню Файл выберите Выход.

Запуск EM4C Server

Необходимо запустить EM4C Server Esri Maps for IBM Cognos для всех местоположений, где были установлены компоненты EM4C Server.

EM4C Server работает как служба и по умолчанию настроен на автоматический запуск (его можно запустить вручную с помощью консоли Microsoft Management Console).

Настройка веб-сервера

Чтобы Esri Maps for IBM Cognos и IBM Cognos могли взаимодействовать, необходимо создать виртуальные директории (псевдонимы), указанные в следующей таблице. Предполагается, что IBM Cognos обозначен на веб-сервере как ibmcognos (измените, в соответствии с вашей средой).

ПсевдонимМестоположение

ibmcognos\em4c

<em4c_location>\webcontent

ibmcognos\em4c\cgi-bin

<em4c_location>\cgi-bin или <em4c_location>\cgi-bin-64bit, в зависимости от среды (x86 или x64)

Виртуальные директории Esri Maps for IBM Cognos

Дополнительные сведения о конфигурации веб-сервера см. в разделе О настройке веб-сервера.

Перезапустите сервис IBM Cognos

Изменения, внесенные в Esri Maps for IBM Cognos Configuration, требуют перезапуска службы IBM Cognos на всех компьютерах с IBM Cognos Dispatcher, на которых работают сервисы отчетов и/или презентаций.

См. Руководство по установке и конфигурации IBM Cognos для вашей версии IBM Cognos, чтобы получить подробную информацию по перезапуску сервиса IBM Cognos.

К этому моменту все авторы отчетов Esri Maps for IBM Cognos и конечные пользователи должны очистить кэш веб-браузеров. В различных браузерах это происходит по-разному, но в большинстве случаев используется комбинация Ctrl+Shift+Delete.

Задать функцию Esri Maps for IBM Cognos

Чтобы включить возможность использования Esri Maps for IBM Cognos, необходимо создать функцию Esri Maps. Пользователи, не имеющие необходимых прав для доступа к этой функции, не смогут использовать Esri Maps Designer или просматривать Esri Maps в отчетах, содержащих карты.

Системный администратор IBM Cognos создает эту функцию, открыв Esri Maps Designer из меню Запуск в Cognos Connection. Когда вы создаете функцию Esri Maps, пользователи и группы добавляются на основе настроек функций Cognos по умолчанию, этим группам и пользователям предоставляются права просмотра и выполнения Esri Maps for IBM Cognos. Чтобы отключить использование Esri Maps for IBM Cognos, удалите права выполнения для данных пользователей или групп. Права доступа можно изменить в Cognos Administration.

  1. Чтобы создать функциональную возможность Esri Maps, выполните следующие шаги:
    1. Войдите в IBM Cognos в качестве системного администратора.
    2. Откройте Cognos Connection.
    3. В меню Запустить выберите Esri Maps Designer.

    Функция создана.

  2. Для управления правами пользователей и групп, выполните следующие шаги:
    1. Откройте Cognos Administration.
    2. Добавьте или удалите пользователей или группы, или измените права доступа как необходимо.

Протестируйте конфигурацию

После установки и настройки Esri Maps for IBM Cognos, очистите кэш веб-браузера(Ctrl+Shift+Delete на большинстве браузеров), если вы этого еще не сделали. Вы можете попробовать различные способы установки и настройки.

В следующих примерах предполагается, что IBM Cognos обозначается псевдонимом ibmcognos.

  1. Проверьте, обращается ли EM4C Server к указанному порту. Обратите внимание, что предполагается использование порта по умолчанию 9896 (измените при необходимости): 
    http://<em4c_server>:9896/em4c/version.txt

    Если этот тест не проходит, убедитесь, что EM4C Server запущен везде, где он установлен.

  2. Выполните следующие тесты, чтобы убедиться, что EM4C Gateway работает как ожидается:
    1. Проверьте, что виртуальная директория веб-сервера em4c (псевдоним) задана правильно (это также позволят проверить, что кнопка Применить была нажата при настройке Esri Maps for IBM Cognos):
      http://<cognos_gateway>/ibmcognos/em4c/version.txt
    2. Проверьте, что скрипт EM4C Gateway CGI работает правильно (подключается к серверу EM4C Server). Если он работает, пройдя по следующему URL-адресу, вы увидите в браузере сообщение с отметкой времени: 
      http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi
    3. Проверьте, может ли скрипт EM4C Gateway CGI подключиться ко внешним ресурсам. Например, каждый из следующих URL должен возвращать объект JSON, который описывает версию ПО, установленного на сервер.

      ArcGIS Online:

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

      Экземпляр Portal for ArcGIS:

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

      Если проверка прошла успешно, возвратиться название текущей версии, например, "currentVersion":"x.x".

  3. EM4C Dispatcher запускается в пространстве процесса IBM Cognos, вручную можно выполнить только ограниченный набор проверок. Один из способов проверки, что EM4C Dispatcher установлен и настроен правильно, состоит в том, чтобы запустить Cognos Connection и проверить, появляется ли Esri Maps Designer в меню Запуск.