Программное обеспечение «АвтоГРАФ-Сервер» v.3.0
(версия для Microsoft Windows)

НАЗНАЧЕНИЕ

ПО «АвтоГРАФ-Сервер» производства ООО «ТехноКом» является частью системы спутникового мониторинга «АвтоГРАФ» и предназначено для осуществления приёма данных от бортовых контроллеров «АвтоГРАФ-GSM», «АвтоГРАФ-ГЛОНАСС-GSM» и «АвтоГРАФ-WiFi», сохранения данных и их передачи в диспетчерскую часть системы – программу «АвтоГРАФ».
ПО «АвтоГРАФ-Сервер» представляет из себя службу MS Windows и не имеет графического интерфейса.
Все настройки и управление ПО «АвтоГРАФ-Сервер» производятся через ini-файл и операции создания / копирования / удаления соответствующих файлов.

ЧТО НОВОГО (What’s New)
Версия 3.0
·	Поддержка приборов с версией прошивки 7.0 и выше.
·	Добавлена возможность настройки приборов через сервер.
·	Добавлена вставка данных в SQL базу.
·	Добавлена пересылка данных на другой сервер в формате АвтоГРАФ'а.
·	Добавлено сохранение последнего положения в KML файл.
·	Добавлена поддержка лицензии с ограничением по времени.

Версия 2.3
·	Добавлена возможность подмены серийного номера при приеме данных.
·	Добавлена возможность подмены паролей при запросе со стороны диспетчера.
·	Добавлена механизм запроса последнего местоположения ТС.

Версия 2.2
·	Добавлена возможность создания сервера с фиксированным списком приборов.
·	Добавлена возможность создания сервера с ограничением на количество приборов.

Версия 2.1
·	Добавлена поддержка приборов «АвтоГРАФ-WiFi»
·	Добавлена поддержка приема данных от программы «WiFiReader»
·	Добавлено лицензирование ПО «АвтоГРАФ-Сервер» с помощью Лицензионных Ключевых Файлов
·	Добавлена привязка ПО «АвтоГРАФ-Сервер» к IP-адресу Сервера Пользователя.
·	Существенно переработан текст Лицензионного Соглашения с конечным Пользователем
·	Устранена утечка памяти при множественных запросах

Версия 2.0
·	Существенно переработано и оптимизировано ядро программы. 
·	Все настройки сервера перенесены из системного реестра в ini-файл.
·	Добавлена возможность отключения передачи данных с конкретных приборов в диспетчерское ПО, при этом прием и накопление данных от приборов на сервере – не останавливается. Это позволяет отключать абонентов от обслуживания, но продолжать получать и хранить данные с их приборов на сервере, а также осуществлять автоматический биллинг.

РЕКОМЕНДОВАННЫЕ ТРЕБОВАНИЯ К АППАРАТНОЙ ЧАСТИ СЕРВЕРА «АВТОГРАФ» 

Процессор:	Intel Xeon / Core2Duo / Core2Quad с рабочей частотой 2 ГГц и выше
Память: 	1…4 Гб ECC
Жесткий диск:	250…750 Гб и более
Рекомендуется применение высоконадежных жестких дисков, предназначенных для работы в серверах и RAID-массивах. Например:
·	Seagate Barracuda ES/ES.2
·	WD Raptor
·	WD Caviar RE/RE2
·	Hitachi UltraStar и т.п.
Для увеличения надежности хранения информации рекомендуется применение RAID-массива типа RAID 1 (Mirroring - "зеркало")
Интернет-канал:	Симметричный выделенный Интернет-канал (не ADSL)
IP-адрес:	Статический «реальный» IP-адрес (обязательное условие)
Питание:	ИБП 1000…3000 VA (типа APC-Smart, Ippon Winner) или лучше 
Брэндмауэр:	Обязателен 
(необходимо закрыть все порты, кроме необходимых для работы и обслуживания ПО «АвтоГРАФ-Сервер»)
Антивирус:	Настоятельно рекомендуется.
Разное:		Для нормального функционирования, сервер должен являться именно серверным ПК:
с серверным корпусом, системой охлаждения, блоком питания, материнской платой, памятью, HDD и т.п.
Примеры современных серверных конфигураций Вы можете увидеть в каталоге известного компьютерного супермаркета НИКС по следующей ссылке: http://www.nix.ru/autocatalog/cc/nix_pc_servers.html
Помните: основное требование – это надежность функционирования – 24 часа в сутки, 365 дней в году. 
Нередко, стоимость информации, размещенной на сервере, для Вас или Ваших клиентов значительно выше стоимости аппаратной части сервера.
Использование сервера «АвтоГРАФ» совмещенно с другими функциями – не рекомендуется.
Нередко удобно размещать свой сервер на Интернет-площадках и в Data-центрах надежных Интернет-провайдеров или хостинговых компаний – услуга Collocation. Как правило эти площадки имеют контроль климата, резервирование питания и Интернет-канала, а также системы безопасности и ограничения доступа к серверам посторонних лиц. 
В ряде случаев можно использовать аренду выделенных серверов надежных Интернет-провайдеров или хостинговых компаний – услуга Dedicated Server.

