Архив для предыдущей версии Esri Maps for IBM Cognos. Если вам требуется текущая версия, пререйдите по ссылке http://doc.arcgis.com/ru/maps-for-cognos/.

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

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

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

Для пользователя, являющегося владельцем установочной директории IBM Cognos, рекомендуется выполнить следующие шаги:

Установите компоненты Esri Maps for IBM Cognos в директорию, путь к которой указан только символами ASCII.

Для платформ Linux и UNIX, интерактивные установки и настройки обычно выполняются с рабочей станции X Window System (X11), терминала X или ПК с установленным программным обеспечением X сервера. Перед установкой убедитесь, что перенаправление X11 установлено корректно.

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

    [cognosuser@server1]$ ./launchInstaller.sh
    

  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. Щелкните Готово.
  13. Перейдите к <em4c_location>/bin и введите следующую команду:
    [cognosuser@server1]$ chmod +x setPermissions.sh
    [cognosuser@server1]$ ./setPermissions.sh
    

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

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

Для платформ Linux и UNIX, интерактивные установки и настройки обычно выполняются с рабочей станции X Window System (X11), терминала X или ПК с установленным программным обеспечением X сервера. Перед установкой убедитесь, что перенаправление X11 установлено корректно.

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

  1. Перейдите к директории <em4c_location>/bin и запустите ./configure.sh.
  2. В окне Explorer щелкните Локальная конфигурация.
  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 осуществляется следующими скриптами.

  • Пуск: start-em4c.sh
  • Останов: stop-em4c.sh

Например:

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

или

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

Эти скрипты расположены в <em4c_location>/bin и их запуск должен производится от имени пользователя – владельца директории установки Esri Maps for IBM Cognos.

Для автоматического запуска процесса Esri Maps for IBM Cognos на Linux и UNIX он должен быть настроен как программа "демон". Более подробная информация имеется в документации к вашей ОС.

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

Чтобы 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 в меню Запуск.