Содержание


Практические рекомендации по IBM Business Analytics

Настройка Microsoft Internet Information Services 7.x для IBM Cognos 10

Продукт(ы): IBM Cognos 10 BI; Область интересов: инфраструктура

Comments

Серия контента:

Этот контент является частью # из серии # статей: Практические рекомендации по IBM Business Analytics

Следите за выходом новых статей этой серии.

Этот контент является частью серии:Практические рекомендации по IBM Business Analytics

Следите за выходом новых статей этой серии.

Назначение

Этот документ поможет читателю настроить IBM Cognos 10 в паре с Internet Information Services (IIS) 7.x.

Он состоит из последовательных разделов, некоторые из которых факультативны. В факультативных разделах описываются способы включения функций, которые не обязательны, но желательны при работе IBM Cognos 10 поверх IIS 7.x. Для успешной установки необходимо выполнить все инструкции каждого из разделов, которые явно не помечены как факультативные.

Область применения

Этот документ относится к установкам IIS 7.x на платформе Windows 2008 Server (GA или R2) и всем версиям IBM Cognos 10 Business Intelligence и/или Enterprise Planning. В этом документе рассматриваются реализации шлюза ISAPI и CGI, так как IIS поддерживает только их.

Исключения и изъятия

Этот документ не охватывает настройку единого входа (SSO) для IBM Cognos 10, основанного на аутентификации IIS. Информацию по этой теме можно получить в Информационном центре IBM Cognos 10, а также из документов IBM Cognos Technotes и информационных ресурсов, опубликованных на веб-сайте developerWorks.

Предположения

В этом документе предполагается, что IIS 7.x предварительно добавлен к ролям Windows 2008 Server и что выбраны все необходимые параметры для успешной работы веб-сайта. Подробности см. в приложении А.

В этом документе также предполагается, что установочный компонент IBM Cognos 10 Gateway успешно установлен на ту же машину, что и IIS.

Настройка пула приложений

Модули шлюза IBM Cognos 10 должны выполняться в контексте пула приложений IIS 7.x. Хотя удобнее просто использовать пул приложений по умолчанию, настоятельно рекомендуется определить для IBM Cognos 10 отдельный, дополнительный пул приложений. Этот пул приложений может использоваться многими продуктами IBM Cognos, такими как IBM Cognos 10 BI, IBM Cognos Enterprise Planning, IBM Cognos TM1 Web или IBM Cognos Executive Viewer.

Настройка контейнера пула приложений

Сначала нужно настроить пул приложений, где будут размещаться модули шлюза IBM Cognos.

  1. Откройте Internet Information Services Manager, выбрав из меню Start > Administrative Tools, щелкните правой кнопкой мыши на Internet Information Services (IIS) Manager и выберите пункт Run as administrator.
    Рисунок 1. Запуск Internet Information Services (IIS) Manager от имени администратора
    Рисунок 1. Запуск Internet Information Services (IIS) Manager от имени администратора
    Рисунок 1. Запуск Internet Information Services (IIS) Manager от имени администратора

    ПРИМЕЧАНИЕ. В меню "Пуск" может присутствовать пункт Internet Information Services (IIS) 6.0 Manager. Используйте только Internet Information Services (IIS) Manager.
  2. Разверните узел <server name>, расположенный в разделе Start Page, затем разверните узел Application Pools.
  3. Щелкните на значке Add Application Pool... на панели Actions справа.
    Рисунок 2. Добавление пула приложений
    Рисунок 2. Добавление пула приложений
    Рисунок 2. Добавление пула приложений
  4. Укажите необходимые сведения в диалоговом окне New Application Pool.
    • В поле Name: введите имя нового пула приложений, например, IBM Cognos 10. Не используйте имена isapi или cgi-bin, так как они зарезервированы.
    • В полях .net Framework version: и Managed pipeline mode: оставьте значения по умолчанию.
    • Снимите флажок Start application pool immediately.
      Рисунок 3. Диалоговое окно Add Application Pool для ввода имени, версии.NET Framework и режима конвейера
      Рисунок 3. Диалоговое окно Add Application Pool для ввода имени, версии.NET Framework и режима конвейера
  5. Нажмите кнопку ОК, чтобы создать пул приложений.

В IBM Cognos 10.2 теперь имеется 64-разрядный шлюз, но по умолчанию он отключен. В IBM Cognos 10.2.1 и 10.2.2 64-разрядный шлюз является шлюзом по умолчанию. Следующие шаги разбиты на два раздела, для 32- и 64- разрядных установок. Можно установить IBM Cognos 10 в 64-разрядную систему, но оставить шлюз в 32-разрядном режиме.

Для IBM Cognos версии 10.2.0 или 10.1.1 используйте раздел для 32-разрядных установок, даже если IBM Cognos и/или операционная система 64-разрядные. Для версии IBM Cognos 10.2 или выше используйте раздел для 32-разрядных установок при установке в 32-разрядную среду и для 64-разрядных при установке в 64-разрядную среду. Для IBM Cognos версии 10.2.1 или 10.2.2 используйте раздел этого документа для 64-разрядных установок.

Настройка 32-разрядного шлюза

Этот раздел относится ко всем версиям IBM Cognos 10.1.0 и 10.1.1 и 32-разрядным версиям IBM Cognos 10.2 и выше.

  1. Вернувшись на левую панель проводника IIS Manager, выберите вновь созданный пул приложений и нажмите кнопку Advanced Settings... в разделе Edit Application Pool крайней правой панели инструментов Actions.
    Рисунок 4. Выбор действия Advanced Settings пула приложений
    Рисунок 4. Выбор действия Advanced Settings пула приложений
    Рисунок 4. Выбор действия Advanced Settings пула приложений
  2. В соответствующих случаях разрешите 32-битные приложения. Для 64-разрядной Windows 2008 (R2) пулы приложений по умолчанию будет использовать 64-разрядный режим. Однако модули шлюза IBM Cognos 10.1.0 и 10.1.1 остаются 32-разрядными даже в 64-разрядных установках IBM Cognos 10. Поэтому для выполнения модулей IBM Cognos Gateway на 64-разрядных платформах необходимо настроить пул приложений на 32-разрядный режим. Для 64-разрядных установок IIS выберите параметр Enable 32-Bit Applications и присвойте ему значение True. Для 32-разрядных установок IIS этот параметр будет недоступен.
    Рисунок 5. Диалоговое окно Advanced Settings с дополнительными параметрами пула приложений
    Рисунок 5. Диалоговое окно Advanced Settings с дополнительными параметрами пула приложений
    Рисунок 5. Диалоговое окно Advanced Settings с дополнительными параметрами пула приложений
  3. Измените значение параметра Start Automatically на True.
    Рисунок 6. Диалоговое окно Advanced Settings пула приложений с параметром Start Automatically
    Рисунок 6. Диалоговое окно Advanced Settings пула приложений с параметром Start Automatically
    Рисунок 6. Диалоговое окно Advanced Settings пула приложений с параметром Start Automatically
  4. Нажмите кнопку ОК.
  5. Опять же, на панели проводника IIS Manager слева выберите вновь созданный пул приложений и нажмите кнопку Start в разделе Application Pool Tasks панели инструментов Actions справа.
    Рисунок 7. Запуск пула приложений
    Рисунок 7. Запуск пула приложений

Настройка 64-разрядного шлюза