УСТАНОВКА И НАСТРОЙКА ПО «АвтоГРАФ-Сервер»

1. Установите ПО «АвтоГРАФ-Сервер» в требуемую папку (например: C:\AG_Server\)
2. Для установки службы «АвтоГРАФ-Сервер», войдите в папку с установленным ПО «АвтоГРАФ-Сервер» и:
·	запустите из командной строки файл AutoGRAPHServer.exe с ключом /install (AutoGRAPHServer.exe /install)
или
·	запустите файл Install.bat
3. Настройте параметры сервера. Для этого воспользуйтесь приложением «AutoGRAPHConsol.exe» или откройте файл AutographServer.ini с помощью любого текстового редактора (например, с помощью Блокнота) и установить требуемые значения параметров:

DataFolder	– Путь к папке, в которую будут сохраняться файлы данных, полученных от контроллеров серии 
   «АвтоГРАФ» (по-умолчанию подпапка Data папки с установленным ПО «АвтоГРАФ-Сервер»)
DevicesPort	– Номер порта приема данных от контроллеров «АвтоГРАФ-GSM» (по-умолчанию 2225)
DispatcherPort	– Номер порта для работы с диспетчерской программой «АвтоГРАФ» (по-умолчанию 2226)
WiFiPort	– Номер порта приема данных от контроллеров «АвтоГРАФ-WiFi» (по-умолчанию 2224)
EnableWiFi	– Флаг функции работы с устройствами «АвтоГРАФ-WiFi»: 1 – включить, 0 – отключить (по-умолчанию 0)
EnableBilling	– Флаг включения функции биллинга: 1 – включить, 0 – отключить (по-умолчанию 0)
WriteLog	– Флаг записи информации о приеме данных: 1 – записывать, 0 – не записывать (по-умолчанию 0)
WriteDebug	– Флаг записи служебной отладочной информации: 1 – записывать, 0 – не записывать (по-умолчанию 0)

RedirectEnable	– Флаг разрешения пересылки данных на другой сервер: 1 – пересылать, 0 – не пересылать
RedirectAll	– Пересылать данные всех приборов: 1 – пересылать, 0 – не пересылать
RedirectServer	– IP адрес сервера на который пересылаются данные
RedirectPort	– Порт сервера на который пересылаются данные
RedirectPeriod	– Период пересылки данных в секундах
RedirectFormat	– Формат пересылки данных (0 – в формате АвтоГРАФа, остальные значения зарезервированы)

EnableSQL	– Флаг разрешения вставки информации о положении приборов в базу данных: 1 – разрешить, 0 – не
	разрешить (по-умолчанию 0)
ConnectionString	– Строка подключения к БД
TableName	– Имя таблицы в БД для вставки данных

Пример файла AutographServer.ini:

[COMMON]
DataFolder= C:\AG_Server\Data
DevicesPort=2225
DispatcherPort=2226
WiFiPort=2224
EnableBilling=0
EnableWiFi=0
WriteDebug=0
WriteLog=0
[REDIRECT]
RedirectEnable=1
RedirectAll=0
RedirectServer=192.168.0.19
RedirectPort=2225
RedirectPeriod=60
RedirectFormat=0
[SQL]
EnableSQL=0
ConnectionString=
TableName=

