Сервер сообщений

Материал из TaxiMaster
Версия от 14:04, 2 февраля 2009; RishatMuhametshin (обсуждение | вклад) (Файл конфигурации СМС-сервера: кавычки — красивее)

Перейти к: навигация, поиск

СМС-сервер — это серверное приложение, которое обеспечивает совместную работу Такси-Мастер, непосредственно модуля СМС и устройства связи (как правило, мобильного телефона). СМС-сервер защищен ключом защиты NET III и использует одну специфическую лицензию.

Установка СМС-сервера

Установка СМС-сервера происходит из дистрибутива, который вы получаете либо на компакт-диске, либо по электронной почте. Дистрибутив СМС-сервера — это один файл с расширением exe, который открывает мастер установки.

Чтобы начать установку сервера, запустите дистрибутив. Следуйте инструкциям, описанным в мастере установки. Некоторые шаги пояснены ниже.

Информация о пользователе

На шаге «Информация о пользователе» мастер запросит имя пользователя и название организации-правообладателя. В поля Имя пользователя и Организация введите соответственно имя пользователя Windows и название организации, на которую оформлен договор.

Эта информация является необязательной.

Путь к серверу Guardant

На шаге «Путь к серверу Guardant» в поле Имя сервера Guardant укажите имя или ip-адрес компьютера, на котором установлен сервер Guardant. Если сервер Guardant установлен на текущем компьютере, вы можете написать имя LOCALHOST или оставить поле пустым — имя будет введено автоматически.

Выбор каталога для установки

На шаге «Выбор каталога для установки» в поле ввода пути к каталогу укажите путь к папке, в которую будет установлен СМС-сервер. По умолчанию устанавливается путь C:\Program Files\Taxi\TMComDevs. Изменять его не рекомендуется.

Настройка СМС-сервера

Настройка СМС-сервера — процедура неоднозначная и может иметь массу исходов. Так или иначе, существует два объекта, с помощью которых конфигурируется СМС-сервер:

  1. Файл конфигурации СМС-сервера: TMComDevs.ini.
  2. Файл конфигурации устройства связи: lcell.conf.

Тогда как имя и положение первого файла всегда неизменно, файлов второго типа может быть несколько — в зависимости от того, сколько устройств связи используется модулем СМС. Каждому устройству связи сопоставляется один такой файл. Его расширение — conf — говорит о том, что это конфигурационный файл.

Файл конфигурации СМС-сервера

'Файл конфигурации СМС-сервера — это файл, который находится в папке с СМС-сервером и называется TMComDevs.ini. Его цель — обеспечить самостоятельный СМС-сервер информацией о том, как найти сервер Такси-Мастер и подключиться к нему, а также о том, какие устройства связи подключены к компьютеру и должны использоваться.

Исходный файл конфигурации СМС-сервера изначально сконфигурирован некорректно — это нужно для того, чтобы избежать быстрого старта и последующей череды возможных ошибок. О том, как настраивать файл конфигурации сервера, читайте в статье «Файл конфигурации СМС-сервера».

Файл конфигурации устройства связи

Файл конфигурации устройства связи — это файл, который содержит в себе информацию (преимущественно — AT-команды), которую программы используют для «общения» с устройством связи (сотовым телефоном). Файл конфигурации в большинстве случаев называется lcell.conf.

Содержимое файла конфигурации устройства связи может выглядеть так:

#Комментарии начинаются с символов # или ;

#команда выбора памяти для чтения SMS сообщения по индексу
memory_select = +CPMS

#при получении сообщения читать только из этой ячейки памяти
#список можно получить по AT{memory_select}=?
#force_read_memory = 

#команда чтения SMS сообщения
read = +CMGR

#команда отправки SMS сообщения
send = +CMGS

#команда удаления SMS сообщения
delete = +CMGD

#префикс набора номера
dial = D

#команда опроса статуса соединения
dial_status = +CLCC

#команда сброса соединения
hangup = +CHUP

#команда генерации DTMF тона
dtmf = +VTS

#команда включения/выключения микрофона
mut = +CMUT

#команда установки громкости гарнитуры
volume = +CLVL

#команды инициализации, каждая команда должна заканчиваться символом ^
init = Z^E0+CLIP=1^+CMGF=0^+CSMS=0^+CNMI=1,1,0,2^+CPMS=?^

Обратите внимание на то, что комментарии в тексте файла конфигурации начинаются с символа # и занимают одну строку.

Основная информация записана в виде «ПАРАМЕТР = ЗНАЧЕНИЕ». Каждый параметр играет свою роль, и если какой-либо параметр будет отсутствовать, файл конфигурации будет считаться недействительным, поэтому будьте осторожны с параметрами. Значения вы можете менять в соответствии с правилами AT-команд.