Этот раздел относится к 64-разрядным версиям IBM Cognos 10.2 и выше.

  1. Вернувшись на левую панель проводника IIS Manager, выберите вновь созданный пул приложений и нажмите кнопку Advanced Settings... в разделе Edit Application Pool крайней правой панели инструментов Actions.
    Рисунок 8. Выбор действия Advanced Settings пула приложений
    Рисунок 8. Выбор действия Advanced Settings пула приложений
    Рисунок 8. Выбор действия Advanced Settings пула приложений
  2. Измените значение параметра Start Automatically на True.
    Рисунок 9. Диалоговое окно Advanced Settings пула приложений с параметром Start Automatically
    Рисунок 9. Диалоговое окно Advanced Settings пула приложений с параметром Start Automatically
    Рисунок 9. Диалоговое окно Advanced Settings пула приложений с параметром Start Automatically
  3. По умолчанию двоичные файлы IBM Cognos Gateway являются 32-разрядными для сохранения обратной совместимости новых систем. Для включения 64-разрядного режима необходимы следующие шаги.
    • Откройте командную строку и перейдите в каталог установки IBM Cognos, а затем в каталог cgi-bin. Например, D:\ibm\cognos\c10\cgi-bin.
    • Выполните команду copyGateMod.bat 64bit.
    • На экран выводится список копируемых файлов.
    • Если нужно вернуться к 32-разрядному шлюзу, используйте команду copyGateMod.bat 32bit.

Создание виртуального каталога IBM Cognos 10