ВНИМАНИЕ !!!
·	При изменении параметра DevicesPort – необходимо ввести новый номер порта в контроллеры «АвтоГРАФ-GSM». Это можно сделать с помощью программы GSMConf или через SMS-команду.
·	При изменении параметра WiFiPort – необходимо ввести новый номер порта в контроллеры «АвтоГРАФ-WiFi». Это можно сделать с помощью программы WiFiConf.
·	При изменении параметра DispatcherPort – необходимо ввести новый номер порта в диспетчерское ПО «АвтоГРАФ».
·	При изменении параметров DataFolder, DevicesPort, DispatcherPort, WiFiPort, EnableWiFi, RedirectServer, RedirectPort, RedirectPeriod, EnableSQL, ConnectionString, TableName  – требуется перезапустить службу «АвтоГРАФ-Сервер». Для этого откройте «Пуск -> Панель управления -> Администрирование -> Службы», найдите в списке службу «АвтоГРАФ-Сервер», щелкните на ней правой кнопкой мыши и выберите «Перезапустить», или воспользуйтесь программой «AutoGRAPHConsol.exe».
·	Если у вас установлен брандмауэр (firewall), необходимо открыть используемые порты (см. инструкции на Вашу программу-брэндмауэр). В противном случае работа системы целиком будет невозможна.

4. После запуска, в папке с установленным ПО «АвтоГРАФ-Сервер» будет автоматически создана подпапка DBF для размещения ключевых файлов приборов серии «АвтоГРАФ»: [имя_файла]-srv.atg созданных с помощью программ-конфигураторов GSMConf или WiFiConf.

5. Разместите Лицензионный ключевой файл вида [имя_файла].agkey в папке с установленным ПО «АвтоГРАФ-Сервер». Подробнее о Лицензионном ключевом файле и порядке его получения, Вы можете узнать в Лицензионном Соглашении (AG_Server_License.rtf или AG_Server_License.txt).

РАБОТА С ПО «АвтоГРАФ-Сервер»

·	Для того, чтобы ПО «АвтоГРАФ-Сервер» могло работать с конкретным контроллером «АвтоГРАФ-GSM» или «АвтоГРАФ-WiFi», необходимо разместить ключевой файл прибора вида [имя_файла]-srv.atg (созданный с помощью программы-конфигуратора GSMConf или WiFiConf) в подпапке DBF, расположенной в папке с установленным ПО «АвтоГРАФ-Сервер».
При этом контроллер должен быть запрограммирован на соответствующий IP-адрес сервера и порт, указанный в переменной DispatcherPort – для контроллеров «АвтоГРАФ-GSM» или порт, указанный в переменной WiFiPort – для контроллеров «АвтоГРАФ-WiFi».
При обслуживании большого числа клиентов или подразделений, допускается, для удобства работы, размещать ключевые файлы приборов в подпапках папки DBF (например, имя подпапки может соответствовать имени клиента или подразделения).
·	При получении первого пакета от устройства серии «АвтоГРАФ», в папке, указанной в переменной DataFolder, создаётся папка xxxxx (где xxxxx – серийный номер контроллера). 
В этой папке будут размещаться файлы с данными (расширение bin), файлы журнала изменений настроек контроллера (расширение log) и файл с паролем прибора – password.txt.
·	Если Вы меняете пароль в контроллере, то должны найти соответствующий ему файл password.txt и удалить его вручную. После получения очередного пакета, служба создаст его заново, но он уже будет содержать новый пароль. Обновления базы данных по приборам при этом не требуется.
·	Файлы с данными и файлы журнала изменения настроек «дробятся» по неделям, начиная с 0:00:00 каждого понедельника по времени сервера.
Обращаем Ваше внимание на то, что 0:00:00 по времени сервера может не соответствовать 0:00:00 контроллера или рабочего места диспетчера, если они находятся в разных часовых поясах с сервером или установленный в настройках операционной системы часовой пояс на сервере отличается от часового пояса, соответствующего ему географически (например, используется время по Гринвичу для серверов с широким ареалом обслуживания).
·	Удаление файлов со старыми или ненужными данными производится вручную и возлагается на системного администратора сервера.
·	Для удаления контроллера с сервера обслуживания, необходимо удалить ключевой файл соответствующего контроллера из папки DBF и полностью удалить из папки, указанной в переменной DataFolder, папку с данными контроллера: xxxxx (где xxxxx – серийный номер контроллера).