Иногда могут возникать проблемы с работой модуля с каким-то конкретным сотовым телефоном. Чтобы избежать неожиданностей, проверьте телефон на пригодность работы с модулем СМС.

Запуск СМС-сервера

Запуск СМС-сервера происходит через командную строку Windows или через оснастку «Службы». Окно «Службы» можно открыть через строку «Выполнить» (Пуск → Выполнить), вызвав команду services.msc. Запуск из командной строки, однако, удобнее, поскольку для него уже готовы необходимые пакетные файлы.

Специально для удобства в папке с сервером находятся четыре файла:

  1. install.bat
  2. start.bat
  3. stop.bat
  4. uninstall.bat

Это пакетные файлы Windows, содержащие инструкции командной строки, и запуск каждого из них выполняет какие-то действия со службой СМС-сервера. Запуск этих файлов возможен тогда и только тогда, когда на них выставлено разрешение в операционной системе. Это входит в круг задач вашего технического специалиста.

Сразу после установки СМС-сервера нужно запустить соответствующую службу. Для этого откройте директорию с установленным СМС-сервером (см. выше) и запустите пакетные сценарии для установки и запуска службы. Делать это нужно последовательно.

Установка службы

Для установки службы в список служб Windows (Панель управления → Администрирование → Службы) запустите install.bat. Это действие нужно выполнить сразу после установки СМС-сервера на компьютер. В случае, если установка службы пройдет успешно, операционная система выдаст сообщение об успешной установке службы (“Service installed successfully”). Если служба уже установлена, в окне командной строки будет выведено сообщение «Указанная служба уже установлена».

Запуск службы

Запуск службы нужно выполнять только после того, как вы настроили сервер. После запуска службы в списке процессов диспетчера задач Windows на вкладке «Процессы» появится процесс TMComDevs.exe. Также должен появиться процесс TMGuard.exe — он предохраняет службу СМС-сервера от сбоев, перезапуская ее в случае возникновения критической ошибки или непредвиденного закрытия.

Запуск службы выполняется с помощью файла start.bat.

Остановка службы

Остановка службы выполняется в тех случаях, когда нужно применить новые параметры настройки сервера, поскольку если вы поменяли параметры, но не перезапустили службу, новые настройки в силу не вступят. Также остановка сервера может выполняться для очистки оперативной памяти, однако СМС-сервер может работать без перезапусков довольно продолжительное время (сутки и больше) и сохранять стабильность.

Чтобы остановить службу, запустите stop.bat.

Удаление службы

Удаление службы — это мера, которая применяется тогда, когда нужно установить новую версию СМС-сервера. Если служба находится в списке служб Windows, заменить ее на новую не получится, поэтому необходимо удалить старую и только после этого устанавливать новую версию СМС-сервера.

Чтобы удалить службу, запустите uninstall.bat.

Работа СМС-сервера

СМС-сервер выполнен в виде службы (service) и поэтому работает в фоновом режиме. Это означает, что во время работы сервер не показывает никаких окон. Тем не менее, в процессе работы служба СМС-сервера записывает журналы работы (см. ниже). Эти журналы в дальнейшем могут использоваться для проверки работы и выявления необходимой информации.

Ключ

СМС-сервер потребляет одну лицензию ключа NET III. Эта лицензия — специфическая, поэтому не отображается на заставке перед запуском программы, но в журнале работы сервера всегда записывается информация о корректности (или ошибочности) лицензии. Единственная особенность этой лицензии: потребляемых лицензий ключа становится на одну больше, то есть, например, если у вас 4 рабочих места Такси-Мастер, то нужен ключ как минимум на 5 лицензий, если работает СМС-сервер.

Чтобы подробнее разобраться с принципом работы ключа, читайте статью о NET III.

Журналы работы СМС-сервера

Журналы работы СМС-сервера по умолчанию хранятся в папке Logs, которая находится в папке с сервером.

Вы всегда можете изменить расположение файлов журналов. В этом случае вы должны знать, где находятся журналы работы СМС-сервера и по просьбе сотрудника отдела технической поддержки отправлять их, не создавая излишних проблем поиска файлов.

Существует несколько журналов работы:

  1. Журнал работы сервера. По умолчанию — TMComDevs.log.
  2. Журнал работы устройства связи.
  3. Журнал отправки и приема сообщений.

Все журналы создаются автоматически на основании настроек СМС-сервера.

Обратите внимание на то, что по умолчанию все журналы хранятся в папке C:\Program Files\Taxi\TMComDevs\Logs.