Команда wsadmin позволяет получить доступ к четырем объектам, используемым для управления средой WebSphere, а также объекту-справке.
• AdminControl.
• AdminConfig.
• AdminApp.
• AdminTask.
• Help.
AdminControl
Скриптовый объект AdminControl используется для оперативного контроля. Он взаимодействует с компонентами MBean, представляющими действующие объекты серверного процесса WebSphere. Он включает в себя команды для запроса к работающим объектам и их атрибутам, а также вызов операций, применяемых к этим объектам. Наряду с оперативными командами, объект AdminControl поддерживает команды, запрашивающие информацию о подключенном сервере, удобные команды клиентской трассировки, команды восстановления соединения с сервером, а также запуска и останова сервера.
AdminConfig
Объект AdminConfig используется для управления конфигурационной информацией, содержащейся в хранилище. Данный объект взаимодействует с сервисным компонентом конфигурирования WebSphere Application Server, запрашивая и изменяя данные конфигурации. Вы можете использовать его для осуществления запросов к существующим конфигурационным объектам, для создания конфигурационных объектов, изменения существующих объектов и удаления конфигурационных объектов. В распределенной серверной среде команды AdminConfig доступны, только если скриптовый клиент подключен к администратору развертывания. При подключении к агенту узла или к управляемому серверу приложений команды AdminConfig не будут доступны, поскольку конфигурация этих серверных процессов является лишь копией основной конфигурации, которая находится на администраторе развертывания.
AdminApp
Объект AdminApp может обновлять метаданные приложений, связывать виртуальные хосты с Web-модулями и связывать серверы с модулями уже установленных приложений. Изменения приложений, такие как указание библиотеки, используемой приложением, или установка конфигурационных свойств, связанных с управлением сеансами, выполняются с помощью объекта AdminConfig.
AdminTask
Объект AdminTask используется для доступа к набору ориентированных на конкретные задачи административных команд, которые предлагают альтернативный способ доступа к командам конфигурирования и командам управления работающими объектами. Административные команды позволяют выполнять простые и сложные действия. Административные команды обнаруживаются динамически при запуске скриптового клиента. Набор доступных административных команд зависит от инсталлированной версии WebSphere Application Server. Вы можете использовать методы объекта AdminTask для доступа к этим командам.
Для каждой административной команды всегда есть два режима работы, а именно, пакетный и интерактивный. При использовании административной команды в интерактивном режиме вы выполняете серию шагов по вводу входных данных. Данный процесс предлагает пользователям текстовый мастер, напоминающий тот, который можно найти в административной консоли. Вы также можете использовать команду help для получения справки по любой из административных команд и по объекту AdminTask.
Help
Объект Help предоставляет информацию о доступных методах четырех объектов, осуществляющих управление, а также информацию об операциях и атрибутах работающих MBean. Например, чтобы получить список доступных методов объекта AdminControl, введите следующую команду:
wsadmin>print Help.AdminControl()
Чтобы увидеть детальное описание конкретного метода объекта и требующихся для него параметров, вызовите метод help целевого объекта, указав имя метода в качестве параметра метода help, как это показано в примере 5.8.
Пример 5.8. Получение справки по конкретному методу
wsadmin>print AdminControl.help(‘completeObjectName’) WASX7049I: Method: completeObjectName
Arguments: object name, template
Description: Returns a String version of an object name that matches the «template.» For example, the template might be «type=Server,*» If there are several MBeans that match the template, the first match
Точно также вы можете получить подробную справку по методам объектов AdminConfig, AdminApp и AdminTask.
Получение информации по операциям и атрибутам из объекта Help обсуждается в разделе «Поиск атрибутов и операций работающих MBean».
Среда выполнения
Все объекты AdminConfig, AdminTask и AdminApp предоставляют функциональность конфигурирования. Вы можете вызывать конфигурационные функции, имея соединение с сервером, или не имея его. Только объект AdminControl требует, чтобы сервер был запущен, поскольку его команды могут вызываться только применительно к работающим JMX MBean-компонентам.
Если сервер запущен, не рекомендуется запускать скриптовый клиент в локальном режиме, поскольку изменения конфигурации, сделанные в локальном режиме, не отражаются в конфигурации работающего сервера. Верно и обратное. В подключенном режиме доступность команд AdminConfig зависит от типа сервера, к которому подсоединен скриптовый клиент. Выполнять изменения конфигурации на агенте узла или на управляемом сервере приложений не рекомендуется.
Примечание. В настоящем обсуждении мы будем называть методы объектов AdminControl, AdminConfig, AdminApp, AdminTask и Help командами.
