Использование Visual Configuration Explorer

Visual Configuration Explorer (VCE) – это бесплатная утилита, доступная через IBM Support Assistant, с помощью которой Вы можете:

• Просмотреть и представить в графическом виде (в виде дерева) конфигурации многих продуктов WebSphere/Lotus/Tivoli.
• Просмотреть все используемые параметры, их значения, а так же найти значение конкретного свойства в необходимой области поиска. Например, максимальный размер хипа для каждой JVM в ячейке.
• Сравнивать части одной конфигурации WAS (узлы, сервера) или несколько разных конфигураций WAS (например, две ячейки) между собой. Например, если у одного из участников кластера возникли ошибки в работе, то можно сравнить его конфигурацию с другим участником кластера.
• Графическое отображение топологии WAS ускорит процесс понимания используемой конфигурации.
• Наглядно увидеть все взаимосвязи WAS с БД и менеджерами очередей.
• Создать схему топологии развертывания (deployment topology) и зависимостей для приложений.

Как установить Visual Configuration Explorer?

Для установки VCE, требуется IBM Support Assistant (ISA), о котором можно почитать и скачать здесь. После установки ISA:

• Запустите его.
• Если Вы только что установили ISA и пока не работали с ним, то выберите пункт меню “Обновить” (update) -> “Найти новые” (find new) -> “Дополнения продуктов” (products add-ons).
• В списке линеек ПО IBM раскройте WebSphere, найдите и выберите WebSphere Application Server необходимой версии. Нажмите “Далее” и “Установить“. Подождите некоторое время, пока ISA загрузит и развернет список утилит, доступных для выбранного WAS.
• После этого перейдите в пункт меню “Обновить” (update) -> “Поиск новых” (find new) -> “Дополнения утилит” (tools add-ons) -> “Прочие” (others).
• Выберите и установите Visual Configuration Explorer, после чего перезапустите ISA.

Сбор данных для VCE

• В ISA откройте пункт меню “Файл” (File) -> “Параметры” (Preferences), дважды нажмите на Visual Configuration Explorer, выберите “Utilities“. Укажите директорию в которую Вы хотите выгрузить VCE runtime, выберите “Visual Configuration Explorer Headless Automation Runtime” и нажмите “Deploy“.
• После этого, в указанной директории появится файл VCEHeadlessRuntime_v*.zip.
• Загрузите этот архив на целевую систему, где находится администратор развертывания и разархивируйте его.
• Перейдите в директорию vce и выполните следующую команду:

java -jar startup.jar -buildfile /path_to_unzip_VCEHeadlessRuntime/vce/wasexporter/wasexport.xml -Dwas.root=/was_install_root -Dprofile.name=dmgr_profile_name

Параметр -Dprofile.name является необязательным, он используется для подстановки в имена файла конфигурации и журналов, имени профайла администратора развертывания. Если параметр -Dprofile.name не используется, то имя файла с извлеченной конфигурацией будет websphere.configuration. Если Вы не знаете имя профайла dmgr, то его можно узнать выполнив команду manageprofiles.sh -listProfiles из директории bin, расположенной в was_install_root.

Вот пример использования этой команды для WAS на z/OS:

java -jar startup.jar -buildfile /service/WAS/vce/wasexporter/wasexport.xml -Dwas.root=/WebSphere/WAS/ed/dm1/DeploymentManager/ -Dprofile.name=default

• Внимание: VCE может очень хорошо использовать CPU!
• Убедитесь, что после выполнения команды появилась строка “BUILD SUCCESSFUL“, это означает, что в директории /vce/wasexporter/output/ сформировался файл с расширением .configuration
• Скопируйте этот файл к себе на ПК.

Работа с полученной конфигурацией в VCE

• Запустите VCE, для этого в ISA выберите “Запустить операцию” -> “Анализировать неполадку” и в раскрывшемся каталоге утилит выберите VCE.
• В меню: “Файл” -> Visual Configuration Explorer -> New Workspace…, укажите куда следует сохранить файл с рабочей областью. После выполненных действий появится окно следующего вида:

• Нажмите “Add Configuration…“:

• Укажите расположение файла .configuration, полученного ранее. После этого загруженная конфигурация будет доступна в разделе “Configurations” и с ней можно работать. Пример загруженной в VCE конфигурации:

• Для того, чтобы просмотреть параметры конфигурации WAS и их значения, необходимо раскрыть необходимую категорию параметров, на интересующем нас нажать правой кнопкой мыши, и выбрать “Show Properties“. После чего откроется фрейм для просмотра параметров, в левой части которого можно осуществлять навигацию, а в правой части будут отображаться параметры для выбранной категории:

• Для поиска конкретного параметра нужно, в навигаторе фрейма “Configurations“, нажать правой кнопкой мыши на том элементе, в области которого Вы собираетесь искать необходимый параметр, и выбрать “Search” (либо нажать на соответствующую иконку в виде фонарика). В строку поиска можно ввести как часть названия свойства, так и его значение. Результаты поиска отображаются в специальной области. Например, необходимо найти параметры, значения которых равны 512, полученные результаты поиска:

• Для того чтобы представить в графическом виде топологию WAS, необходимо во фрейме “Diagrams“, выбрать “Create a new diagram“. Укажите имя схемы, после чего откроется рабочая область, на которой можно размещать компоненты WAS, просто перетаскивая их из окна “Configurations“.
• Приведу самый простой способ отображения всех серверов WAS. В окне “Configurations” выберите ячейку и перетащите ее на область построения схемы:

• Затем на значке ячейки нажмите правой кнопки мыши, выберите “Apply Template” и далее “Show application servers“. Так с помощью уже имеющихся в VCE шаблонов отображения, мы получим схему компонентов WAS на которой будут отображены: ячейка, узлы и сервера (как HTTP, так и сервера приложений):

• В VCE можно создавать свои шаблоны для самых часто используемых графических представлений компонентов WAS. Полученную схему можно скопировать, либо сохранить в JPEG, для этого в пункте меню “Diagram” выберите “Export diagram image to JPEG“.
• Теперь о том как можно сравнивать конфигурации. Для этого, во фрейме “Configurations” или в рабочей области построения схемы, необходимо выделить элементы, которые собираемся сравнить, после чего нажать правую кнопку мыши и выбрать “Compare” (или нажать на иконку  в окне “Configurations“). Будет предложено выбрать какую-то одну конфигурацию в качестве базовой, для сравнения с ней остальных. Затем будет предложено выбрать один из двух вариантов отображения результатов сравнения: Subtrees или Properties. В обоих видах расхождения отмечаются красным цветом.
• Результаты сравнения, вида “Subtrees“, как видно из названия, представляют собой древовидное отображение параметров, в которых найдены расхождения:

• Вид Properties, это отображение различий конфигураций во фрейме “Properties“:

В этой статье мы рассмотрели основные приемы работы с Visual Configuration Explorer. Не смотря на то, что VCE – “старый солдат”, его значение и возможности востребованы и сегодня. Особенно он будет полезен тем, кто только начал разбираться с незнакомой ему конфигурацией WAS, когда необходимо иметь полное представление о всех компонентах среды, их взаимосвязях и используемых параметрах.