Alterator/module/debug: различия между версиями
(не показаны 4 промежуточные версии 1 участника) | |||
Строка 1: | Строка 1: | ||
<onlyinclude> | |||
=== Отладка модулей === | === Отладка модулей === | ||
Строка 7: | Строка 6: | ||
Все компоненты alterator используют особые переменные среды для определения местоположения основных рабочих каталогов: | Все компоненты alterator используют особые переменные среды для определения местоположения основных рабочих каталогов: | ||
{| class="standard" | {| class="standard" | ||
! | !Переменная | ||
! | !Значение по умолчанию | ||
! | !Описание | ||
|- | |- | ||
|<tt>ALTERATOR_LIBDIR</tt> | |||
|<tt>/usr/lib/alterator</tt> | |||
|ALTERATOR_LIBDIR | |бэкенды и иные архитектурно-зависимые компоненты. | ||
|/usr/lib/alterator | |||
| | |||
|- | |- | ||
|<tt>ALTERATOR_DATADIR</tt> | |||
|ALTERATOR_DATADIR | |<tt>/usr/share/alterator</tt> | ||
|/usr/share/alterator | |||
|описания интерфейсов и иные архитектурно-независимые компоненты. | |описания интерфейсов и иные архитектурно-независимые компоненты. | ||
|- | |- | ||
|<tt>ALTERATOR_DEBUG</tt> | |||
|ALTERATOR_DEBUG | |||
| | | | ||
|сигнализирует что система находится в режиме отладки | |сигнализирует что система находится в режиме отладки | ||
|} | |} | ||
Строка 35: | Строка 29: | ||
Таким образом, находясь в модуле, можно отлаживать и запускать его не устанавливая в систему. | Таким образом, находясь в модуле, можно отлаживать и запускать его не устанавливая в систему. | ||
{| class="standard" | {| class="standard" | ||
! | !Интерфейс | ||
! | !Команда запуска | ||
|- | |- | ||
|Командная строка | |||
| | |<tt>alterator-cmdline -l <запрос></tt> | ||
|alterator-cmdline -l | |||
|- | |- | ||
|Графический интерфейс | |||
| | |<tt>/usr/sbin/alterator-standalone -l <имя desktop-файла описания></tt> | ||
|/usr/sbin/alterator-standalone -l | |||
|- | |- | ||
|Web-интерфейс | |Web-интерфейс | ||
|/usr/sbin/configd -l | |<tt>/usr/sbin/configd -l</tt> | ||
|- | |- | ||
|} | |} | ||
В последнем варианте сервер configd не будет отцепляться от терминала и будет работать с локальными бэкендами и файлами шаблонов. Для старой системы шаблонов (template-*), дополнительно существует переменная '''ALTERATOR_HTMLDIR''', которая модифицируется при использовании '-l' аналогично остальным переменным. | |||
alterator-standalone '''следует запускать''' с указанием /usr/sbin, поскольку утилита consolehelper (/usr/bin/alterator-standalone ссылается на неё) изменяет состав переменных окружения. | alterator-standalone '''следует запускать''' с указанием /usr/sbin, поскольку утилита consolehelper (/usr/bin/alterator-standalone ссылается на неё) изменяет состав переменных окружения. | ||
==== Интерфейс командной строки ==== | ==== Интерфейс командной строки ==== | ||
Утилита alterator-cmdline служит для выполнения запросов к | Утилита alterator-cmdline служит для выполнения запросов к бэкендам из интерфейса командой строки и может с успехом использоваться для написания скриптов. Параметр -l позволяет работать с локальными бэкендами, а параметр -k указывает выводить значения конкретного параметра. | ||
Пример: | Пример: | ||
Строка 80: | Строка 70: | ||
# alterator-cmdline /net-eth action list -k name | # alterator-cmdline /net-eth action list -k name | ||
eth0 | eth0 | ||
eth1</pre> | eth1 | ||
# alterator-cmdline /openldap/config action read | |||
daemon:#t | |||
daemon_state:slapd is running | |||
local:#t | |||
enable_tls:#t | |||
key_state:Certificate expire: 29.03.2012 20:45 | |||
# alterator-cmdline /openldap action save local '#t' | |||
# alterator-cmdline /openldap/config action read | |||
daemon:#t | |||
daemon_state:slapd is running | |||
local:#t | |||
key_state:Certificate expire: 29.03.2012 20:45 | |||
# alterator-cmdline /openldap action save local_and_tls '#t' | |||
# alterator-cmdline /openldap/config action read | |||
daemon:#t | |||
daemon_state:slapd is running | |||
local:#t | |||
enable_tls:#t | |||
key_state:Certificate expire: 29.03.2012 20:45 | |||
</pre> | |||
</onlyinclude> | |||
{{Alterator modules-nav}} |
Текущая версия от 13:13, 30 марта 2011
Отладка модулей
Работа с модулем без установки в систему
Все компоненты alterator используют особые переменные среды для определения местоположения основных рабочих каталогов:
Переменная | Значение по умолчанию | Описание |
---|---|---|
ALTERATOR_LIBDIR | /usr/lib/alterator | бэкенды и иные архитектурно-зависимые компоненты. |
ALTERATOR_DATADIR | /usr/share/alterator | описания интерфейсов и иные архитектурно-независимые компоненты. |
ALTERATOR_DEBUG | сигнализирует что система находится в режиме отладки |
Для обоих переменных допустимо перечисление нескольких каталогов через двоеточие - в этом случае поиск производится последовательно в порядке указания имён. Например, если ALTERATOR_DATADIR="/a:/b", то файл ui.scm будет искаться сначала по адресу /a/ui.scm, а потом /b/ui.scm.
Для удобства использования у утилит командной строки alterator существует ключ '-l', который добавляет текущий каталог в начало списка в переменные ALTERATOR_LIBDIR и ALTERATOR_DATADIR.
Таким образом, находясь в модуле, можно отлаживать и запускать его не устанавливая в систему.
Интерфейс | Команда запуска |
---|---|
Командная строка | alterator-cmdline -l <запрос> |
Графический интерфейс | /usr/sbin/alterator-standalone -l <имя desktop-файла описания> |
Web-интерфейс | /usr/sbin/configd -l |
В последнем варианте сервер configd не будет отцепляться от терминала и будет работать с локальными бэкендами и файлами шаблонов. Для старой системы шаблонов (template-*), дополнительно существует переменная ALTERATOR_HTMLDIR, которая модифицируется при использовании '-l' аналогично остальным переменным.
alterator-standalone следует запускать с указанием /usr/sbin, поскольку утилита consolehelper (/usr/bin/alterator-standalone ссылается на неё) изменяет состав переменных окружения.
Интерфейс командной строки
Утилита alterator-cmdline служит для выполнения запросов к бэкендам из интерфейса командой строки и может с успехом использоваться для написания скриптов. Параметр -l позволяет работать с локальными бэкендами, а параметр -k указывает выводить значения конкретного параметра.
Пример:
# alterator-cmdline /users/stas action read gecos:Stanislav I. Ievlev home:/home/stas shell:/bin/bash allow_su:#t # alterator-cmdline /users/stas action read -k home /home/stas #alterator-cmdline /net-eth action list name:eth0 label:eth0 name:eth1 label:eth1 # alterator-cmdline /net-eth action list -k name eth0 eth1 # alterator-cmdline /openldap/config action read daemon:#t daemon_state:slapd is running local:#t enable_tls:#t key_state:Certificate expire: 29.03.2012 20:45 # alterator-cmdline /openldap action save local '#t' # alterator-cmdline /openldap/config action read daemon:#t daemon_state:slapd is running local:#t key_state:Certificate expire: 29.03.2012 20:45 # alterator-cmdline /openldap action save local_and_tls '#t' # alterator-cmdline /openldap/config action read daemon:#t daemon_state:slapd is running local:#t enable_tls:#t key_state:Certificate expire: 29.03.2012 20:45