# Путеводители установки модулей веб-сервера для WebSphere Application Server Network Deployment

Начало работы
Путеводители установки модулей:

1. Установка модулей веб-сервера для автономных серверов приложений
2. Установка модулей веб-сервера для распределенных сред

## Установка модулей веб-сервера для автономных серверов приложений

| Сценарий удаленной установки | Сценарий локальной установки
## Типичная среда | # Рабочая среда (рекомендуется) | # Среда разработки
## Установка и настройка |
Установка сервера приложений:
(Система A)
1. | Установите IBM Installation Manager.
2. | С помощью Installation Manager установите продукт WebSphere Application Server Network Deployment.
3. | Создайте автономный сервер приложений.
Установка веб-сервера и модулей веб-сервера:
(Система B)
4. | Установите IBM Installation Manager.
5. | С помощью Installation Manager установите IBM HTTP Server или другой поддерживаемый веб-сервер.
6. | С помощью Installation Manager установите модули веб-сервера для WebSphere Application Server.
Настройка модуля веб-сервера:
(Система B)
7. | С помощью Installation Manager установите Инструменты настройки WebSphere.
8. | Откройте Инструменты настройки WebSphere и запустите Инструмент настройки модулей веб-сервера для настройки модуля веб-сервера. Сценарий создания и настройки веб-сервера создается в каталоге каталог-модулей`/bin`.
9. | Скопируйте сценарий configureимя-веб-сервера в буфер обмена для последующей вставки в систему A. В разделе Инструкции по выполнению сценария настройки в среде с разными платформами содержится дополнительная информация о выполнении сценариев конфигурации в следующих случаях: Одна система работает под управлением Windows, другая - под управлением Linux или UNIX. В системах применяются разные кодировки файлов.
Создание определения веб-сервера:
(Система A)
10. | Вставьте сценарий `configureимя-веб-сервера` из системы B в каталог каталог-сервера-приложений`/bin` в системе A
11. | Запустите сервер приложений в системе A.
12. | Запустите сценарий в системе A.
Проверка:
(Система A)
13. | Убедитесь, что сервер приложений работает.
(Система B)
14. | Запустите IBM HTTP Server или другой поддерживаемый веб-сервер.
15. | Запустите сервлет наблюдения за запросами.
| Для проверки собственного приложения восстановите и распространите файл `plugin-cfg.xml` после настройки (установки) приложения.
Установка сервера приложений:
(Система A)
1. | Установите IBM Installation Manager.
2. | С помощью Installation Manager установите продукт WebSphere Application Server Network Deployment.
3. | Создайте автономный сервер приложений.
Установка веб-сервера и модулей веб-сервера:
(Система A)
4. | С помощью Installation Manager установите IBM HTTP Server или другой поддерживаемый веб-сервер.
5. | С помощью Installation Manager установите модули веб-сервера для WebSphere Application Server.
Настройка модуля веб-сервера и создание определения веб-сервера:
(Система A)
6. | С помощью Installation Manager установите Инструменты настройки WebSphere.
7. | Откройте Инструменты настройки WebSphere и запустите Инструмент настройки модулей веб-сервера для настройки модуля веб-сервера и создания определения веб-сервера.
8. | Запустите сервер приложений.
Проверка:
(Система A)
9. | Убедитесь, что сервер приложений работает.
10. | Запустите IBM HTTP Server или другой поддерживаемый веб-сервер.
11. | Запустите сервлет наблюдения за запросами.
## Восстановление файла `plugin-cfg.xml` | Во время настройки в каталоге каталог-модулей`/config/имя-веб-сервера` в системе B устанавливается временный файл `plugin-cfg.xml`. Файл `plugin-cfg.xml` автоматически восстанавливается службой настройки модулей веб-сервера. Для применения действующего файла `plugin-cfg.xml` с сервера приложений распространите файл `plugin-cfg.xml` , как описано в следующем разделе. | Файл `plugin-cfg.xml` автоматически восстанавливается службой настройки модулей веб-сервера. Файл `plugin-cfg.xml` генерируется в каталоге каталог-профайла`/config/cells/ячейка/nodes/узел/servers/имя-веб-сервера` при создании определения веб-сервера.
## Распространение файла `plugin-cfg.xml` | Служба настройки модулей веб-сервера распространяет файл `plugin-cfg.xml` автоматически только для IBM HTTP Server. Для включения автоматического распространения выполните разовую настройку. Для всех других веб-серверов распространите файл конфигурации модуля вручную, скопировав файл `plugin-cfg.xml` из каталога каталог-профайла`/config/cells/ячейка/nodes/узел/servers/имя-веб-сервера` в системе A в каталог `каталог-модулей/config/имя-веб-сервера` в системе B. | Для перемещения файла `plugin-cfg.xml` из каталога каталог-профайла/config/cells/ячейка/nodes/узел/servers/имя-веб-сервера в каталог каталог-модулей/config/имя-веб-сервера используйте опцию propagate.

