= Руководство администратора = == Приложение !MonitorServer == На платформе Microsoft® Windows® ПО устанавливается как системная служба, а на UNIX и клонах - как демон. Исполняемый файл может быть запущен из командной строки. Синтаксис: {{{ C:\Program Files\MonitorServer>monitorserver.exe --help Usage: monitorserver.exe [options] Options: -h, --help Показать эту справку и завершиться. -w HTTP_PORT, --http-port=HTTP_PORT HTTP порт сервера. -m MODEM_PORT, --modem-port=MODEM_PORT Порт для обслуживания модемов. -g KEY, --google-key=KEY Установить ключ Google Maps API и завершиться. -a LICENSEE, --activate=LICENSEE Сформировать запрос для активации ПО и завершиться. -v, --verify Покать информацию о лицензированных возможностях. -i, --install Установить системную службу MonitoServer и завершиться. -r, --remove Удалить системную службу MonitorServer и завершиться. -s, --start Запустить системную службу сервера. -p, --stop Остановить системную службу сервара. }}} Опции i, r, s, p доступны только на платформе Microsoft® Windows®. == Хранение данных == Система мониторинга !MonitorServer может использовать как встроенную в !MonitorServer систему управления базами данных (СУБД), так и внешнюю. Встроенная СУБД оптимальна для малых задач, при этом не требуется дополнительный действий по настройке и администрированию. Если же количество подключенных трекеров вырастает за несколько сотен, количество операторов так же растет, то целесообразно использовать !MonitorServer с внешней СУБД. В этом случае решение получает выигрыш как за счет более высокой производительности выделенной СУБД в многопользовательской среде, так и от возможного разделения аппаратного обеспечения сервера мониторинга и сервера баз данных. При этом, !MonitorServer позволяет начать разворачивать решение на встроенной СУБД, а при необходимости нарастить производительность - мигрировать на внешнюю СУБД без потери данных. Выбор СУБД производится в конфигурационном файле monitorserver.ini. По умолчанию (.ini файл отсутствует) !MonitorServer использует встроенную СУБД. Для использования внешней СУБД необходимо добавить в monitorserver.ini следующее: {{{ [common] use_external_database = yes }}} Так же потребуется добавить параметры подключения к внешней СУБД в секции [external_database]. === Встроенная база данных === В !MonitorServer встроена компактная СУБД [http://www.sqlite.org/ SQLite] - самодостаточная, безсерверная, не требующая конфигурирования, транзакционная СУБД. Данные под управлением этой СУБД хранятся в том же каталоге, куда и был установлен MonitorServer, в виде файлов с расширением *.db. Для создания резервной копии накопленной информации достаточно скопировать файл monitorserver.db. Выполнять это следует при остановленной службе/демоне !MonitorServer. === Внешняя база данных === В данный момент из внешних систем управления базами данных поддерживается [http://ru.wikipedia.org/wiki/PostgreSQL PostgreSQL]. Это СУБД с открытым исходным кодом (Open source), распространяемая в базовом виде бесплатно (Free). Коммерческие услуги по сопровождению предоставляют несколько организаций (http://www.enterprisedb.com и другие). PostgreSQL родилась как некоммерческая СУБД в Калифорнийском университете (Беркли) и насчитывает историю более 25 лет. Основными ее отличительными особенностями считаются версионность записей, механизм наследования классов (таблиц), гибкие расширяемые типы данных, широкий выбор языков хранимых процедур. СУБД поставляется практически во всех дистрибутивах Linux, а так же доступна для скачивания в виде [http://www.enterprisedb.com/products-services-training/pgdownload инсталлятора для win32 платформ]. СУБД имеет удобный инструмент управления pgAdmin III. Для использования PostgreSQL в качестве внешней СУБД, необходимо внести в monitorserver.ini файл следующие параметры: {{{ [external_database] dbms = postgresql host = host.with.postgresql.server database = some_database username = monitorserver_postgresql_username password = some_password }}} == Активация продукта после приобретения == После приобретения лицензии необходимо активировать продукт в соответствии с приобретенными правами. В ходе активации так же произойдет привязка продукта к серверу, на который он установлен. Это делается за 2 шага. ==== 1. Запрос на активацию ==== Необходимо сформировать запрос на активацию. Для этого нужно запустить monitorserver из командной строки с ключем -a и последующим именем приобретателя лицензии. Результат перенаправить в файл. Пример: {{{ C:\Program Files\MonitorServer>monitorserver.exe -a "TransAvtoLogistics, Ltd." > request.txt }}} В ответ через несколько секунд будет сформирован запрос на активацию в файле request.txt. Этот файл нужно будет отослать на адрес partner@monitorserver.ru ==== 2. Установка ключа ==== В ответ на отправленный запрос будет выслан файл license.key с ключом активации. Этот файл нужно будет сохранить в тот же каталог, в который был установлен !MonitorServer. После этого !MonitorServer нужно перезапустить. Для проверки активации можно использовать опцию -v. Пример: {{{ C:\Program Files\MonitorServer>monitorserver.exe -v MonitorServer v0.10.4.7 Copyright (c) 2008-2009 http://www.monitorserver.ru/ License information: License owner: TransAvtoLogistics, Ltd. Licensed users: 40 Expires: no }}} == Консоль администрирования == Администрирование пользователей происходит на отдельной странице администрирования (консоль администратора). Эта страница доступна после обычного входа в систему по адресу: http://АДРЕС_СЕРВЕРА:НОМЕР_ПОРТА/html/admin.html Консоль администратора разбита на 4 области (панели). Их можно изменять в размерах или минимизировать. * Панель "Сообщения операторов" содержит историю действий операторов. * Панель "Сообщения модемов" содержит низкоуровневую информацию, приходящую или отправляемую модемам. Используется для разрешения проблем. * Панель "Операторы" служит для создания, удаления и редактирования операторов. * Панель "Транспортные средства" служит для управления карточками транспортных средств, зарегистрированных в системе (создание, удаление, изменение, в том числе норм расхода топлива и привязки транспортных средств к операторам). == Конфигурирование пользователей == Пользователь в системе имеет учетное имя, роль и пароль. Так же можно указать его электронный адрес и телефон. По ролям пользователи делятся на 2 группы: * Операторы * Администраторы Администраторы обладают всеми возможными полномочиями в системе. Операторы же могут только мониторить назначенные им объекты. == Конфигурирование транспортных средств == Транспортное средство может быть зарегистрировано в системе либо вручную, либо автоматически. Автоматическая регистрация происходит при получении первой посылки от нового модема. Администратору остается только заполнить имя/позывной этого ТС (определяется по номеру модема). После каждого сохранения карточки транспортного средства происходит так же и обновление конфигурации модема (параметр "Период отсылки"). Если модем был на связи, то переконфигурирование происходит сразу. Если же связи с модемом не было, то переконфигурирование произойдет только при выходе модема на связь. Переконифгурирование произойдет вне зависимости от того, перезагружался ли после этого MonitorServer или нет. == Привязка транспортных средств к операторам == Если роль некоего пользователя в системе указана как "Оператор", то ему для мониторинга доступны только назначенные транспортные средства. Одно и то же транспортное средство может быть назначено для мониторинга нескольким операторам. Администраторы могут мониторить все транспортные средства, зарегистрированные в системе. '''Для просмотра назначений''' нужно сделать следующее: 1. Выбрать интересующего оператора в панели "Операторы". 2. В панели "Транспортные средства" нажать кнопку "Пометить". В результате будут помечены транспортные средства, назначенные данному оператору. '''Для назначения''' определенных транспортных средств оператору необходимо: 1. Выбрать интересующего оператора в панели "Операторы". 2. В панели "Транспортные средства" пометить только те объекты, которые нужно назначить для мониторинга выбранному на шаге 1 оператору. 3. В панели "Транспортные средства" нажать кнопку "Назначить". В результате оператору будет назначен новый список объектов. '''Для изменения''' списка назначенных объектов для оператора необходимо сначала проделать действия для просмотра этого списка, затем действия для назначения.