IIS, как и любой другой веб-сервер, предоставляет информацию клиентам, отображая дерево виртуального каталога. Для IBM Cognos 10 нужно создать новый виртуальный каталог. Он будет определять элемент пути (или псевдоним), фигурирующий в URL-адресе сразу после имени хоста, или адреса веб-сервера. В документации продукта указано имя виртуального каталога по умолчанию ibmcognos (например, http://>server</ibmcognos), однако можно использовать любую другую строку.

  1. Разверните узлы Sites и Default Web Site на левой панели проводника IIS Manager.
  2. Щелкните правой кнопкой мыши на Default Web Site и выберите Add Virtual Directory...
    Рисунок 10. Добавление виртуального каталога
    Рисунок 10. Добавление виртуального каталога
  3. Укажите необходимые сведения в диалоговом окне Add Virtual Directory.
    • В поле Alias: введите имя виртуального каталога, например ibmcognos. В оставшейся части этого документа в качестве имени виртуального каталога будет использоваться ibmcognos.
    • В поле Physical path: укажите местоположение подкаталога webcontent в пределах установки IBM Cognos 10 Gateway. При необходимости для просмотра каталога используйте кнопку с многоточием.
      Рисунок 11. Диалоговое окно Add Virtual Directory с необходимыми значениями псевдонима и физического пути
      Рисунок 11. Диалоговое окно Add Virtual Directory с необходимыми значениями псевдонима и физического пути
      Рисунок 11. Диалоговое окно Add Virtual Directory с необходимыми значениями псевдонима и физического пути
  4. Нажмите кнопку ОК, чтобы сохранить изменения.

Создание приложения для cgi-bin

При создании IIS-приложения для cgi-bin модули шлюза IBM Cognos ставятся в соответствие пулу приложений, созданному в разделе Настройка пула приложений.

  1. На левой панели проводника IIS Manager найдите виртуальный каталог, созданный, как описано в разделе Создание виртуального каталога IBM Cognos 10. Имя виртуального каталога по умолчанию — ibmcognos.
  2. Щелкните правой кнопкой мыши на виртуальном каталоге и выберите пункт Add Application...
    Рисунок 12. Добавление приложения
    Рисунок 12. Добавление приложения
  3. Укажите необходимые сведения в диалоговом окне Add Application.
    • В поле Alias: укажите значение cgi-bin. Это обязательное значение, и оно не может быть никаким другим.
    • В поле Physical path: укажите местоположение подкаталога cgi-bin в пределах установки IBM Cognos 10 Gateway. При необходимости для просмотра каталога используйте кнопку с многоточием.
    • В поле Application pool: выберите пул приложений, созданный, как описано в разделе Настройка пула приложения, нажав кнопку Select....
      Рисунок 13. Диалоговое окно Add Application с необходимыми значениями псевдонима, физического пути и пула приложений
      Рисунок 13. Диалоговое окно Add Application с необходимыми значениями псевдонима, физического пути и пула приложений
      Рисунок 13. Диалоговое окно Add Application с необходимыми значениями псевдонима, физического пути и пула приложений
  4. Нажмите кнопку ОК, чтобы сохранить изменения.

Настройка IIS 7 для IBM Cognos ISAPI

В IBM Cognos 10 предлагается две реализации модулей шлюза для использования с IIS, ISAPI и CGI. Считается, что с IIS лучше всего использовать ISAPI, поскольку это обеспечивает более высокую производительность и распределение ресурсов в CGI. Поэтому в настоящем разделе приводится описание настройки модуля ISAPI, а следующий раздел о настройке CGI обозначен как факультативный. Используйте CGI в IIS только при необходимости.

Чтобы модуль ISAPI работал, нужно выполнить два действия. Во-первых, нужно настроить отображение модуля, который направляет запросы, вызывая на исполнение файл cognosisapi.dll. Во-вторых, нужно добавить модуль как допустимое расширение, так чтобы IIS не блокировал его исполнение.

Настройка отображения модуля для ISAPI

  1. Выберите приложение cgi-bin в дереве Default Web Site > ibmcognos на левой панели IIS Manager, затем выберите Features View в нижней строке средней панели.
  2. Дважды щелкните на Handler Mappings на средней панели. На той же панели появится список отображений обработчиков для этого приложения.
    Рисунок 14. Отображения обработчиков в разделе Feature View приложения cgi-bin
    Рисунок 14. Отображения обработчиков в разделе Feature View приложения cgi-bin
    Рисунок 14. Отображения обработчиков в разделе Feature View приложения cgi-bin

    Обратите внимание, что по умолчанию для ISAPI и CGI указано состояние Disabled. Также обратите внимание, что CGI указан только для файлов с расширением .EXE.
    Рисунок 15. Представление Handler Mappings по умолчанию с отключенными CGI и ISAPI
    Рисунок 15. Представление Handler Mappings по умолчанию с отключенными CGI и ISAPI
    Рисунок 15. Представление Handler Mappings по умолчанию с отключенными CGI и ISAPI
  3. На крайней правой панели Actions щелкните на Add Module Mapping..., чтобы добавить отображение ISAPI.
  4. Введите необходимые сведения в диалоговое окно Add Module Mapping.
    • В поле Request path: укажите значение cognosisapi.dll. Это обязательное значение, и оно не может быть никаким другим.
    • В поле Module: выберите из раскрывающегося списка IsapiModule.
    • В поле Executable (optional): укажите путь к файлу cognosisapi.dll в пределах установки IBM Cognos Gateway. Этот файл находится в каталоге <COG_ROOT>/CGI-BIN, где <COG_ROOT> – каталог установки IBM Cognos BI. Например, D:\cognos\c10\cgi-bin.
    • В поле Name: укажите имя этого модуля (например, IBMCOGNOS-ISAPI).
      Рисунок 16. Диалоговое окно Add Module Mapping с необходимыми значениями пути запроса, модуля, исполняемого файла и имени
      Рисунок 16. Диалоговое окно Add Module Mapping с необходимыми значениями пути запроса, модуля, исполняемого файла и имени
      Рисунок 16. Диалоговое окно Add Module Mapping с необходимыми значениями пути запроса, модуля, исполняемого файла и имени
  5. Нажмите кнопку ОК.
  6. Появится диалоговое окно для подтверждения того, что это новое расширение ISAPI должно быть разрешено. Нажмите кнопку Yes.
    Рисунок 17. Диалоговое окно Add Module Mapping, которое отображается после создания модуля отображения ISAPI
    Рисунок 17. Диалоговое окно Add Module Mapping, которое отображается после создания модуля отображения ISAPI
    Рисунок 17. Диалоговое окно Add Module Mapping, которое отображается после создания модуля отображения ISAPI
  7. На экране Handler Mappings вновь добавленный обработчик (в данном примере IBMCOGNOS-ISAPI) окажется в разделе Enabled.
    Рисунок 18. Список отображений обработчиков, в котором модуль отображения ISAPI показан как включенный
    Рисунок 18. Список отображений обработчиков, в котором модуль отображения ISAPI показан как включенный
    Рисунок 18. Список отображений обработчиков, в котором модуль отображения ISAPI показан как включенный

Настройка ограничений ISAPI для веб-сервера

  1. В IIS Manager выберите Web Server из дерева слева.
  2. В нижней строке средней панели выберите вкладку Features View.
  3. Дважды щелкните на значке ISAPI and CGI Restrictions. На средней панели IIS Manager появится список определенных ограничений.
    Рисунок 19. Расположение значка ISAPI и CGI Restrictions
    Рисунок 19. Расположение значка ISAPI и CGI Restrictions
    Рисунок 19. Расположение значка ISAPI и CGI Restrictions
  4. Убедитесь, что в строке списка, соответствующей cognosisapi.dll, указано Allowed. Эта строка должна быть вставлена автоматически при выполнении действий, описанных в разделе Создание отображения модуля в ISAPI. У нее нет описания, и его необходимо определить на основе значения, указанного в столбце Path.
    Рисунок 20. Список ограничений ISAP и CGI, в котором вновь созданный модуль ISAPI показан как разрешенный
    Рисунок 20. Список ограничений ISAP и CGI, в котором вновь созданный модуль ISAPI показан как разрешенный
    Рисунок 20. Список ограничений ISAP и CGI, в котором вновь созданный модуль ISAPI показан как разрешенный

    Если запись ограничений для файла cognosisapi.dll отсутствует, перейдите к шагу 5, в противном случае переходите к следующему разделу.
  5. На крайней правой панели Actions щелкните на Add...
  6. Введите необходимые сведения в диалоговое окно Add ISAPI or CGI Restriction.
    • В поле ISAPI or CGI path: укажите путь к файлу cognosisapi.dll в пределах установки IBM Cognos Gateway. Как правило, это значение <COG_ROOT>\cgi-bin\cognosisapi.dll. Например, D:\cognos\c10\cgi-bin\cognosisapi.dll.
    • В поле Description: введите описание ограничения, например, IBMCOGNOS-ISAPI.
  7. Установите флажок Allow extension path to execute.
    Рисунок 21. Диалоговое окно Add ISAPI or CGI Restriction с отмеченным параметром, разрешающим исполнение по пути расширения
    Рисунок 21. Диалоговое окно Add ISAPI or CGI Restriction с отмеченным параметром, разрешающим исполнение по пути расширения
    Рисунок 21. Диалоговое окно Add ISAPI or CGI Restriction с отмеченным параметром, разрешающим исполнение по пути расширения

Тестирование установки ISAPI

Существует несколько способов вызова IBM Cognos 10 ISAPI Gateway.

  • Вызов http://<webserver>/<alias>
  • Вызов http://<webserver>/<alias>/isapi
  • Вызов http://<webserver>/<alias>/cgi-bin/cognosisapi.dll

По умолчанию без дополнительной настройки будет работать только третий вариант. Из соображений удобства администраторы обычно предпочитают использовать первый URL-адрес, потому он самый короткий. Однако этот URL-адрес также наиболее общий и не указывает ни на какую конкретную реализацию шлюза. Чтобы реализовать первый вариант для ISAPI, нужно выполнить следующие действия по загрузке документа по умолчанию по указанному пути. Второй URL рассчитан на вызов ISAPI Gateway, но его также нужно разрешить.

  1. На левой панели проводника IIS Manager выберите виртуальный каталог IBM Cognos 10, созданный, как описано в разделе Создание виртуального каталога IBM Cognos 10.
  2. На средней панели включите режим Features View.
  3. Дважды щелкните на Default Document.
    Рисунок 22. Местоположение документа по умолчанию
    Рисунок 22. Местоположение документа по умолчанию
    Рисунок 22. Местоположение документа по умолчанию
  4. На крайней правой панели Actions щелкните на значке Add.
  5. Введите default.htm и нажмите кнопку ОК, чтобы сохранить настройку.

Default.htm станет документом по умолчанию при обращении к каталогу без указания определенного документа, как в данном случае. Файл default.htm содержит код JavaScript, который выполняет перенаправление модуля IBM Cognos 10 Gateway после демонстрации экрана-заставки. По умолчанию default.htm во второй форме URL, http://<webserver>/<alias>/isapi, перенаправляет к модулю ISAPI. В первой форме URL, http://<webserver>/<alias>, default.htm по умолчанию перенаправляет к CGI.

После включение URL-адресов при обращении к любому из них должен появляться экран входа IBM Cognos 10 или IBM Cognos Connection, если в IBM Cognos 10 разрешена анонимная проверка подлинности. Если IBM Cognos 10 не запущен, то появится сообщение об ошибке, гласящее, что IBM Cognos 10 Gateway не может связаться с сервером IBM Cognos 10 BI.

Как сделать ISAPI Gateway шлюзом по умолчанию

Чтобы сделать модуль ISAPI Gateway шлюзом по умолчанию для системы IBM Cognos 10 BI, требуются еще два шага. Первый шаг заключается в том, чтобы изменить параметр настройки Gateway URI с помощью IBM Cognos Configuration, а второй – настроить файл default.htm на виртуальный каталог /<alias>.

Повторите следующие шаги для всех установок IBM Cognos 10 Application Tier или Content Manager.

  1. Откройте IBM Cognos Configuration, выберите элемент Environment на левой панели Explorer и щелкните на поле Gateway URI.
    Рисунок 23. Окно IBM Cognos Configuration со свойствами элемента Environment, включая URI Gateway
    Рисунок 23. Окно IBM Cognos Configuration со свойствами элемента Environment, включая URI Gateway
    Рисунок 23. Окно IBM Cognos Configuration со свойствами элемента Environment, включая URI Gateway
  2. Измените поле Gateway URI так, чтобы отразить фактический URI, используемый для вызова ISAPI Gateway. Для имени сервера рекомендуется использовать полную схему имени домена, например, http://<server>. <domain>.<suffix>:<port>/<alias>/cgi-bin/cognosisapi.dll. Примером URI может служить http://myserver.domain.com:80/ibmcognos/cgi-bin/cognosisapi.dll.

Файл default.htm для URL-адреса http://<webserver>/<alias>, если он был включен ранее, следует отредактировать, изменив целевой адрес перенаправления с CGI на ISAPI. Имейте в виду, что редактирование файла default.htm имеет последствия, так как допускается только одно перенаправление на данный конкретный модуль IBM Cognos 10 Gateway. Если шлюз CGI тоже нужен, придется выбирать, которое из этих перенаправлений (CGI или ISAPI) будет значением по умолчанию. Вероятнее всего, что пользователи предпочтут для доступа к системе более короткий URL-адрес, так что, хотя для доступа к модулю ISAPI существует особый URL-адрес (http://<webserver>/<alias>/isapi), если значением по умолчанию должно быть ISAPI, то рекомендуется отредактировать default.htm так, чтобы он перенаправлял к ISAPI.

В установке IBM Cognos 10 Gateway

  1. Откройте в текстовом редакторе файл <COG_ROOT>\webcontent\default.htm. Например, D:\cognos\c10\webcontent\default.htm.
  2. Найдите строку
    window.setTimeout("window.location.replace('cgi-bin/cognos.cgi? 
     b_action=xts.run&m=portal/main.xts&startwel=yes')",5);

    и замените cognos.cgi на cognosisapi.dll.
    window.setTimeout("window.location.replace('cgi-bin/cognosisapi.dll? 
     b_action=xts.run&m=portal/main.xts&startwel=yes')",5);

Это приведет к тому, что http://<webserver>/<alias> будет работать как http://<webserver>/<alias>/isapi, перенаправляя пользователя после демонстрации экрана-заставки на ISAPI Gateway.

Настройка IIS 7 для IBM Cognos CGI (факультативно)

Хотя для Microsoft IIS рекомендуется использовать модуль IBM Cognos 10 ISAPI Gateway, можно включить и модуль IBM Cognos 10 CGI Gateway. Имейте в виду, что модули CGI создают новый рабочий процесс для каждого сеанса, что делает их непригодными для среды с высокой рабочей нагрузкой.

Как и в случае модуля ISAPI, сначала необходимо определить отображение модуля, а затем разрешить его выполнение в IIS.

Настройка отображения модуля CGI

  1. Выберите приложение cgi-bin в дереве Default Web Site > ibmcognos на левой панели IIS Manager, затем выберите вкладку Features View в нижней строке средней панели.
  2. Дважды щелкните на Handler Mappings на средней панели. На средней панели появится список распределений обработчика для этого приложения.
    Рисунок 24. Расположение Handler Mappings в приложении cgi-bin
    Рисунок 24. Расположение Handler Mappings в приложении cgi-bin
    Рисунок 24. Расположение Handler Mappings в приложении cgi-bin
  3. На крайней правой панели Actions щелкните на Add Module Mapping..., чтобы добавить отображение CGI.
  4. Введите необходимые сведения в диалоговое окно Add Module Mapping.
    • В поле Request path: укажите значение cognos.cgi. Это обязательное значение, и оно не может быть никаким другим.
    • В поле Module: выберите из раскрывающегося списка sapiModule. Обратите внимание, что fastCGIModule не поддерживается.
    • Поле Executable (optional): должно остаться пустым.
    • В поле Name: введите имя этого модуля, например, IBMCOGNOS-CGI.
      Рисунок 25. Диалоговое окно Add Module Mapping с необходимыми значениями пути запроса, модуля и имени
      Рисунок 25. Диалоговое окно Add Module Mapping с необходимыми значениями пути запроса, модуля и имени
      Рисунок 25. Диалоговое окно Add Module Mapping с необходимыми значениями пути запроса, модуля и имени
  5. Нажмите кнопку ОК, чтобы сохранить настройку. Вернитесь на Handler Mapping; в разделе Enabled должен появиться модуль IBMCOGNOS-CGI.
    Рисунок 26. Список отображений обработчиков, в котором значится включенное отображение модуля CGI
    Рисунок 26. Список отображений обработчиков, в котором значится включенное отображение модуля CGI
    Рисунок 26. Список отображений обработчиков, в котором значится включенное отображение модуля CGI
  6. Выбрав вновь созданное отображение, нажмите кнопку Edit Feature Permissions на крайней правой панели Actions.
  7. В диалоговом окне Edit Feature Permissions установите флажок Execute, чтобы разрешить выполнение CGI.
    Рисунок 27. Диалоговое окно Edit Feature Permissions с установленным флажком разрешения выполнения
    Рисунок 27. Диалоговое окно Edit Feature Permissions с установленным флажком разрешения выполнения
  8. Нажмите кнопку ОК.

Настройка ограничений CGI для веб-сервера

  1. В окне IIS Manager выберите в представлении дерева слева веб-сервер, а на панели содержимого в нижней строке выберите вкладку Features View.
  2. Дважды щелкните на значке ISAPI and CGI Restrictions. На средней панели IIS Manager появится список определенных ограничений.
    Рисунок 28. Расположение значка ISAPI и CGI Restrictions
    Рисунок 28. Расположение значка ISAPI и CGI Restrictions
    Рисунок 28. Расположение значка ISAPI и CGI Restrictions
  3. На крайней правой панели Actions щелкните на значке Add...
  4. Введите необходимые сведения в диалоговое окно Add ISAPI or CGI Restriction.
    • В поле ISAPI or CGI path: укажите путь к файлу cognos.cgi в пределах установки IBM Cognos Gateway. Этот файл находится в каталоге <COG_ROOT>\cgi-bin. При поиске этого файла измените тип файла на All files (*.*), так как .cgi не является суффиксом по умолчанию.
    • В поле Description: введите описание ограничения, например, IBMCOGNOS-CGI.
    • Убедитесь, что флажок Allow extension path to execute установлен.
      Рисунок 29. Диалоговое окно Add ISAPI or CGI Restriction с требуемыми параметрами пути ISAPI или CGI, описания и разрешения выполнения для пути расширения
      Рисунок 29. Диалоговое окно Add ISAPI or CGI Restriction с требуемыми параметрами пути ISAPI или CGI, описания и разрешения выполнения для пути расширения
      Рисунок 29. Диалоговое окно Add ISAPI or CGI Restriction с требуемыми параметрами пути ISAPI или CGI, описания и разрешения выполнения для пути расширения

Тестирование установки CGI

Существует несколько способов вызова модуля IBM Cognos 10 CGI Gateway:

  • путем вызова http://<webserver>/<alias>;
  • путем вызова http://<webserver>/<alias>/cgi-bin/cognos.cgi.

Примечание. Если действия, описанные в разделе Как сделать ISAPI шлюзом по умолчанию, были выполнены (напомним, что для этого мы редактировали файл default.htm, расположенный в каталоге /<alias>), то первый URL будет перенаправлять к модулю ISAPI и не будет вызвать модуль CGI.

По умолчанию будет работать только второй URL-адрес. Из соображений удобства администраторы часто предпочитают использовать первый URL-адрес, который короче. Однако это наиболее общий URL-адрес, который не указывает ни на какую конкретную реализацию шлюза. Чтобы включить URL-адрес CGI, потребуются следующие шаги, которые заставляют IIS загружать документ по умолчанию из указанных мест.

  1. На левой панели проводника IIS Manager выберите виртуальный каталог IBM Cognos 10, созданный, как описано в разделе Создание виртуального каталога IBM Cognos 10.
  2. На средней панели включите режим Features View.
  3. Дважды щелкните на Default Document.
    Рисунок 30. Местоположение документа по умолчанию
    Рисунок 30. Местоположение документа по умолчанию
    Рисунок 30. Местоположение документа по умолчанию
  4. На крайней правой панели Actions щелкните на значке Add...
  5. Введите default.htm и нажмите кнопку ОК, чтобы сохранить настройку.

Default.htm станет документом по умолчанию при обращении к каталогу без указания определенного документа. Файл default.htm содержит код JavaScript, который выполняет перенаправление модуля IBM Cognos 10 Gateway после демонстрации экрана-заставки. По умолчанию будет выполняться перенаправление к модулю CGI, так что если файл default.htm предварительно не отредактирован, то никаких других изменений не требуется.

При обращении к любому из URL-адресов должен появляться экран входа IBM Cognos 10 или IBM Cognos Connection, если в IBM Cognos 10 разрешена анонимная проверка подлинности. Если IBM Cognos 10 не запущен, то появится сообщение об ошибке, гласящее, что IBM Cognos 10 Gateway не может связаться с сервером IBM Cognos 10 BI.

Редактирование параметра отображения модуля

Модуль IBM Cognos 10 Gateway требует настройки дополнительного параметра обработчика отображения модулей ISAPI и/или CGI. Это необходимо для правильной работы IBM Cognos Administration и IBM Cognos Mobile. В этом разделе описан процесс добавления данного элемента конфигурации.

Установка allowPathInfo в обработчики отображения модулей

IBM Cognos 10 требует добавления к обработчику отображения модулей ISAPI и/или CGI параметра allowPathInfo=true. Этот параметр управляет тем, как обработчик заполняет стандартную переменную среды CGI PATH_INFO для отображаемого модуля. По умолчанию IIS устанавливает его как полный URL-адрес, но это не соответствует спецификации CGI. Однако некоторые приложения, в частности, Active Server Pages, ожидают, что это будет полный URL-адрес. Модули IBM Cognos 10 Gateway соответствуют спецификации CGI и ожидают, что он будет содержать лишь последнюю часть URL-адреса, например cognos.cgi, вместо <alias>/cgi-bin/cognos.cgi. Вот почему нужно добавить этот дополнительный параметр.

  1. Перейдите в виртуальный подкаталог cgi-bin, расположенный в виртуальном каталоге, созданном, как описано в разделе Создание виртуального каталога IBM Cognos 10.
  2. В окне Features View дважды щелкните на значке Configuration Editor в подразделе Management.
    Рисунок 31. Расположение значка Configuration Editor
    Рисунок 31. Расположение значка Configuration Editor
    Рисунок 31. Расположение значка Configuration Editor
  3. Найдите раскрывающийся список Section. Развернув раскрывающийся список, найдите раздел system.webServer и выберите в нем handlers.
    Рисунок 32. Выбор раздела handlers в Configuration Editor
    Рисунок 32. Выбор раздела handlers в Configuration Editor
    Рисунок 32. Выбор раздела handlers в Configuration Editor
  4. Щелкните на строке (Collections), а затем на значке Edit Items на крайней правой панели Action.
  5. На панели Items окна Collection Editor щелкните на обработчике, созданном, как описано в разделе Настройка IIS 7 для IBM Cognos ISAPI. В настоящем документе имя этого обработчика — IBMCOGNOS-ISAPI.
    Рисунок 33. Редактирование параметра allowPathInfo для отображения каждого модуля
    Рисунок 33. Редактирование параметра allowPathInfo для отображения каждого модуля
    Рисунок 33. Редактирование параметра allowPathInfo для отображения каждого модуля
  6. На панели Properties найдите свойство allowPathInfo и измените его значение с False на True.
  7. Закройте окно Collection Editor, затем нажмите кнопку Apply на крайней правой панели Actions.

Если для включения CGI использовался раздел Настройка IIS 7 для IBM Cognos CGI, повторите шаги 5-7 для обработчика IBMCOGNOS-CGI.

Тестирование allowPathInfo

Войдите в систему IBM Cognos Connection в качестве системного администратора и откройте IBM Cognos Administration. Если IBM Cognos Administration откроется без ошибок, настройка выполнена правильно.

Если allowPathInfo настроен неправильно, функция IBM Cognos Administration будет недоступна и в верхней строке появится сообщение об ошибке: PF-SRV-6116 Unable to process the document, target is not valid or the target was not received. Возможные решения этой проблемы описаны в разделе Устранение неполадок в конце настоящего документа.

Рисунок 34. Сообщение об ошибке PF-SRV-6116 при вызове IBM Cognos Administration в случае неправильной настройки allowPathInfo
Рисунок 34. Сообщение об ошибке PF-SRV-6116 при вызове IBM Cognos Administration в случае неправильной настройки allowPathInfo
Рисунок 34. Сообщение об ошибке PF-SRV-6116 при вызове IBM Cognos Administration в случае неправильной настройки allowPathInfo

Примечание. В IBM Cognos Mobile после экрана входа появляется всплывающее окно с текстом No Operation Specified.

Советы по повышению производительности (факультативно)

В конфигурацию IIS можно добавить некоторые настройки для повышения производительности. Первая рекомендация – использовать в качестве модуля по умолчанию шлюз ISAPI. Вторая – указать срок действия содержимого, так чтобы неизменный статический веб-контент извлекался из кэша локального браузера, а не запрашивался с сервера. Третья рекомендация — определить время ожидания соединения с конечным значением, чтобы соединения прерывались без слишком долгого ожидания.

Использование ISAPI Gateway

Модуль шлюза IBM Cognos ISAPI представляет собой нативный код IIS, который обеспечивает более рациональное использование ресурсов и повышенную производительность. CGI-модуль — это отдельный процесс, который IIS должен создавать при каждом запросе, что приводит к немного большему времени реакции, и в условиях высокой нагрузки потребляет больше ресурсов, чем ISAPI. Инструкции по настройке ISAPI в качестве шлюза по умолчанию приведены в разделе «Настройка IIS 7 для IBM Cognos ISAPI».

Срок действия информации

Для отчетов IBM Cognos Business Intelligence рекомендуется установить срок действия содержимого виртуального каталога <COG_ROOT>/webcontent/pat/images.

Каждый раз, когда пользователь открывает Report Studio, веб-браузер проверяет актуальность изображения на веб-сервере. С учетом того, что там более 600 изображений, это может привести к избыточному сетевому трафику. Эту проверку можно отложить до указанной даты, используя функцию срока действия информации на веб-сервере.

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

Имейте в виду, что при обновлении IBM Cognos может потребоваться, чтобы пользователи Report Studio очистили кэш своего веб-браузера, чтобы получить актуальные изображения.

  1. На левой панели IIS Manager выберите виртуальный каталог IBM Cognos 10, нажав на него. В рамках этого документа мы используем в качестве имени виртуального каталога ibmcognos.
  2. Перейдите на вкладку Features View в нижней строке средней панели и дважды щелкните на HTTP Response Headers.
  3. Щелкните на Set Common Headers на крайней правой панели Actions.
  4. В диалоговом окне Set Common HTTP Response Headers отметьте пункт Expire Web Content:, нажмите кнопку After: и установите срок действия 10 дней. При меньших значениях срок действия информации будет истекать раньше, что приведет к большему числу запросов, а при больших значениях запросов будет меньше.
    Рисунок 35. Диалоговое окно Set Common HTTP Response Headers с настроенным сроком действия информации в 10 дней
    Рисунок 35. Диалоговое окно Set Common HTTP Response Headers с настроенным сроком действия информации в 10 дней
    Рисунок 35. Диалоговое окно Set Common HTTP Response Headers с настроенным сроком действия информации в 10 дней
  5. Нажмите кнопку ОК.

Время ожидания соединения

Время ожидания соединения помогает ограничить ресурсы, занимаемые неактивными соединениями. Это уменьшает объем памяти и количество открытых неактивных портов.

  1. На левой панели IIS Manager выберите веб-сайт, используемый для обслуживания контента IBM Cognos Gateway (скорее всего, Default Web Site), щелкнув на нем.
  2. Нажмите кнопку Limits на крайней правой панели Actions в разделе Configure.
  3. В диалоговом окне Edit Web Site Limits укажите в поле Connection time-out (in seconds): значение 900.
    Рисунок 36. Диалоговое окно Edit Web Site Limits с установленным временим ожидания соединения 900 секунд.
    Рисунок 36. Диалоговое окно Edit Web Site Limits с установленным временим ожидания соединения 900 секунд.
    Рисунок 36. Диалоговое окно Edit Web Site Limits с установленным временим ожидания соединения 900 секунд.

Настройка WebDAV (факультативно)

Web-based Distributed Authoring and Versioning (WebDAV) — это основанный на HTTP протокол, который позволяет клиентам считывать, записывать и изменять файлы, полученные от веб-сервера, а затем возвращать их на сервер.

IBM Cognos 10 использует этот протокол для того, чтобы автор мог просматривать изображения в студии, когда ему нужно добавить их в отчет или анализ. В IBM Cognos BI есть примеры файлов изображений, которые используются образцами продукта, и мы будем использовать их для демонстрации настройки WebDAV. Эти файлы примеров изображений расположены в виртуальном каталоге IBM Cognos 10 Gateway.

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

Для использования WebDAV необходимо установить WebDAV Publishing Role Service. Подробности см. в Приложении A.

Включение WebDAV

  1. На левой панели IIS Manager выберите веб-сайт, содержащий файлы изображений, нажав на него. Например, Default Web Site.
  2. Перейдите на вкладку Features View в нижней строке средней панели, затем щелкните на WebDAV Authoring Rules.
    Рисунок 37. Расположение WebDAV Authoring Rules
    Рисунок 37. Расположение WebDAV Authoring Rules
    Рисунок 37. Расположение WebDAV Authoring Rules
  3. Нажмите кнопку Enable WebDAV на крайней правой панели Action.

Разрешение анонимных запросов свойств файлов

По умолчанию свойства файлов могут запрашивать только авторизованные пользователи. Это обязательный параметр, необходимый для успешного поиска изображений в Report Studio.

  1. Щелкните на WebDAV Settings... на крайней правой панели Action.
  2. В разделе Property Behavior найдите пункт Allow Anonymous Property Queries.
  3. Измените значение с False на True.
    Рисунок 38. Разрешение анонимных запросов свойств файлов
    Рисунок 38. Разрешение анонимных запросов свойств файлов
    Рисунок 38. Разрешение анонимных запросов свойств файлов
  4. Нажмите кнопку Apply на крайней правой панели Actions.

Определение доступа к WebDAV

Следующий шаг — настройка аутентификации и авторизации IIS для папок с изображениями. Если примеры IBM Cognos 10 BI установлены, то папка с примерами изображений находится в папке <COG_ROOT>/webcontent/samples/images, доступной в IIS как <alias>/samples/images. Мы будем использовать эту папку для демонстрации подхода. Его можно повторить для любой другой папки, содержащей изображения, даже в других виртуальных каталогах.

Обратите внимание, что в этом очень простом демонстрационном примере мы разрешаем доступ к WebDAV анонимным пользователям и доступ ко всем файлам только для чтения. Обсудите со своим администратором Windows вопрос о том, какие пользователи или группы должны иметь доступ. То же относится и к методу аутентификации. Чтобы получить доступ к файлам, защищенным механизмом безопасности Windows, необходимо настроить механизм аутентификации Windows. Однако это выходит за рамки настоящего документа.

  1. Найдите папку <alias>/samples/images на левой панели проводника IIS Manager и выберите ее.
    Рисунок 39. Расположение папки с изображениями в каталоге alias/samples IBM Cognos 10
    Рисунок 39. Расположение папки с изображениями в каталоге alias/samples IBM Cognos 10
  2. В нижней строке средней панели IIS Manager перейдите на вкладку Feature View и дважды щелкните на значке Authentication. В средней панели появятся методы настройки аутентификации для данной виртуальной папки.
    Рисунок 40. Расположение значка Authentication
    Рисунок 40. Расположение значка Authentication
    Рисунок 40. Расположение значка Authentication
  3. На средней панели выберите Anonymous Authentication.
  4. Если в столбце Status указано Disabled, нажмите кнопку Enable на крайней правой панели Actions, чтобы включить анонимную аутентификацию для этой папки.
    Рисунок 41. Включение анонимной аутентификации
    Рисунок 41. Включение анонимной аутентификации
    Рисунок 41. Включение анонимной аутентификации

    Это позволит любому получить доступ к папке без проверки подлинности. Имейте в виду, что в этой конфигурации IIS использует для доступа к файлам специальную локальную учетную запись пользователя IIS. Поэтому для того чтобы это работало, файлы, содержащиеся в папке <COG_ROOT>/webcontent/samples/images, должны быть доступны для этой учетной записи.
  5. Найдите папку <alias>/samples/images на левой панели проводника IIS Manager и выберите ее снова.
  6. Щелкните на WebDAV Authoring Rules на средней панели, чтобы открыть представление Features View для этой папки.
  7. На крайней правой панели Actions щелкните на Add Authoring Rule...
  8. В диалоговом окне Add Authoring Rule выполните следующие действия:
    • в разделе Allow access to: выберите All content;
    • в разделе Allow access to this content to: выберите All users;
    • В разделе Permissions: отметьте пункт Read.
      Рисунок 42. Диалоговое окно Add Authoring Rules с необходимыми параметрами определения доступа WebDAV
      Рисунок 42. Диалоговое окно Add Authoring Rules с необходимыми параметрами определения доступа WebDAV
      Рисунок 42. Диалоговое окно Add Authoring Rules с необходимыми параметрами определения доступа WebDAV
  9. Нажмите кнопку ОК, чтобы сохранить изменения.

Теперь файлы изображений можно просматривать в одной из студий IBM Cognos 10, например, Report Studio.

Включение канала Secure Socket Layer (SSL)

В целях полноты в настоящий документ включены указания и действия, необходимые для настройки IBM Cognos 10 Gateway для SSL. Решение этой задачи подразумевает несколько шагов:

  1. Запрос сертификата веб-сервера для SSL.
  2. Установка сертификата веб-сервера на веб-сервер.
  3. Изменение параметров конфигурации IBM Cognos на всех затронутых установках IBM Cognos 10.
  4. Импорт сертификата, необходимого для создания доверенности в хранилище доверенностей IBM Cognos 10.

Первые два шага выходят за рамки системы IBM Cognos и должны выполняться администратором веб-сервера или кем-то другим, кто знаком с инфраструктурой открытых ключей (Public Key Infrastructure – PKI). Есть несколько рекомендаций по этому процессу.

  • Сертификат веб-сервера не должен быть самозаверяющимся – то есть предмет сертификата и его источник не должны совпадать. Такие сертификаты ненадежны и не пользуются доверием IBM Cognos. Их следует использовать только в целях тестирования или устранения неполадок, так как они не соответствуют современным стандартам безопасности для производственных систем. Самозаверяющиеся сертификаты для работы с IBM Cognos должны содержать расширение X.509 CA:True, поскольку это сертификаты сервера и одновременно сертификаты ЦС.

    Рекомендуется создать свой собственный центр сертификации (ЦС) и подписать сертификат веб-сервера с применением этого ЦС. В Microsoft Server 2008 есть служба Active Directory Certificate Services, которую можно использованы для этой цели. Для многих платформ имеется бесплатный и широко распространенный стандартный инструмент OpenSSL, и в Интернете можно найти различные руководства.
  • Именем сервера должно быть значение Distinguished Name (DN) субъекта сертификата веб-сервера (идентификатор, используемый веб-сервером), указанное с помощью схемы полных доменных имен (FQDN), например, CN=<serverhost>.<domain>. <suffix>, ...<другие необязательные атрибуты DN>. Это вызвано тем, что браузеры сравнивают субъект сертификата с URL-адресом, используемым для обращения к серверу, и выдают предупредительное сообщение или отклоняют сертификат, если они не совпадают.

    Для сертификатов и для любых URI, применяемых для вызова IBM Cognos 10 Gateway, рекомендуется использовать полное доменное имя (FQDN). Для URI Gateway, указанного в конфигурации IBM Cognos, всегда должно использоваться FQDN - «localhost» не допускается.
  • Среди прочего SSL обеспечивает зашифрованные сообщения. Протокол и метод, используемые для шифрования, называются шифром и основаны на ключе, который считается слабым или сильным в зависимости от его длины в битах. Новые веб-серверы должны использовать сильные шифры с длиной ключа от 128 бит.

    Из соображений безопасности в веб-сервере следует запретить слабые шифры. IIS 7.x поддерживает только сильные шифры и, следовательно, изначально соответствует этой рекомендации. IBM Cognos 10 изначально поддерживает сильные шифры, и по умолчанию они включены в конфигурации IBM Cognos для поддерживаемого параметра ciphersuites.

Дополнительные сведения о настройке IIS 7.x для SSL можно получить, обратившись на веб-сайт Microsoft IIS 7 по следующей ссылке: http://learn.iis.net/page.aspx/144/how-to-set-up-ssl-on-iis-7-and-above/.

Шаги 3 и 4 рассматриваются в Руководстве по установке и выбору конфигурации IBM Cognos 10. Общие шаги, приведенные в Руководстве по установке и выбору конфигурации IBM Cognos 10, относятся в том числе и к установкам, описанным в этом документе, однако нужно учесть несколько моментов.

  • В любой установке IBM Cognos 10, которая обращается к IBM Cognos 10 Gateway, должен быть реализован импорт сертификата ЦС (или самозаверяющегося сертификата с расширением CA:True). Сюда относятся установки Application Tier и установки Content Manager – не только для IBM Cognos 10 BI, но и для IBM Cognos Planning, IBM Cognos PowerPlay и других инструментов из семейства IBM Cognos 10.
  • Помимо изменения значения URI Gateway в конфигурации IBM Cognos, необходимо убедиться, что для SSL также включен сильный шифр. Для этого проверьте параметр конфигурации IBM Cognos Supported ciphersuites в меню Security > Cryptography > Cognos.
    Рисунок 43. Конфигурация IBM Cognos с включенной поддержкой шифров
    Рисунок 43. Конфигурация IBM Cognos с включенной поддержкой шифров
    Рисунок 43. Конфигурация IBM Cognos с включенной поддержкой шифров

    Чтобы увидеть список включенных шифров, нажмите на значок Edit. Появится диалоговое окно с двумя списками - Available values слева и Current values справа. Текущие значения должны содержать все записи из списка Available values. В противном случае добавьте шифры из списка Available values, отметив их и нажав кнопку Add, расположенную между двумя списками. Нажмите кнопку ОК, чтобы сохранить изменения.
    Рисунок 44. Список поддерживаемых шифров
    Рисунок 44. Список поддерживаемых шифров
    Рисунок 44. Список поддерживаемых шифров
  • При использовании других клиентских инструментов IBM Cognos для подключения к IBM Cognos 10 Gateway (например, IBM Cognos TM1 Architect или Web, IBM Executive Viewer или IBM Cognos Planning) эти инструменты также должны доверять сертификату веб-сервера, для чего следует импортировать сертификат ЦС в соответствующие хранилища доверенностей. Рекомендуется сообщить администратору о тех продуктах IBM Cognos, которые требуют дополнительных шагов по настройке. Некоторые из этих инструментов используют не свои собственные хранилища доверенностей, а хранилище Windows-компьютера, на котором они работают. Для них нужно выполнить шаг, описанный ниже.
  • Для клиентов Internet Explorer сертификат ЦС, подписавшего сертификат веб-сервера, нужно импортировать в качестве доверенного корневого центра сертификации. За подробной информацией обратитесь к администратору Windows. Некоторые общие указания даны по следующей ссылке: http://technet.microsoft.com/en-us/library/dd361898.aspx. Более подробные инструкции по решению этой задачи легко найти в Интернете.

Устранение неполадок

HTTP Error 404.0 – File Not Found

Ошибка HTTP Всякий 404.0 выдается всякий раз, когда IIS не может найти файл по указанному пути.

Возможные решения:

  • приложение cgi-bin не установлено или находится не на должном уровне наследования по отношению к основному псевдониму IBM Cognos 10 (виртуальному каталогу);
  • введите URI или имя виртуального каталога;
  • IIS не запущен.

HTTP Error 404.2 – Not Found

Обращение к URI IBM Cognos 10 Gateway приводит к ошибке HTTP 402.2 - запрашиваемая страница не может быть предоставлена из-за параметров настройки списка ограничения ISAPI и CGI на веб-сервере.

Рисунок 45. Сообщение об ошибке HTTP 404.2 - Not found в Internet Explorer
Рисунок 45. Сообщение об ошибке HTTP 404.2 - Not found в Internet Explorer
Рисунок 45. Сообщение об ошибке HTTP 404.2 - Not found в Internet Explorer

Возможные решения:

  • проверьте ограничения ISAPI;
  • проверьте URI – возможно, что он был перенаправлен или вызывает не тот модуль IBM Cognos 10 Gateway.

HTTP Error 503 – Service Unavailable

Служба недоступна при обращении к URI IBM Cognos 10 Gateway.

Возможное решение: убедитесь, что запущен пул приложений, в котором размещаются модули IBM Cognos 10 Gateway.

HTTP 500 – Internal server error

Внутренняя ошибка сервера обычно указывает на проблему с ресурсом, который вы ищете, а он не может быть отображен.

Для диагностики этой ошибки:

  1. Перейдите к созданному приложению cgi-bin.
  2. На средней панели дважды щелкните на Error Pages в разделе IIS.
  3. На крайней правой панели щелкните на Edit Feature Settings...
  4. Замените Error Responses на Detailed errors.
  5. Нажмите кнопку ОК.

Когда проблема будет обнаружена, рекомендуется восстановить первоначальное значение Detailed errors этого параметра для локальных запросов и специальных страниц ошибок удаленных запросов.

Возможные причины и решения:

  1. Убедитесь, что файловая система пула приложений имеет доступ к cgi-bin. Возможно, что файловая система была заблокирована, что не позволяло процессу IIS обращаться к нужным обработчикам модулей. Чтобы добавить пользователя пула приложений в свойство безопасности папки проводника Windows:
    • для Windows 2008 и более ранних версий: проверьте параметр Identity пула приложений (обычно это Network Service) и убедитесь, что этот идентификатор имеет полный контроль над cgi-bin;
    • для Windows 2008 SP2+ или Windows 2008 R2 и более поздних версий: для каждого пула приложений создается уникальный идентификатор. Имя идентификатора – это имя самого пула приложений. Чтобы добавить этот идентификатор в свойства безопасности файловой системы, щелкните на Locations и измените домен на имя локального компьютера. Затем введите в поле Enter the object names to select значение IIS APPPool\<apppoolname>. Нажмите кнопку Check Names, чтобы разрешить идентификатор.
      Рисунок 46. Предоставление идентификатору пула приложений IIS доступа к установке IBM Cognos на уровне файловой системы.
      Рисунок 46. Предоставление идентификатору пула приложений IIS доступа к установке IBM Cognos на уровне файловой системы.
      Рисунок 46. Предоставление идентификатору пула приложений IIS доступа к установке IBM Cognos на уровне файловой системы.

      За дополнительной информацией обращайтесь на страницу http://www.iis.net/learn/manage/configuring-security/application-pool-identities.
  2. Убедитесь, что используется пул приложений с нужной разрядностью. Если в cgi-bin установлен 32-разрядный шлюз, а пул приложений настроен на 64-разрядный, или наоборот, то произойдет ошибка HTTP 500. За инструкциями по исправлению настройки обращайтесь к разделу Настройка контейнера пула приложений.

При обращении к модулю ISAPI появляется диалоговое окно загрузки файла

При обращении к модулю IBM Cognos 10 ISAPI Gateway появляется диалоговое окно загрузки файла с предложением открыть его, сохранить или отменить действие.

Рисунок 47. Диалоговое окно загрузки файла, открытое IIS при использовании URL ISAPI
Рисунок 47. Диалоговое окно загрузки файла, открытое IIS при использовании URL ISAPI
Рисунок 47. Диалоговое окно загрузки файла, открытое IIS при использовании URL ISAPI

Возможным решением является проверка параметра Edit Feature Permission для отображения обработчика ISAPI. Он должен иметь значение Execute.

Ошибка PF-SRV-6116 при запуске IBM Cognos Administration

При вызове IBM Cognos Administration в верхней части страницы отображается сообщение об ошибке PF-SRV-6116 в желтой рамке, а остальная часть окна браузера остается белой.

Рисунок 48. Ошибка PF-SRV-6116 в IBM Cognos Administration
Рисунок 48. Ошибка PF-SRV-6116 в IBM Cognos Administration
Рисунок 48. Ошибка PF-SRV-6116 в IBM Cognos Administration

Ошибка при просмотре изображений в Report Studio

При просмотре изображений в Report Studio в диалоговом окне появляется следующее сообщение об ошибке:

Web Server error: 
The web request failed. 
404 – Not Found 
 <url>
Рисунок 49. Сообщение об ошибке веб-сервера при просмотре изображений в Report Studio
Рисунок 49. Сообщение об ошибке веб-сервера при просмотре изображений в Report Studio
Рисунок 49. Сообщение об ошибке веб-сервера при просмотре изображений в Report Studio

Возможные решения:

  • убедитесь, что WebDAV настроен для IIS. См. раздел Настройка WebDAV (факультативно);
  • если URL-адрес указывает на <alias>/samples/images, убедитесь, что установлены примеры IBM Cognos 10 BI. Примеры изображений не входят в состав базовой установки IBM Cognos 10 BI.

Приложение A – Требования к установке IIS

Прежде чем устанавливать IBM Cognos 10 с IIS 7.x, следует выполнить следующие предварительные требования по установке IIS7.x:

  • в Microsoft Server 2008 (R2) должна быть добавлена роль Web Server;
  • кроме того, для роли Web Server должны быть установлены следующие службы Role Services;
    • Common HTTP Features со следующими подкомпонентами:
      • Static Content
      • Default Document
      • Directory Browsing
      • HTTP Errors
    • Management Tools со следующими подкомпонентами:
      • IIS Management Console
      • IIS Management Scripts and Tools
      • Management Service
  • для использования cognos.cgi должна быть установлена служба CGI Role;
  • для использования cognosisapi.dll должна быть установлена служба ISAPI Extensions Role;
  • для использования WebDAV необходимо установить WebDAV Publishing Role Service.

Для проверки установленных служб Role Services щелкните на Start > Administrative Tools > Server Manager от лица администратора локальной системы. Теперь должен быть доступен экран Roles.

В разделе Web Server (IIS) этого экрана есть подкатегория Role Services со списком всех установленных ролевых служб. Если какая-либо из перечисленных выше ролевых служб отсутствует, нажмите кнопку Add Role Services и установите недостающие службы. Это может потребовать перезапуска сервера IIS.

Рисунок 50. Server Manager со списком установленных ролей сервера и соответствующих ролевых служб
Рисунок 50. Server Manager со списком установленных ролей сервера и соответствующих ролевых служб
Рисунок 50. Server Manager со списком установленных ролей сервера и соответствующих ролевых служб

Приложение B – Отключение функций безопасности Windows 2008 для устранения неполадок

В Microsoft Windows 2008 (R2) появилось несколько новых функций безопасности, которые позволяют упрочить защиту машины. В их числе User Account Control (UAC), Internet Explorer Enhanced Security Configuration (IE ESC) и Data Execution Prevention (DEP).

Каждая из этих функций влияет на компоненты IBM Cognos 10, исполняемые на сервере. В случае затруднений администратором может временно отключить эти функции безопасности. Вот некоторые причины, по которым может потребоваться временное отключение функции безопасности для выяснения того, не является ли она основной причиной проблемы:

  • DEP - проблемы с пулами приложений, такими как CGI или ISAPI; вызовы не завершаются или прерываются;
  • IE ESC - Internet Explorer блокирует доступ к URI шлюза; сообщения об ошибках при обращении к URI шлюза; перенаправления не работают;
  • UAC - нужно выполнить некоторый исполняемый файл с правами администратора, но реквизиты доступа администратора не удается передать. Попросите администратора отключить UAC на время настройки/установки.

Отключение любой из этих функций должно быть временным – только для устранения неполадок. Настоятельно рекомендуется оставить их все включенными для соблюдения правил и стандартов безопасности, так как IBM Cognos 10 на 100% совместим со всеми этими функциями. Имейте в виду, что отключение любой из этих функций может поставить под угрозу безопасность сервера и нарушить корпоративную политику безопасности. Подробные сведения о каждой из этих функций см. на страницах Microsoft Windows 2008 TechNet по адресу: http://technet.microsoft.com/en-us/library/cc754279(WS.10).aspx.

Отключение UAC

От лица администратора локальной системы:

  • выберите Control Panel из меню Start, затем выберите User Accounts;
  • на странице User Accounts щелкните на Change User Account Control Settings;
  • в окне User Account Control Settings переместите ползунок к Never notify – в самое нижнее возможное положение.
    Рисунок 51. Диалоговое окно User Account Control с ползунком, указывающим уровень оповещения
    Рисунок 51. Диалоговое окно User Account Control с ползунком, указывающим уровень оповещения
    Рисунок 51. Диалоговое окно User Account Control с ползунком, указывающим уровень оповещения
  • Нажмите кнопку ОК, чтобы сохранить изменения.

Отключение функции IE Enhanced Security Configuration (IE ESC)

Чтобы отключить функцию IE ESC, выполните следующие действия от лица администратора:

  • из меню Start выберите Administrative Tools, затем выберите Server Manager;
  • на панели проводника Server Manager слева выберите корневой элемент Server Manager <hostname>, нажав на него;
  • на правой панели Server Manager появятся параметры, зависящие от контекста. Щелкните на значке Настройка IE ESC.
    Рисунок 52. Панель параметров Server Manager со списком поддерживаемых конфигураций, таких как Firewall Configuration и Configure IE ESC
    Рисунок 52. Панель параметров Server Manager со списком поддерживаемых конфигураций, таких как Firewall Configuration и Configure IE ESC
  • Откроется диалоговое окно Internet Explorer Enhanced Security Configuration. Измените статус IE ESC для администраторов и для пользователей на Off и нажмите кнопку ОК, чтобы сохранить изменения.
    Рисунок 53. Диалоговое окно IE Enhanced Security Configuration, указывающее статус IE ESC для администраторов и обычных пользователей
    Рисунок 53. Диалоговое окно IE Enhanced Security Configuration, указывающее статус IE ESC для администраторов и обычных пользователей
    Рисунок 53. Диалоговое окно IE Enhanced Security Configuration, указывающее статус IE ESC для администраторов и обычных пользователей

Отключение DEP на сервере

Чтобы отключить функцию DEP, выполните следующие действия от лица администратора:

  • из меню Start выберите Computer, затем Properties;
  • в окне System Properties щелкните на Advanced System Settings на левой панели параметров;
  • в диалоговом окне Advanced System Properties выберите вкладку Advanced;
  • на вкладке Advanced нажмите кнопку Settings в разделе Performance;
  • в диалоговом окне Performance Options выберите вкладку Data Execution Prevention;
  • выберите первый вариант Turn on DEP for essential Windows programs and services only;
  • нажмите кнопку ОК, чтобы сохранить изменения.
    Рисунок 54. Вкладка Data Execution Prevention с двумя вариантами включения DEP для основных программ Windows и только для служб
    Рисунок 54. Вкладка Data Execution Prevention с двумя вариантами включения DEP для основных программ Windows и только для служб
    Рисунок 54. Вкладка Data Execution Prevention с двумя вариантами включения DEP для основных программ Windows и только для служб

Дополнительные сведения об IBM Cognos BI версии 10 можно найти в нижеследующем разделе Ресурсы.


Ресурсы для скачивания


Похожие темы


Комментарии

Войдите или зарегистрируйтесь для того чтобы оставлять комментарии или подписаться на них.

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=40
Zone=Большие данные и аналитика
ArticleID=1028615
ArticleTitle=Практические рекомендации по IBM Business Analytics: Настройка Microsoft Internet Information Services 7.x для IBM Cognos 10
publish-date=03212016