### Удаленная топология | ### Локальная топология

# Установка модулей веб-сервера для распределенных сред (ячеек)
| Сценарий удаленной распределенной установки | Сценарий локальной распределенной установки
## Типичная среда | # Рабочая среда (рекомендуется) | # Среда разработки
## Установка и настройка |
Установка администратора развертывания:
(Система A)
1. | Установите IBM Installation Manager.
2. | С помощью Installation Manager установите продукт WebSphere Application Server Network Deployment.
3. | Создайте профайл администратора развертывания.
4. | Убедитесь, что администратор развертывания работает. Это необходимо для синхронизации узлов измененных файлов конфигурации.
Установка сервера приложений:
(Система B)
5. | Установите IBM Installation Manager.
6. | С помощью Installation Manager установите продукт WebSphere Application Server Network Deployment.
7. | Создайте автономный сервер приложений.
8. | Добавьте узел в ячейку администратора развертывания для запуска процесса агента узла. Запустите агент узла в существующем управляемом узле. Администратор развертывания и агент узла должны работать, иначе не будет выполняться синхронизация узлов измененных файлов конфигурации.
Установка веб-сервера и модулей веб-сервера:
(Система C)
9. | Установите IBM Installation Manager.
10. | С помощью Installation Manager установите IBM HTTP Server или другой поддерживаемый веб-сервер.
11. | С помощью Installation Manager установите модули веб-сервера для WebSphere Application Server.
Настройка модуля веб-сервера:
(Система C)
12. | С помощью Installation Manager установите Инструменты настройки WebSphere.
13. | Откройте Инструменты настройки WebSphere и запустите Инструмент настройки модулей веб-сервера для настройки модуля веб-сервера. Сценарий создания и настройки веб-сервера создается в каталоге каталог-модулей`/bin`.
14. | Скопируйте сценарий configureимя-веб-сервера в буфер обмена для последующей вставки в систему A. В разделе Инструкции по выполнению сценария настройки в среде с разными платформами содержится дополнительная информация о выполнении сценариев конфигурации в следующих случаях: Одна система работает под управлением Windows, другая - под управлением Linux или UNIX. В системах применяются разные кодировки файлов.
Создание определения веб-сервера:
(Система A)
15. | Вставьте сценарий configureимя-веб-сервера из системы C в каталог каталог-сервера-приложений `/bin` в системе A.
16. | Запустите сценарий из командной строки. Для выполнения этого шага требуется, чтобы администратор развертывания и агент узла работали. Если была включена защита или изменен тип коннектора JMX по умолчанию, то внесите изменения в сценарий, добавив соответствующие параметры.
Проверка:
(Системы A и B)
17. | Для запуска сервера приложений в системе B используйте административную консоль администратора развертывания в системе A.
(Система C)
18. | Запустите IBM HTTP Server или другой поддерживаемый веб-сервер.
19. | Запустите сервлет наблюдения за запросами.
Примечание: следующая процедура описывает установку модулей в двух системах. Однако ее можно выполнить в одной системе.
Установка администратора развертывания:
(Система A)
1. | Установите IBM Installation Manager.
2. | С помощью Installation Manager установите продукт WebSphere Application Server Network Deployment.
3. | Создайте профайл администратора развертывания.
4. | Убедитесь, что администратор развертывания работает. Это необходимо для синхронизации узлов измененных файлов конфигурации.
Установка сервера приложений:
(Система B)
5. | Установите IBM Installation Manager.
6. | С помощью Installation Manager установите продукт WebSphere Application Server Network Deployment.
7. | Создайте автономный сервер приложений.
8. | Добавьте узел в ячейку администратора развертывания для запуска процесса агента узла. Запустите агент узла в существующем управляемом узле. Администратор развертывания и агент узла должны работать, иначе не будет выполняться синхронизация узлов измененных файлов конфигурации.
Установка веб-сервера и модулей веб-сервера:
(Система B)
9. | С помощью Installation Manager установите IBM HTTP Server или другой поддерживаемый веб-сервер.
10. | С помощью Installation Manager установите модули веб-сервера для WebSphere Application Server.
Настройка модуля веб-сервера:
(Система B)
11. | С помощью Installation Manager установите Инструменты настройки WebSphere.
12. | Откройте Инструменты настройки WebSphere и запустите Инструмент настройки модулей веб-сервера для настройки модуля веб-сервера и создания определения веб-сервера. Сценарий создания и настройки веб-сервера создается в каталоге каталог-модулей`/bin`.
13. | Скопируйте сценарий configureимя-веб-сервера в буфер обмена для последующей вставки в систему A. В разделе Инструкции по выполнению сценария настройки в среде с разными платформами содержится дополнительная информация о выполнении сценариев конфигурации в следующих случаях: Одна система работает под управлением Windows, другая - под управлением Linux или UNIX. В системах применяются разные кодировки файлов.
Создание определения веб-сервера:
(Система A)
14. | Вставьте сценарий configureимя-веб-сервера из системы B в каталог каталог-сервера-приложений `/bin` в системе A.
15. | Запустите сценарий из командной строки. Для выполнения этого шага требуется, чтобы администратор развертывания и агент узла работали. Если была включена защита или изменен тип коннектора JMX по умолчанию, то внесите изменения в сценарий, добавив соответствующие параметры.
Проверка:
(Системы A и B)
16. | Для запуска сервера приложений в системе B используйте административную консоль администратора развертывания в системе A.
17. | Запустите IBM HTTP Server или другой поддерживаемый веб-сервер. Перед запуском Domino Web Server в системе Linux или UNIX получите сценарий каталог-модулей`/setupPluginCfg.sh`.
18. | Запустите сервлет наблюдения за запросами.
## Восстановление файла `plugin-cfg.xml` | Во время настройки в каталоге каталог-модулей`/config/имя-веб-сервера` в системе C устанавливается временный файл `plugin-cfg.xml`. Файл `plugin-cfg.xml` автоматически восстанавливается службой настройки модулей веб-сервера. Для применения реально существующего файла `plugin-cfg.xml` с сервера приложений распространите файл `plugin-cfg.xml`, как описано в следующем разделе. | Файл `plugin-cfg.xml` генерируется в каталоге каталог-профайла`/config/cells/ячейка/nodes/узел/servers/имя-веб-сервера` при создании определения веб-сервера. Восстанавливайте файл `plugin-cfg.xml` в определении веб-сервера на сервере приложений всякий раз, когда изменяется конфигурация. Веб-сервер имеет прямой доступ к этому файлу, когда бы он не восстанавливался. Когда служба настройки модулей веб-сервера (служба администрирования) включена в системе A, то файл `plugin-cfg.xml` автоматически генерируется для всех веб-серверов.
## Распространение файла `plugin-cfg.xml` | Служба настройки модулей веб-сервера распространяет файл `plugin-cfg.xml` автоматически только для IBM HTTP Server. Для включения автоматического распространения выполните разовую настройку, описанную в последнем разделе этого путеводителя. Для всех других веб-серверов распространите файл конфигурации модуля, вручную скопировав файл `plugin-cfg.xml` из каталога каталог-профайла `/config/cells/ячейка/nodes/узел/servers/имя-веб-сервера` в системе A в каталог каталог-модулей`/config/имя-веб-сервера` в системе C. | Для перемещения файла `plugin-cfg.xml` из каталога каталог-профайла/config/cells/ячейка/nodes/узел/servers/имя-веб-сервера в каталог каталог-модулей/config/имя-веб-сервера используйте опцию propagate.