БИЛЛИНГ И ОГРАНИЧЕНИЕ ДОСТУПА К ДАННЫМ ИЗ ДИСПЕТЧЕРСКОГО ПО

ПО «АвтоГРАФ-Сервер» поддерживает возможность отключения передачи данных с конкретных приборов в диспетчерское ПО. 
При этом прием и накопление данных от приборов на сервере – не останавливается. Это позволяет отключать абонентов от обслуживания, но продолжать получать и хранить данные с их приборов на сервере, а также осуществлять автоматический биллинг.

·	Для включения функции биллинга, необходимо установить в файле AutographServer.ini переменную EnableBilling в 1:
EnableBilling=1
·	После этого, необходимо создать в подпапке Dispatcher (созданной в папке с установленным ПО «АвтоГРАФ-Сервер») файлы, имена которых являются номерами контроллеров, для которых разрешен обмен данными с диспетчерским ПО «АвтоГРАФ».
·	Расширение файлов значения не имеет и может быть любым, либо вовсе отсутствовать.
·	Для отключения передачи данных в диспетчерское ПО – достаточно удалить из папки Dispatcher файлы с именами, равными номерам соответствующих приборов, для включения – создать или разместить эти файлы в папке Dispatcher заново.
·	Для отключения функции биллинга, необходимо установить в файле AutographServer.ini переменную EnableBilling в 0:
EnableBilling=0 
При этом данные всех контроллеров, обслуживаемых сервером, будут доступны для передачи в диспетчерское ПО.

подменА серийного номера при приеме данных

Подмена серийного номера применяется при необходимости временно подменить прибор прибором с другим серийным номером (например, при отправке прибора в ремонт). Для включения этой опции необходимо создать в каталоге с программой «АвтоГРАФ-Сервер» файл DevReplace.ini следующего содержания:
[REPLACE]
devFrom1=devTo1
devFrom2=devTo2
…
При приеме, данные полученные от прибора devFrom будут сохранены от имени прибора devTo. Например:
81500=22222
Данные, пришедшие с прибора 81500, будут записаны в файл прибора 22222.
ВНИМАНИЕ: При изменении содержимого файла DevReplace.ini необходимо перезапустить службу «АвтоГРАФ-Сервер».

подмена паролей при запросе со стороны диспетчера

Подмена паролей используется при необходимости сменить пароль для запроса данных диспетчером, без перенастройки контроллера «АвтоГРАФ».  Для использования этой возможности необходимо проделать следующие действия:

После запуска службы появится каталог Passwords. В него необходимо поместить файлы типа "номерприбора.psw" всех приборов, пароли которых необходимо подменять. В файле строка пароля не более 8 символов. Если строка пароля менее 8 символов она дополнится пробелами справа до 8 символов. Пример файла прилагается (22356.psw).

Файлы в каталоге Passwords обрабатываются на лету: при изменении содержимого каталога перезапуска службы не требуется. 
Для контроля в папке с установленным «АвтоГРАФ-Сервер» создается файл DispPasswords.txt, в котором содержатся все номера приборов с паролями, для которых действует подмена паролей.

настройкА приборов через сервер

Для настройки прибора через сервер необходимо выполнить следующее:
1. В папке Conf создаете папку, соответствующую номеру прибора
2. В этой папке создаете текстовый файл с расширением .atc, в котором располагаете команды.
Команды должны соответствовать формату SMS 5.0 без пароля впереди, по одной команде на строку. Пример содержимого файла:

PERIODWR=5;
PERIODANALOG=3600;
PERIODSEND=30;
ALIAS=Test123;

Можно взять файл .atc, созданный программой GSMConf версии 2.4 и выше и удалить из него лишние строки (команды).
Настройки на прибор будут отправлены при следующей передачи прибором данных на сервер. Журнал настройки прибора создается в каталоге Log и имеет следующий вид:

