Содержание
Пользовательский интерфейс администрирования реализуется fast-cgi программой fcgiadm, которая взаимодействует с веб-сервером с одной стороны и командным интерфейсом сервера Manjary с другой. В простом случае, fcgiadm может вызываться модулем HTTP и управлять тем же сервером Manjary.
В процессе работы генерируются ссылки на различные локальные файлы которые будут запрашиваться браузером. По-умолчанию fcgiadm отвечает на запросы начинающиеся с /admin/ , по этому же пути из URL должны быть доступны файлы интерфейса администрирования.
При установке файлы интерфейса администрирования находятся в
./htdoc/admin
, в примере
конфигурации ./examples/manjary-http.xml
есть
готовые настройки для доступа по адресу
http://localhost:81/admin/
.
fcgiadm
{-b { [ IP
address
| hostname
| *
| all
| any
] {:port
} | socket
}} [-l logfile
] [-L {[screen= yes
| no
] | [,level=N
] | [,history=N
] | [,size=N
]}] [-s {caption
=
host:port
,...} | @filename ] [-r path
]
Адрес локального сетевого интерфейса (опционально) и порт
TCP (отделённый от имени двоеточием) на котором будут
прослушиваться запросы WEB-сервера. Интерфейс может задаваться
адресом IP или именем. Чтобы использовались любые локальные
адреса, вместо адреса можно указать одно из значений:
*
, all
,
any
. Так же может быть указано имя локального
сокета без двоеточия и номера порта. Допускается указание
множества опций -b
.
Полное имя лог-файла. По-умолчанию лог-файл не создаётся.
Опции журналирования:
Указывает, нужно ли выводить записи на экран, может
принимать значения: yes
,
on
, true
,
1
- выводить на экран или
no
, off
,
false
, 0
- не
выводить. По-умолчанию: yes
.
Уровень детализации лог-файла. От 1 (наименьший) до
5 (самый подробный). По-умолчанию:
5
.
Количество лог-файлов в ротации. Когда нужно начать
новый файл, текущий переименовывается в
file
-000, перед этим старый file
-000
переименовывается в file
-001 и т.д., самый
старый файл удаляется. По-умолчанию:
4
.
Ротация может производиться в любой момент времени,
для этого необходимо послать сигнал SIGALRM
процессу fcgiadm
.
Максимальный размер
лог-файла. Когда достигается это значение выполняется
ротация лог-файлов. Если size
установлено в 0,
ротация будет происходить каждый раз при переходе на новые
сутки. По-умолчанию: 512Kb
.
Список серверов Manjary из
которого пользователь при авторизации сможет выбирать сервер к
которому следует подключиться. Если fcgiadm вызывается из модуля
HTTP сервера Manjary с загруженным
модулем Mail, то в этом списке всегда присутствует пункт
Local
для подключения к тому же серверу.
Также, у пользователя всегда есть возможность ввести имя сервера
и порт вручную. Строковый аргумент -s
может
быть указан в виде списка значений разделённых запятыми в
формате: отображаемое_название=имя:номер_порта_CLI. Если аргумент
начинается с "@", то остальная строка рассматривается как имя
файла из которого нужно прочитать список. Файл должен содержать
записи в отдельных строках: отображаемое_название=имя:номер_порта_CLI.
Если список серверов находится в файле, его можно будет
изменять во время работы и сообщать об изменениях посылая сигнал
SIGHUP
процессу
fcgiadm
.
URI путь к ресурсу администрирования. fcgiadm будет отвечать на запросы к этому пути и там же должны находиться файлы необходимые для интерфейса администрирования. По-умолчанию: /admin/, т.е. интерфейс администратора будет иметь адрес вида http[s]://хост:порт/admin/
Здесь fcgiadm будет прослушивать локальный сокет \socket\fcgiadm для обращений из модуля HTTP Manjary на том же сервере:
>fcgiadm -b \socket\fcgiadm -l fcgiadm.log -Llevel=4,size=1Mb
Для работы с fcgiadm в конфигурации модуля HTTP необходимо указать как к нему обращаться и (опционально) что запускать:
<fastcgi name="fcgi-admin"> <server>\socket\fcgiadm</server> <start>./fcgiadm -b \socket\fcgiadm -l fcgiadm.log -Llevel=4,size=1Mb</start> </fastcgi>
Далее, в конфигурации виртуального хоста для директории admin
указать обращение к
соответствующему приложению FastCGI при запросе файлов соответствующих
маске "*.". В этой директории должны находиться файлы интерфейса
администрирования.
<directory path="*/admin"> <index type="auto">index</index> <file must-exist="0"> <match>*.</match> <handler>$fcgi-admin</handler> </file> </directory>
Таким образом, пользователь запрашивая из браузера ресурс http://хост:порт/admin/ получит доступ к интерфейсу администрирования.