### Удаленная топология | ### Локальная топология

# Процедура настройки и устранения неполадок при автоматическом распространении Служба настройки модулей веб-сервера распространяет файл `plugin-cfg.xml` автоматически только для IBM HTTP Server. Для включения автоматического распространения выполните следующую разовую настройку: Создайте user=adminUser, password=adminPassword в файле каталог-IHS`/conf/admin.passwd`. Пример: c:\ws\ihs85\bin\htpasswd -cb c:\ws\ihs85\conf\admin.passwd adminUser adminPassword В административной консоли выберите Серверы > Веб-серверы > веб-сервер1 > Управление удаленным сервером. Задайте следующие значения: admin Port=8008, User Id=adminUser, Password=adminPassword. Задайте правильные права доступа для чтения/записи файлов `httpd.conf` и `plugin-cfg.xml`. Дополнительная информация приведена в файле каталог-IHS`/logs/admin_error.log`. Для автоматического распространения файла конфигурации модуля требуется, чтобы работал административный сервер IBM HTTP. Если для управления сервером IBM HTTP Server применяется административная консоль WebSphere Application Server, то может выдаваться следующее сообщение об ошибке:
    "Не удалось подключиться к серверу администрирования IHS - ошибка"
Выполните следующую процедуру: Проверьте, работает ли сервер администрирования IBM HTTP Server. Убедитесь, что имя хоста и порт веб-сервера, определенные в административной консоли WebSphere Application Server, совпадают с именем хоста и портом администрирования IBM HTTP Server. Убедитесь в том, что брандмауэр не препятствует доступу к серверу администрирования IBM HTTP Server с административной консоли WebSphere Application Server. Убедитесь в том, что ИД пользователя и пароль, которые указываются в административной консоли WebSphere Application Server в процессе удаленного управления, созданы в файле `admin.passwd` с помощью команды htpasswd. При подключении в защищенном режиме убедитесь, личный сертификат keydb сервера администрирования IBM HTTP Server экспортируется в базу данных ключей WebSphere Application Server как подписывающий сертификат. Эта база данных ключей задается с помощью директивы `com.ibm.ssl.trustStore` в файле `sas.client.props` том в профайле, в котором работает административная консоль. Это замечание относится, главным образом, к собственным сертификатам. Если неполадки по-прежнему сохраняются, то для определения их причин просмотрите файл `admin_error.log` IBM HTTP Server и протоколы WebSphere Application Server (файл `trace.log`).

