Файл конфигурации плагина необходимо заново генерировать и распространять среди Web-серверов, когда в конфигурации WebSphere появляются изменения, затрагивающие передачу запросов от Web-сервера к серверу приложений. К таким изменениям относятся:
• инсталляция приложения;
• создание или изменение виртуального хоста;
• создание нового сервера;
• изменение параметров HTTP-транспорта;
• создание или изменение кластера.
Файл плагина можно заново сгенерировать вручную или с помощью средств администрирования. Вы также можете настроить свойства плагина Web-сервера так, чтобы генерация файла происходила автоматически в случае внесения соответствующих изменений. См. раздел «Включение автоматического воссоздания плагина».
Чтобы заново воссоздать конфигурацию плагина вручную, вы можете использовать административную консоль или команду GetPluginCfg.
Генерация плагина с помощью административной консоли
Чтобы сгенерировать или воссоздать файл конфигурации плагина, выполните следующие действия.
1. Выберите пункт Servers (Серверы) → Web servers (Web-серверы).
2. Установите флажок слева от Web-сервера.
3. Нажмите Generate Plug-in (Сгенерировать плагин).
4. Убедитесь, что генерация прошла успешно, просмотрев сообщения. Сообщение об успехе сопровождается указанием местоположения файла конфигурации плагина:
<дир_профиля>/config/cells/<имя_ячейки>/nodes/<узел_web_сервера>/servers/ <web_сервер>/plugin-cfg.xml
См. рис. 7.14.
Рис. 7.14. Определения Web-серверов
5. Вы можете просматривать файл конфигурации плагина, нажав кнопку View (Просмотр) около имени файла конфигурации плагина на странице свойств плагина, которая находится в определениях Web-сервера. См. рис. 7.15. Вы также можете открыть его в текстовом редакторе.
Чтобы использовать новый файл plugin-cfg.xml, вы должны передать его в систему Web-сервера. См. раздел 7.3.2, «Распространение файла конфигурации плагина».
Рис. 7.15. Свойства плагина
Воссоздание плагина с помощью команды GenPluginCfg
Команда GenPluginCfg используется для повторной генерации файла конфигурации плагина. В зависимости от платформы, эта команда может выглядеть так:
• Linux и UNIX: GenPluginCfg.s h
• Windows: GenPluginCfg.bat
Вы можете использовать опцию — profileName для того, чтобы указать профиль процесса сервера приложений в системе с несколькими профилями. В среде с одним профилем опция — profileName не является обязательной. Без этой опции используется профиль, заданный по умолчанию. В распределенной серверной среде профилем, заданным по умолчанию, является профиль менеджера размещения.
Синтаксис
Команда GenPluginCfg читает содержимое хранилища конфигурации на локальном узле и генерирует файл конфигурации плагина Web-сервера.
Синтаксис команды GenPluginCfg следующий:
:GenPluginCfg.bat(sh) [options]
Все опции являются необязательными. Опции перечислены в табл. 7.1.
Чтобы сгенерировать конфигурацию плагина для всех кластеров ячейки, введите следующую команду:
GenPluginCfg — cell.name NetworkDeploymentCell
Чтобы сгенерировать конфигурацию плагина для одного сервера, введите такую команду:
GenPluginCfg — cell.name BaseApplicationServerCell — node.name appServerNode — server.
name appServerName
Если команда запускается без опции — webserver.name имяWebСервера, то файл генерации плагина генерируется на основе топологии.
Включение автоматической повторной генерации плагина
Служба конфигурации плагина Web-сервера по умолчанию повторно генерирует файл plugin-cfg.xml автоматически. Вы можете просматривать или изменять настройки конфигурации службы конфигурирования плагина Web-сервера.
Смотрите пример 7.14. Чтобы просмотреть или изменить свойство генерации плагина, выполните следующие действия.
1. Выберите пункт Servers (Серверы) → Web servers (Web-серверы).
2. Щелкните мышью по Web-серверу.
3. Выберите пункт Plug-in properties (Свойства плагина) в разделе Additional Properties (Дополнительные свойства).
4. Посмотрите или измените значение опции Automatically generate the plug-in
configuration file (Автоматически генерировать файл конфигурации плагина).
Если установить эту опцию, служба конфигурирования плагина Web-сервера будет автоматически генерировать файл конфигурации плагина при каждом изменении среды Web-сервера. Например, файл конфигурации плагина воссоздается в случае одного из следующих событий.
• На связанном с Web-сервером сервере приложений размещается новое приложение.
• Сохраняется определение Web-сервера.
• Приложение удаляется со связанного с Web-сервером сервера приложений.
• Создается новый виртуальный хост.
При обновлении определения виртуального хоста файл конфигурации плагина автоматически воссоздается для всех Web-серверов.
