Различия

Здесь показаны различия между двумя версиями данной страницы.

--- unix:doc:bin:bq-asbman [2016/10/27 20:10]
kos создано
+++ unix:doc:bin:bq-asbman [2017/01/25 02:05] (текущий)
kos [Назначение]
@@ Строка 5: / Строка 5: @@
 ===== Назначение =====
-Выполнение asbman в среде, установленной запускающим скриптом.
+Выполнение OpenEdge утилиты **''asbman''** в среде, установленной запускающим скриптом.
-Запуск, останов, получение статуса и управление заданным списком логин-брокеров
-(Application Servers, Webspeed Servers и Name Servers) с возможностью обращения
+Запуск, останов, получение статуса и управление заданным списком логин-брокеров (Application Servers, Webspeed Servers и Name Servers) с возможностью обращения к отдельным инстансам.
-к отдельным инстансам.
-Автоматический запуск и завершение списка логин-брокеров при старте или останове
+Автоматический запуск и останов заданного списка логин-брокеров при старте или останове брокера БД.
-брокера БД.
 ===== Синтаксис =====
-     bq41d asbman аргументы
+''bq41d asbman'' //аргументы//
+В качестве //аргументов// используются любые параметры утилиты ''asbman'', описанные в документации:
-В качестве аргументов используются любые параметры утилиты ''asbman''
+[[https://documentation.progress.com/output/ua/OpenEdge_latest/index.html#page/asadm/asbman.html#|OpenEdge Application Server: Administration Command and Utility Reference: ASBMAN]]
 ==== Переменные окружения ====
-     BQAppServerNames
+''BQAppServerNames'' - список логин-брокеров (разделителем может служить запятая, точка с запятой или пробел).
-     BQproadsvConnect
-     BQasbmanParams
+<del>''BQasbmanParams''   - дополнительные параметры вызова asbman</del>
+<del>''BQproadsvConnect'' - параметры подключения к proadsv</del>
 ===== Использование =====
-В качестве аргументов используются любые параметры утилиты ''asbman'' в зависимости
+В данном функционале предусмотрены следующие режимы использования:
-от режима вызова. Возможны следующие режимы:
 ==== Ручной режим ====
@@ Строка 34: / Строка 36: @@
 Устанавливается, если в списке аргументов при помощи опции ''-name'' или ''-i''
 задан конкретный инстанс или указаны справочные опции ''-help'' или ''-h'',
-например:
+например:<code bash>
+  bq41d asbman -name foo -start
+  bq41d asbman -i qbis -stop
+  bq41d asbman -i NS1 -query
+  bq41d asbman -help
+  bq41d asbman -h
+</code>
+В этом режиме утилите ''asbman'' передаются все указанные аргументы без модификации.
+Режим предназначен для управления отдельными инстансами (любыми) в среде запускающего скрипта.
+Синтаксис и формат использования полностью совпадают с форматом утилиты asbman установленного
+релиза Progress OpenEdge. Местоположение релиза определяется переменной окружения ''DLC'',
+задаваемой запускающим скриптом.
+Во всех режимах команда ''asbman'' запускается с полномочиями текущего пользователя,
+выполняющего в данный момент скрипт bq.sh, то есть никакой смены полномочий не производится.
-     bq41d asbman -name foo -start
-     bq41d asbman -i NS1 -query
-     bq41d asbman -help
-     bq41d asbman -h
-В этом режиме утилите asbman передаются все указанные аргументы без модификации. Режим предназначен для управления отдельными инстансами в среде запускающего скрипта.
 ==== Режим "по списку" ====
@@ Строка 48: / Строка 62: @@
 Режим предназначен для управления списком Application/Webspeed серверов.
 Список задается внешней переменной ''BQAppServerNames'', которую целесообразно
-определять в запускающем скрипте, например:
+определять в запускающем скрипте, например: <code bash>
-     BQAppServerNames="one,two,three"		# list of AppServers
+  BQAppServerNames="one,two,three"		# list of AppServers
-     export BQAppServerNames
+  export BQAppServerNames
+</code>
 Разделителями в списке могут являться символы запятая, точка с запятой
 или пробел.
 При вызове в режиме //"по списку"// указанные в команде аргументы применяются
-циклически для каждого элемента списка. То есть, например, команда:
+циклически для каждого элемента списка. То есть, например, команда: <code bash>
-     bq41d asbman -q
+  bq41d asbman -q
-будет аналогична последовательным командам:
+</code>
+будет аналогична последовательным командам: <code bash>
-     bq41d asbman -name "one" -q
+  bq41d asbman -name "one" -q
-     bq41d asbman -name "two" -q
+  bq41d asbman -name "two" -q
-     bq41d asbman -name "three" -q
+  bq41d asbman -name "three" -q
+</code>
 __Примечание:__ в режиме //"по списку"// первый параметр для asbman можно указывать
 без лидирующего символа '-', например, следующие команды будут аналогичны:
-     bq41d asbman -start
+    bq41d asbman -start
-     bq41d asbman start
+    bq41d asbman start
 Это позволяет упростить интеграцию с другими скриптами.
-==== Режим автоматического старта/останова ====
+==== Автоматический старт/останов ====
 Если переменная ''BQAppServerNames'' определена и содержит список имен логин-брокеров, то:
-   * При каждом успешном запуске брокера БД командой ''bq41d start'' будет происходить запуск всех указанных в списке логин-брокеров с помощью команды: ''bq41d asbman -start''
+   * При каждом успешном запуске брокера БД командой ''bq41d start'' будет происходить запуск всех указанных в списке логин-брокеров с помощью команды:\\ ''bq41d asbman -start''
-   * После успешного останова брокера командой ''bq41d stop'' будет происходить останов всех указанных в списке логин-брокеров с помощью команды: ''bq41d asbman -kill''
+   * После успешного останова брокера командой ''bq41d stop'' будет происходить останов всех указанных в списке логин-брокеров с помощью команды:\\ ''bq41d asbman -kill''
 Возможность ручного управления в обоих режимах при этом полностью сохраняется.
+__Примечание:__ Если при интерактивном останове администратор отменит дальнейшее
+выполнение ''proshut'' и  база останется открытой, то команда на останов логин-брокеров
+также не будет выполнена.
+===== Условия  =====
+Данное описание применимо для версии скрипта ''bq.sh'' не ниже указанной в заголовке.
+Проверить версию ''bq.sh'' можно командой:
-=== Условия  ===
-Здесь используется ''bq.sh'' версии не ниже ''v.4.5.0''
-Проверить можно командой:
    bq41d --ver
-Обновить можно из: http://support.bis.ru/info
+Обновить bq.sh можно из: http://support.bis.ru/info
 **//"Текущая версия скрипта bq.sh"//**\\
-Либо использовать команды в соответствии с документацией OpenEdge с
-помощью интерфейса:
+===== Документация =====
-   bq41d exec <команда>
+[[https://documentation.progress.com/output/ua/OpenEdge_latest/index.html#page/asadm/asbman.html#|OpenEdge Application Server: Administration Command and Utility Reference: ASBMAN]]
+===== Изменения по версиям =====
+TT#0109685 - исходная заявка на разработку.
+В версиях bq.sh, начиная с 4.6.1, действует вышеописанный порядок
+автоматического останова логин-брокеров.
+В bq.sh версии до 4.6.0 (включительно) действовал другой порядок
+автоматического останова asbman. Ниже приведена цитата из описания старой версии:
+==============================================================================
+<code>
+Устарело:  Перед каждой попыткой останова брокера командой "bq41d stop" будет
+Устарело: происходить останов всех указанных списком App серверов командой
+Устарело:     "bq41d asbman -kill"
+Устарело:
+Устарело:     Примечание: если при интерактивном останове администратор отменит дальнейшее
+Устарело:     выполнение proshut, то, несмотря на то, что брокер БД останется запущенным,
+Устарело:     App серверы к этому моменту будут уже завершены.
+</code>
+==============================================================================
+{{tag>scripts doc bin}}

Вы посетили:

Различия

Поиск

Инструменты