- # Инструкции по выполнению сценария настройки в среде с разными платформами При настройке удаленного веб-сервера могут существовать различия в операционных системах и платформах: Одна система работает под управлением Windows, другая - под управлением Linux или UNIX. Применяемые в системах кодировки по умолчанию не совпадают. Одна система работает под управлением Windows, другая - под управлением Linux или UNIX Если одна система работает под управлением Linux или UNIX, а другая - под управлением Windows, используйте сценарий, созданный в каталоге `каталог-модулей/bin/crossPlatformScripts`. Применяемые в системах кодировки по умолчанию не совпадают Если в двух системах применяется разная кодировка файлов по умолчанию, то сценарий `configureимя-веб-сервера.bat` или `configureимя-веб-сервера.sh` может быть поврежден. Это может произойти в том случае, когда в одной системе настроена локаль с набором двухбайтовых символов (DBCS), а в другой - нет. Определите кодировку файлов для каждой системы и используйте одну из следующих процедур для обхода неполадки. Для определения кодировки файлов по умолчанию выполните соответствующую команду: В система Windows:
      CHCP
- В системах Linux и UNIX:
      locale
Результат выполнения этой команды в каждой системе используйте в качестве значения переменной кодировка-в-системе-веб-сервера и переменной кодировка-в-системе-сервера-приложений в одной из следующих процедур. Процедуры для устранения различий в кодировке Предположим, что веб-сервер работает в системе Linux, а продукт Network Deployment - в системе Windows. Веб-сервер работает в системе Linux Выполните следующую команду в системе Linux или UNIX для кодирования файла сценария, применяемого для настройки определения веб-сервера, перед тем как передать этот файл в систему Windows по FTP в двоичном режиме:
    iconv -f кодировка-в-системе-веб-сервера \
          -t кодировка-в-системе-сервера-приложений \
             configureимя-веб-сервера.bat
Если команда вводится в одной строке, не указывайте символы продолжения Linux и UNIX (\). Важная информация: в имени файла сценария используется имя (псевдоним) веб-сервера. Это имя не может содержать символы из набора двухбайтовых символов (DBCS), если для сервера IBM HTTP Server планируется настроить автоматическое распространение. Теперь предположим, что веб-сервер работает в системе Windows, а продукт Network Deployment - в системе Linux или UNIX. Веб-сервер работает в системе Windows Выполните следующую команду в системе Linux или UNIX для кодирования файла сценария, применяемого для настройки определения веб-сервера, после передачи этого файла по FTP в двоичном режиме:
    iconv -f кодировка-в-системе-веб-сервера \
          -t кодировка-в-системе-сервера-приложений \
             configureимя-веб-сервера.sh
Если команда вводится в одной строке, не указывайте символы продолжения Linux и UNIX (\). Если в вашей системе не поддерживается преобразование с помощью команды iconv, то скопируйте содержимое сценария настройки веб-сервера в буфер обмена и вставьте его в системе, где работает сервер приложений.