Это старая версия документа.


asbman - интерфейс bq.sh к утилите asbman для управления логин-брокерами

Версия: bq.sh ver. 4.6.1

Назначение

Выполнение asbman в среде, установленной запускающим скриптом. Запуск, останов, получение статуса и управление заданным списком логин-брокеров (Application Servers, Webspeed Servers и Name Servers) с возможностью обращения к отдельным инстансам. Автоматический запуск и завершение списка логин-брокеров при старте или останове брокера БД.

Синтаксис

bq41d asbman аргументы

В качестве аргументов используются любые параметры утилиты asbman

Переменные окружения

BQAppServerNames - список логин-брокеров (разделителем может служить запятая, точка с запятой или пробел).

BQasbmanParams - дополнительные параметры вызова asbman

BQproadsvConnect - параметры подключения к proadsv

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

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

Ручной режим

Устанавливается, если в списке аргументов при помощи опции -name или -i задан конкретный инстанс или указаны справочные опции -help или -h, например:

   bq41d asbman -name foo -start
   bq41d asbman -i NS1 -query
   bq41d asbman -help
   bq41d asbman -h

В этом режиме утилите asbman передаются все указанные аргументы без модификации. Режим предназначен для управления отдельными инстансами в среде запускающего скрипта.

Режим "по списку"

Устанавливается в случае отсутствия в параметрах упомянутых выше опций. Режим предназначен для управления списком Application/Webspeed серверов. Список задается внешней переменной BQAppServerNames, которую целесообразно определять в запускающем скрипте, например:

  BQAppServerNames="one,two,three"		# list of AppServers
  export BQAppServerNames

Разделителями в списке могут являться символы запятая, точка с запятой или пробел. При вызове в режиме «по списку» указанные в команде аргументы применяются циклически для каждого элемента списка. То есть, например, команда:

  bq41d asbman -q

будет аналогична последовательным командам:

  bq41d asbman -name "one" -q
  bq41d asbman -name "two" -q
  bq41d asbman -name "three" -q

Примечание: в режиме «по списку» первый параметр для asbman можно указывать без лидирующего символа '-', например, следующие команды будут аналогичны:

  bq41d asbman -start
  bq41d asbman start

Это позволяет упростить интеграцию с другими скриптами.

Автоматический старт/останов

Если переменная BQAppServerNames определена и содержит список имен логин-брокеров, то:

  • При каждом успешном запуске брокера БД командой bq41d start будет происходить запуск всех указанных в списке логин-брокеров с помощью команды:
    bq41d asbman -start
  • После успешного останова брокера командой bq41d stop будет происходить останов всех указанных в списке логин-брокеров с помощью команды:
    bq41d asbman -kill

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

Условия

Здесь используется bq.sh версии не ниже v.4.5.0 Проверить можно командой:

 bq41d --ver

Обновить можно из: http://support.bis.ru/info «Текущая версия скрипта bq.sh»
Либо использовать команды в соответствии с документацией OpenEdge с помощью интерфейса:

 bq41d exec <команда>