>|10:28:30|PERIODSEND=120;
<|10:28:32|PERIODSEND=120;
!|10:28:32|CONF ACCEPTED
-----------
>|10:28:32|PERIODWR=8;
<|10:28:34|PERIODWR=8;
!|10:28:34|CONF ACCEPTED
-----------

В первой строке указывается команда (префикс «>»), которая ушла на прибор. Вторая строка - ответ прибора на команду (префикс «<»), третья - резолюция о том, что возвращенный ответ прибора совпал с командой (префикс «!»).

вставка данных в SQL базу

В текущей реализации в базу данных экспортируются только координаты, дата-время, и скорость (если в приборе включена запись характеристик движения). Для включения экспорта в БД можно воспользоваться программой «AutoGRAPHConsol.exe», или установить в файле AutographServer.ini переменную EnableSQL в 1.  Подробно настройка экспорта описана в отдельном документе «Настройка экспорта в SQL.pdf».

пересылка данных на другой сервер в формате АвтоГРАФ'а

·	Для включения функции пересылки можно воспользоваться программой «AutoGRAPHConsol.exe», или установить в файле AutographServer.ini переменную RedirectEnable в 1:
RedirectEnable=1
·	Настроить параметры пересылки:
Указать ip адрес и порт сервера, на который будут пересылаться данные.
Указать период пересылки данных
·	Если необходимо пересылать данные всех приборов, обслуживаемых сервером, установите параметр RedirectAll=1:
·  Если необходимо пересылать данные только нескольких приборов, то необходимо сделать следующее:
Установить параметр RedirectAll=0.
Создать в подпапке Redirect (созданной в папке с установленным ПО «АвтоГРАФ-Сервер») файлы, имена которых являются номерами контроллеров, для которых необходимо включить пересылку данных. Расширение файлов значения не имеет и может быть любым, либо вовсе отсутствовать.
Файлы в каталоге Redirect обрабатываются на лету: при изменении содержимого каталога перезапуска службы не требуется. 
Для контроля в папке с установленным «АвтоГРАФ-Сервер» создается файл Redirect.txt, в котором содержаться номера приборов для которых будет производится пересылка данных.

УТИЛИТА CreateAllBillingFiles.exe

Утилита CreateAllBillingFiles.exe входит в комплект поставки ПО «АвтоГРАФ-Сервер» и служит для создания биллинговых файлов в каталоге Dispatcher для ВСЕХ обслуживаемых сервером приборов. 
Запускать утилиту CreateAllBillingFiles.exe необходимо из папки, в которую было установлено ПО «АвтоГРАФ-Сервер».

ОБНОВЛЕНИЕ ПО «АвтоГРАФ-Сервер» 

Для  обновления ПО «АвтоГРАФ-Сервер» в общем случае:
·	Остановите службу «АвтоГРАФ-Сервер». Для остановки службы, откройте «Пуск -> Панель управления -> Администрирование 
-> Службы», найдите в списке службу «АвтоГРАФ-Сервер», щелкните на ней правой кнопкой мыши и выберите «Остановить».
·	Замените файл AutoGRAPHServer.exe
·	Сделайте необходимые настройки (если требуется)
·	Запустите службу «АвтоГРАФ-Сервер». Для запуска службы, откройте «Пуск -> Панель управления -> Администрирование 
-> Службы», найдите в списке службу «АвтоГРАФ-Сервер», щелкните на ней правой кнопкой мыши и выберите «Запустить».

ДЕИНСТАЛЛЯЦИЯ СЛУЖБЫ «АвтоГРАФ-Сервер» 

Для удаления службы «АвтоГРАФ-Сервер», войдите в папку с установленным ПО «АвтоГРАФ-Сервер» и:
·	запустите из командной строки файл AutoGRAPHServer.exe с ключом /uninstall (AutoGRAPHServer.exe /uninstall)
или
·	запустите файл Uninstall.bat
При этом файлы ПО «АвтоГРАФ-Сервер», а также файлы с данными контроллеров удалены не будут. В случае необходимости, это нужно будет сделать вручную.

ООО «ТехноКом»
Россия, г. Челябинск
Официальный сайт: http://www.tk-chel.ru
E-mail: mail@tk-chel.ru
Тел/факс: (351) 796-04-24
Тел.: (351) 270-25-50