Упаковка и развертывание пользовательских виджетов (устарело)

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

Прежде чем начать

Убедитесь, что следующие объекты готовы:
  • Файл определения iWidget для пользовательского виджета
  • Необязательно: некоторые или все файлы реализации для пользовательского виджета. Вы можете закончить выполнение реализации, обновив виджет.
  • iWidget и любая реализация, упакованные в файл EAR
  • Необязательно: модуль документации, содержащий справочные файлы виджета
  • Определение регистрации пользовательского виджета для уже существующего или только что созданного файла-каталога

Об этой задаче

Упаковка и развертывание виджетов обычно представляет собой итерационный процесс. Настоящая процедура описывает, как упаковать и развернуть виджет в первый раз. Если вы обновляете существующий виджет, то процедура схожа, за следующими исключениями:
  • Используйте команду updateBusinessSpaceWidgets вместо команды installBusinessSpaceWidgets.
  • Пропустите шаг 1, если вы не обновляли файлы EAR, шаг 2, если вы не обновляли файл-каталог, и шаг 3, если вы не обновляли справочные файлы. Либо, вы можете включить эти файлы, но тогда используйте параметры -noWidgets, -noCatalogs и -noHelp, чтобы контролировать обновляемые объекты. Если вы обновляете файл EAR, то вы должны включить полный EAR.

Выполните следующие действия для каждой среды бизнес-пространства.

Процедура

  1. Создайте каталог ear. Скопируйте файлы EAR, содержащие файл определения виджета и файлы реализации для пользовательских виджетов. Скопируйте файлы EAR в каталог ear.
  2. Создайте каталог catalog и скопируйте в него файл-каталог XML (регистрация виджета).
  3. При наличии модулей документации создайте каталог help и скопируйте в него справочные модули.
  4. Сожмите каталоги ear, catalog, endpoints и help. Убедитесь, что структура файла .zip содержит следующие элементы:
    • ear\имя_файла_виджетов.ear (один или несколько файлов EAR)
    • catalog\имя_файла-каталога.xml
    • help\eclipse\plugins\*
    • endpoints\имя_файла_конечных_точек.xml
  5. В командной строке перейдите в каталог каталог_профайла/bin или каталог_кластера/bin.
  6. Введите wsadmin.bat -conntype NONE, затем введите соответствующую команду:
    • В некластерной среде:
      • Команда Jython:
        AdminTask.installBusinessSpaceWidgets('{-nodeName
        узел -serverName
        сервер -widgets
        полный_путь}')
      • Команда Jacl:
        $AdminTask
        installBusinessSpaceWidgets {-nodeName
        узел -serverName
        сервер -widgets
        полный_путь}
    • В кластерной среде:
      • Команда Jython:
        AdminTask.installBusinessSpaceWidgets('{-clusterName
        кластер -widgets
        полный_путь}')
      • Команда Jacl:
        $AdminTask
        installBusinessSpaceWidgets {-clusterName
        кластер -widgets
        полный_путь}
    Полный_путь - это имя и расположение созданного вами файла .zip.
    Дополнительная информация о команде installBusinessSpaceWidgets приведена в разделе Команда installBusinessSpaceWidgets. Если вы обновляете существующие виджеты, то воспользуйтесь вместо нее командой updateBusinessSpaceWidgets. Дополнительная информация о команде updateBusinessSpaceWidgets приведена в разделе Команда updateBusinessSpaceWidgets.
    Совет: Сохраните резервную копию файла .zip. Наличие резервной копии упростит обновление или удаление виджета, поскольку вам не придется заново создавать файл .zip. Иными словами, вместо того чтобы создавать каталоги и файлы на шагах 1-4, вам будет достаточно отредактировать резервную копию, чтобы внести изменения.
  7. Введите следующую команду:
    • Команда Jython:
      AdminConfig.save
    • Команда Jacl:
      $AdminConfig save
  8. Введите Exit.
  9. Если в среде настроен сервер HTTP или proxy, проверьте отображение модуля, чтобы убедиться, что пользовательские модули виджета отображаются на сервер HTTP или proxy:
    1. Войдите в административную консоль как администратор.
    2. Выберите Приложения > Типы приложений > Приложения J2EE WebSphere.
    3. На панели Приложения J2EE выберите имя приложения виджета.
    4. На вкладке Конфигурация в разделе Модули выберите Управление модулями.
    5. На странице Управление модулями приложения веб-сервер должен быть одним из выбранных назначений каждого модуля.
      • В таблице отметьте столбец Сервер для каждого модуля, чтобы веб-сервер был одним из выбранных назначений.
      • Если необходимо добавить веб-сервер, включите переключатель рядом с именем модуля. Затем с помощью клавиши Ctrl выберите несколько назначений в списке Кластеры и серверы. Например, для того чтобы веб-сервер обслуживал приложение, выберите кластер сервера приложений и веб-сервер, удерживая клавишу Ctrl. Нажмите Применить, OK и Сохранить для сохранения внесенных изменений.
  10. Если вы заново развернули существующий виджет, который вы изменили, то для просмотра изменений в браузере отключитесь от сводной панели монитора, очистите кэш браузера и затем подключитесь к сводной панели монитора.