Различия

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

--- unix:doc:bin:bq-runat [2016/11/03 22:42]
kos
+++ unix:doc:bin:bq-runat [2016/11/17 20:34] (текущий)
kos [BQRunAt - функционал bq.sh для запуска внешних команд при старте/останове брокера БД]
@@ Строка 2: / Строка 2: @@
 Версия: bq.sh ver. 4.6.2 \\
-TT#: 0139423
+TT#: 0139423, 0291009
 ===== Назначение =====
@@ Строка 8: / Строка 8: @@
 Обеспечение возможности запуска настраиваемых shell-команд в привязке к событиям старта и останова брокера БД.
 Предусмотрено до пяти команд в каждом из перечисленных временных отрезков:
-  * непосредственно перед моментом запуска брокера (proserve)
+  * непосредственно перед моментом запуска брокера БД (proserve)
   * после успешного запуска брокера БД
   * непосредственно перед командой останова брокера базы (proshut)
@@ Строка 21: / Строка 21: @@
 <code bash>
-    BQRunAtEnabled=yes   # включение функционала BQRunAt
+  BQRunAtEnabled=yes   # включение функционала BQRunAt
 </code>
@@ Строка 41: / Строка 41: @@
 <code bash>
-  BQRunAtUUser={<unix-user>|.}           # unix-user для выполнения всех команд BQRunAt
+  BQRunAtUUser={<unix-user>|.}        # unix-user для выполнения всех команд BQRunAt
        bis - значение по умолчанию
        .   - текущий пользователь (под которым выполняется bq.sh в данный момент)
-  BQRunAt{Start|Stop}<NN>UUser={<unix-user>|.}
+  BQRunAtStart<NN>UUser={<unix-user>|.}
-     # unix-user для выполнения конкретной команды BQRunAt{Start|Stop}<NN>
+     # unix-user для выполнения конкретной команды BQRunAtStart<NN>
+  BQRunAtStop<NN>UUser={<unix-user>|.}
+     # unix-user для выполнения конкретной команды BQRunAtStop<NN>
 </code>
@@ Строка 54: / Строка 57: @@
 <code bash>
- BQRunAt{Start|Stop}<NN>Verbosе={0|1|2|3}        # уровень сообщений
+ BQRunAtStart<NN>Verbosе={0|1|2|3}       # уровень сообщений при старте
+ BQRunAtStop<NN>Verbosе={0|1|2|3}        # уровень сообщений при останове
 – сообщение отсутствует
 – выводится UUser и имя соответствующей переменной (BQRunAt...)
@@ Строка 64: / Строка 68: @@
 ===== Использование =====
+==== Управление запуском ====
 Для включения функционала необходимо установить переменную окружения ''BQRunAtEnabled=yes''. Любое другое значение ''BQRunAtEnabled'', в т.ч. пустое или неопределенное, отключает функционал полностью.
 Команды, которые необходимо привязать к событию старта брокера БД, задаются переменными вида ''BQRunAtStart''//NN//, где //NN// – числовое значение, определяющее порядок выполнения  заданной команды. Аналогично, переменные ''BQRunAtStop''//NN// задают команды, привязанные к событию останова брокера БД.
 Если //NN// начинается на ''0'' (цифру ноль), то соответствующая команда выполняется при остановленном брокере БД.
@@ Строка 135: / Строка 142: @@
 ==== Управление полномочиями ====
-Все команды выполняются с полномочиями, определяемыми переменной BQRunAtUUser, в которой указывается имя unix-пользователя.
+Функционалом предусмотрена возможность выполнения команд BQRunAt
+под полномочиями заданного пользователя unix с помощью системной
+команды ''su'' или аналога (определяется в bq.sh). По умолчанию все команды
+BQRunAt будут запускаться из-под unix-пользователя **bis**.
+В случае необходимости изменить пользователя можно установкой переменной:
+<code bash>
+  BQRunAtUUser={<unix-user>|.}        # unix-user для выполнения всех команд BQRunAt
+</code>
+Специальное значение ''BQRunAtUUser=.'' (точка) отключает использование ''su''. В этом случае
+все команды BQRunAt будут запускаться с полномочиями текущего пользователя
+(под которым выполняется bq.sh в данный момент). Будьте осторожны при использовании данного режима:
+возможны конфликты с правами доступа и потенциальные уязвимости.
+Установкой перечисленных ниже переменных можно задать unix-пользователя для каждой
+конкретной команды ''BQRunAtStart''//NN// или ''BQRunAtStop''//NN//:
+<code bash>
+  BQRunAtStart<NN>UUser={<unix-user>|.}
+  BQRunAtStop<NN>UUser={<unix-user>|.}
+</code>
+Под заданным пользователем будет выполнятся только указанная команда. Для остальных
+по прежнему будет использоваться значение по умолчанию из переменной ''BQRunAtUUser''.
+Здесь также специальное значение "''.''" (точка) приводит к выполнению команд
+ под текущим пользователем.
 ==== Управление сообщениями ====
+Перед запуском каждой из заданных команд BQRunAt скрипт bq.sh выводит
+в stdout (на терминал) информационное сообщение.
+Установкой описанных ниже переменных можно управлять степенью подробности
+этих сообщений. Уровень подробности задается отдельно для каждой из команд BQRunAt.
+<code bash>
+ BQRunAtStart<NN>Verbosе={0|1|2|3}       # уровень сообщений при старте
+ BQRunAtStop<NN>Verbosе={0|1|2|3}        # уровень сообщений при останове
+</code>
+Предусмотрены следующие значения:
+  *  ''0'' – сообщение отсутствует
+  *  ''1'' – выводится UUser и имя соответствующей переменной (''BQRunAt''...)
+  *  ''2'' – UUser, имя переменной и первое слово заданной команды
+  *  ''3'' – UUser, имя переменной и вся команда целиком (с аргументами)
+По умолчанию принимается значение: ''2''
+===== История версий =====
+v.4.6.2  //в процессе реализации// \\
+[+] Добавлено управление полномочиями (переменные BQRunAtUUser, BQRunAtStart//NN//UUser, BQRunAtStop//NN//UUser)
+v.4.6.1  30.08.2011 cksum: 1480063694 \\
+[*] Функция BQRunAtStop: изменен порядок вызова, теперь: 5,4,3,2,1
+v.4.6.0  15.12.2010 cksum: 1976088185  \\
+[+] Добавлен функционал: BQRunAtStart, BQRunAtStop

Вы посетили:

Различия

Поиск

Инструменты