Skip to content

README.md

Latest commit

 

History

History
executable file
·
137 lines (113 loc) · 9.14 KB

README.md

File metadata and controls

executable file
·
137 lines (113 loc) · 9.14 KB
Raw

glonassd

Сервер для GPS/GLONASS трекеров, работающий в операционной системе Debian.

Краткое описание

glonassd это линукс-демон, принимающий данные от GPS / GLONASS трекеров и сохраняющий их в базу данных.
Демон написан на языке C, собран компилятором gcc 6.3.0 для x86_64-linux-gnu (64-битная версия).

Протоколы

Принимаемые: Arnavi-4/5, Galileo (все версии), GPS101-GPS103, SAT-LITE / SAT-LITE2, Wialon IPS, Wialon NIS (SOAP / Олимпстрой), ЕГТС (ЭРА-ГЛОНАСС), TQ GPRS (H02).
Передаваемые (пересылка): все принимаемые без перекодирования или перекодирование в протоколы EGTS, Wialon NIS, WialonIPS, Galileo.
Протоколы реализованы и могут быть добавлены подключением библиотек без перекомпиляции демона.

База данных

PostgreSQL
Redis
Oracle
БД могут быть добавлены подключением библиотек без перекомпиляции демона.

Возможности

  • Пересылка данных трекеров на сторонние сервера с перекодированием или без него.
  • Хранение данных на время обрыва связи со сторонними серверами, отправка после восстановления связи.
  • Автоматическое восстановление связи со сторонними серверами в случае её потери.
  • Максимальное количество ретрансляций: до 3 серверов для каждого терминала.
  • Выполнение задач (скриптов) по расписанию (таймеру), максимально 5 таймеров.
  • Простая настройка двумя .conf файлами. (Примеры: glonassd.conf, forward.conf)
  • Возможность добавления протоколов терминалов или баз данных подключаемыми библиотеками без перекомпиляции демона.
  • Запуск в режиме демона или простого приложения

Установка

Подготовка

apt install build-essential libpq-dev

Git версия

Предполагается установка в папку /opt/glonassd

cd /opt
git clone https://github.com/fandrej/glonassd.git
cd glonassd
make min

Компиляция

make all компиляция демона + библиотек БД (Postgresql + Redis + Oracle) + библиотек терминалов
make min компиляция демона + библиотеки БД Postgresql + библиотек терминалов
make glonassd компиляция только демона без библиотек
make pg компиляция библиотеки базы данных (PostgreSQL)
make name компиляция библиотеки протокола терминала name

Дополнительная информация о сторонних библиотеках

Настройка

Создать папки forward & logs: mkdir -p forward logs.
В файле glonassd.conf в секции server изменить значения параметров:
listen - IP адрес входящих подключений
transmit - IP адрес с которого производится ретрансляция
log_file - полный путь к лог-файлу
db_host, db_port, db_name, db_schema, db_user, db_pass - параметры подключения к БД PostgreSQL
Закомментировать или раскомментировать секции протоколов терминалов в зависимости от используемых и указать порты для подключения терминалов.

Для включения ретрансляции терминалов изучить комментарии в секции forward в файле glonassd.conf.
Для включения задач по расписанию изучить комментарии к параметру timer в секции server в файле glonassd.conf.

Проверьте ограничения размера очереди сообщений POSIX

Проверьте ограничение длины очереди сообщений POSIX с помощью ulimit -q или ulimit -a и посмотрите значение "POSIX message queue". По умолчанию оно равно 819200 байтам. Увеличьте это значение как минимум до 81920000. Для этого добавьте в файл /etc/security/limits.conf следующие строки:

root    soft    msgqueue        81920000
root    hard    msgqueue        81920000
*       soft    msgqueue        81920000
*       hard    msgqueue        81920000

и перезагрузите систему. Если в процессе работы в лог-файле появится сообщение "mq_send(config->db_queue) message queue is already full", то размер очереди надо увеличить ещё.

Запуск

Командой sudo ./glonassd start из папки с демоном, в консольном режиме, CTRL+C остановки.
Параметр -d используется для запуска в режиме демона.
Параметр -c path/to/config/file используется для указания файла настроек, находящегося в другой папке.
Если демон уже настроен для автоматического старта, команды service glonassd start и service glonassd stop запускают и останавливают сервис.

Автозапуск при старте системы

Как демон

Отредактировать значение переменной DAEMON в файле glonassd.sh, указав полный путь к файлу glonassd.
Cкопировать файл glonassd.sh в папку /etc/init.d.
Сделать этот файл исполняемым командой chmod 0755 /etc/init.d/glonassd.sh.
Командами systemctl daemon-reload и update-rc.d glonassd.sh defaults разрешить автоматический запуск демона.
Командой update-rc.d -f glonassd.sh remove запретить автоматический запуск демона без удаления файла glonassd.sh.
Удалить файл /etc/init.d/glonassd.sh и командой systemctl daemon-reload очистить информацию о демоне в системе.

Через supervisor

sudo apt install supervisor
sudo ln -s $(pwd)/glonassd.supervisor.conf /etc/supervisor/conf.d/glonassd.supervisor.conf
sudo supervisorctl reread
sudo supervisorctl update glonassd
sudo supervisorctl status

Лицензия

glonassd это открытое ПО под лицензией MIT.

Документация и API

Документация в процессе написания.

Автор

Федоров Андрей, Курган, Россия.
mailto:mail@locman.org

Эпилог

Демон glonassd это часть навигационного сервиса locman.org.

Исправления

12.06.2020

  • Исправлено получение больших данных (с других серверов)
  • Исправлен протокол EGTS
  • Улучшено использование процессора
  • Добавлена база данных Redis

01.05.2021

  • Добавлен протокол TQ GPRS (H02) - SinoTrack ST-901
  • Добавлен протокол ретранслятора WialonIPS
  • Добавлен протокол ретранслятора Galileo
  • Небольшие исправления

13.11.2021

  • Добавлена библиотека для работы с базой данных Oracle
  • Добавлены логи в библиотеках баз данных

04.04.2022

  • Добавлена обработка сообщений CT_MSGTO, CT_MSGFROM EGTS_COMMANDS_SERVICE протокола ЕГТС

17.04.2022

  • Добавлен протокол GoSafe (устройства Gosafe G*/Proma Sat G*)