Система передачи данных на базе концентраторов информации КИ-6М СПД ЛП

УТВЕРЖДАЮ Директор АТ» __________ «___»______________ 2005 г.

Система передачи данных на базе концентраторов информации КИ-6М СПД ЛП

Конвертер центрального концентратора информации

Программное обеспечение

ПО Конвертер ЦКИ

 

Руководство программиста

Лист утверждения

45602127.50 1529 020-03 92 01-ЛУ

Листов 15

Руководитель разработки

АТ»

___________

«___»______________ 2005 г.

Исполнитель

___________

«_____»_____________ 2005 г

Екатеринбург

2005

УТВЕРЖДЕН 45602127.50 1529 020-03 92 01-ЛУ

Система передачи данных на базе концентраторов информации КИ-6М СПД ЛП

Конвертер центрального концентратора информации

Программное обеспечение

ПО Конвертер ЦКИ

Руководство программиста

45602127.50 1529 020-03 92 01

Листов 15

Екатеринбург

2005

Аннотация

Настоящее руководство предназначено для системных программистов и системных администраторов, обеспечивающих установку, пуск и эксплуатацию программного обеспечения «Конвертер ЦКИ».

Руководство содержит основные требования к составу и характеристикам технических и системных программных средств, необходимых для нормального функционирования ПО «Конвертер ЦКИ», а также порядок конфигурации программы для конкретных условий применения и указания по восстановлению после сбоев или отказов.

В настоящем документе приняты следующие условные обозначения:

СПД – система передачи данных;

ЛВС – локальная вычислительная сеть;

ЦКИ – центральный концентратор информации;

АСК ПС – Автоматизированная система контроля подвижного состава.

Содержание

Аннотация. 3

1. Общие сведения о программе. 5

1.1. Назначение и функции программы.. 5

1.2. Условия применения. 5

1.3. Используемая СУБД.. 5

2. Структура программы.. 6

2.1. Перечень программных компонентов. 6

2.2. Входные и выходные данные. 6

2.3. Взаимодействие компонентов. 6

3. Установка ПО.. 7

4. Настройка ПО.. 8

5. Проверка работоспособности ПО.. 9

6. Сообщения программисту. 11

ПРИЛОЖЕНИЕ 1. 12

Структура конфигурационного файла. 12

ПРИЛОЖЕНИЕ 2. 14

Структура файла конфигурации отладочных данных. 14

2. Общие сведения о программе

2.1. Назначение и функции программы

2.1.1.  ПО «Конвертер ЦКИ» предназначено для получения информации от ЦКИ, преобразование и сохранение ее в кольцевую базу данных в формате СУБД «Btrieve».

2.1.2.  Функции преобразования информации заключаются в приеме дейтаграмм сетевого протокола UDP/IP, поступающих от ЦКИ, проверки последовательности поступления данных и формировании записей в формате СУБД «Btrieve».

2.2. Условия применения

ПО «Конвертер ЦКИ» предназначено для функционирования на ЭВМ класса IBM PC или совместимой, подключенной к локальной вычислительной сети в качестве рабочей станции или сервера и соответствующей требованиям, приведенным в Таблица 1.

Таблица 1. Технические характеристики ЭВМ.

Наименование характеристики	Требование
Процессор	не менее Pentium
Тактовая частота процессора	не менее 400 мГц
Память (ОЗУ)	не менее 128 MB
Свободного места на жестком магнитном диске	не менее 800 МВ
Сетевой адаптер	Ethernet

ПО «Конвертер ЦКИ» предназначено для функционирования в операционной среде Windows NT4.0/2000/XP.

2.3. Используемая СУБД

ПО «Конвертер ЦКИ» использует СУБД «Btrieve» (версия не ниже 7.0).

Если ПО «Конвертер ЦКИ» устанавливается на Сервере баз данных, то на Сервере должна быть установлена серверная часть СУБД. Если ПО устанавливается на другом компьютере, то на этом компьютере должен быть установлен клиент СУБД. Установка СУБД должна производится в соответствии с документацией, поставляемой в ее составе.

Настоятельно рекомендуется использовать ПО «Конвертер ЦКИ» на Сервере баз данных.

3. Структура программы

3.1. Перечень программных компонентов

В состав поставляемого ПО «Конвертер ЦКИ» входят состав и назначение которых приведены в Таблица 2

Таблица 2 Состав поставляемого ПО

Имя файла	Назначение
cc_cvt. exe	исполняемый файл основной программы «Конвертер ЦКИ»
cc_cvt. ini	пример конфигурационного файла
lg_cvt. ini	пример файла конфигурации отладочной информации
CC_CVT_depend_psql7.reg	файл для настройки реестра ОС
appmon. exe	программа «Монитор приложений»
appmon. ini	файл конфигурации программы «Монитор приложений»

3.2. Входные и выходные данные

Входными и выходными данными со стороны ЦКИ являются дейтаграммы сетевого протокола UDP/IP.

Выходными данными в сторону Сервера являются записи в кольцевых базах данных в формате СУБД «Btrieve».

3.3. Взаимодействие компонентов

Программа cc_cvt. exe при запуске загружает в память данные настроек из файла cc_cvt. ini и переходит в режим ожидания дейтаграмм сетевого протокола UDP/IP от ЦКИ.

При получении информации от ЦКИ, программа проверяет последовательность пришедших данных (исключая дублированные данные из обработки) и записывает их в соответствующую кольцевую базу данных.

4. Установка ПО

Установка ПО «Конвертер ЦКИ» должна производится в следующей последовательности:

·  зарегистрироваться в системе пользователем с правами локального администратора;

·  создать на сетевом или локальном диске рабочий каталог. Обычно используется «D:\Progs_sys\Cc_cvt»;

·  скопировать все файлы с установочного диска в рабочий каталог;

·  из командной строки однократно запустить исполняемый файл «cc_cvt. exe» с параметром «/install». Данная операция устанавливает в системе службу с именем «Конвертер ЦКИ» («Infotecs - Конвертер ЦКИ»);

·  если ПО «Конвертер ЦКИ» устанавливается на Сервере баз данных, то необходимо запустить файл «CC_CVT_depend_psql7.reg», который устанавливает зависимость от службы «Btrieve 7.0 for Windows NT (Server)»;

·  если служба «Конвертер ЦКИ» запускается не на Сервере, то в ее свойствах (в системном списке служб) необходимо использовать учетную запись, имеющую права записи в файлы кольцевых баз данных на Сервере;

·  создать ярлык для запуска программы «Монитор приложений» и скопировать его на «Рабочий стол» системы.

5. Настройка ПО

Все настройки ПО определяются содержимым файла конфигурации «cc_cvt. ini», структура которого описана в Приложении 1. Перед запуском программы необходимо с помощью любого текстового редактора отредактировать в файле следующие параметры:

· Host – установить адрес и порт IP-сокета, через который осуществляется связь с ЦКИ.

· Btr_file – указать полный путь к файлам соответствующих баз данных. Обычно используются следующие значения:

[KTSM]

Btr_file=D:\db\spd\ponabs. btr

[DIAG]

Btr_file=D:\db\spd\input. btr

· RecCount – указать максимальное число записей в базе данных. Число записей зависит от числа централизованных устройств контроля и плотности движения на участке. Для АСК ПС нужно принимать в расчет, что для одного поезда формируется в среднем до 10 записей. Максимальное число записей должно обеспечивать хранение данных как минимум за 24 часа Чрезмерное увеличение числа записей приводит к необоснованному увеличению размера базы данных.

Изменять другие параметры настроек можно только по согласованию с разработчиком.

6. Проверка работоспособности ПО

Проверку работоспособности ПО «Конвертер ЦКИ» необходимо производить в комплексе с проверкой работоспособности ЦКИ. Для этого ЦКИ с установленным ПО должен быть подключен в ЛВС вместе с Сервером.

Проверку работоспособности необходимо производить после установки и настройки ПО в следующем порядке:

· открыть системный список служб;

· найти службу «Конвертер ЦКИ»;

· если служба «Конвертер ЦКИ» установлена на Сервере, то необходимо убедиться, что для нее установлена зависимость от службы серверной части СУБД «Btrieve»;

· запустить службу «Конвертер ЦКИ. В процессе запуска службы на экран монитора не должно выводиться окон с сообщениями об ошибках;

· запустить программу «Монитор приложений». Откроется окно Рис. 1. В списке обнаруженных приложений должна присутствовать запись «Конвертер ЦКИ». В поле «Состояние» должно быть сообщение «Ошибок нет»;

· двойным щелчком мыши по строке «Конвертер ЦКИ» открыть окно «Конвертер ЦКИ» Рис. 2;

· по списку в окне убедиться в корректности имен и путей групп потребителей информации;

· в статусной строке (в низу окна) убедиться в корректности параметров «прослушиваемого» сокета;

· запустить ЦКИ;

· убедится, что в поле «События» строки группы «DIAG» появляются и изменяются значения даты и времени;

· убедится, что в поле «Последняя ошибка» строки группы «DIAG» ничего не выводится;

· проверить наличие на Сервере файла базы данных группы «DIAG».

Программу «Монитор приложений» можно завершить – оно служит только для диагностики и его наличие не влияет на работоспособность службы «Конвертер ЦКИ».

Рис. 1

Рис. 2

7. Сообщения программисту

«Ошибка при запуске» - при запуске службы возникли ошибки. Возможная причина - программа не обнаруживает обязательный файл настроек сс_cvt. ini, либо в нем указаны недопустимые параметры.

«Ошибка Btrieve …» - подробную информацию по кодам ошибок системы управления записями Btrieve можно найти в документации, поставляемой в ее составе.

В случае возникновения каких-либо проблем при запуске или функционировании программного обеспечения необходимо обратиться за подробностями к файлам отладочных сообщений (Приложение 2).

Если при работе программы произошла ошибка приложения, необходимо сообщить разработчику следующую информацию:

·  тип и название ошибки;

·  дата и время ошибки;

·  последовательность действий, приведших к ошибке, периодичность ошибки.

ПРИЛОЖЕНИЕ 1

Структура конфигурационного файла

Файл конфигурации «сс_cvt. ini» состоит из текстовых строк, разделенных кодами «возврата каретки» и «перевода строки». Строки файла содержат имена секций, заключенных в квадратные скобки. В каждой секции может быть несколько параметров. Параметр состоит из имени, знака «=» и значения. Символы, следующие после «;» (точка с запятой) являются комментариями.

Название и назначение секций и параметров приведены в Таблица 3

Таблица 3 Структура файла настроек

Параметр	Обязат.	Назначение
[Mode]	Да	Секция основных настроек
Multy=Yes	Да	Изменять нельзя
Host=	Да	Определяет IP - сокет, используемый для получения UDP/IP дейтаграмм от ЦКИ. Формат: <ip-address>:<port>. «port» (не обязательная часть) может быть задан в шестнадцатеричной форме с префиксом ‘$’. Например, Host=10.47.72.97:$8000. По умолчанию: port=$8000.
Security=	Нет	позволяет ограничивать прием входящих дейтаграммы только с указанных адресов. Значение по умолчанию: «NO»
[Security]	Нет	Секция содержит перечень разрешенных адресов. Формат: <ip-address> =* . Например: 10.72.47.199=*
[Path]	Да	Секция полных рабочих путей
Log=	Нет	Определяет имя файла настройки сообщений о функционировании программы в период её адаптации.
[Abonents]	Да	Секция содержит имена групп получателей информации.
Abonent=	Да	В качестве значений этого параметра должны указываться имена групп. Каждому имени должна соответствовать секция с описанием параметров данной группы.
CIC_Status=	Да	Определяет имя группы для диагностических пакетов ЦКИ.
[имя_группы]	Да	Секция описания параметров группы с именем имя_группы
Kind=	Да	Вид информации в базе данных группы. Допустимые значения: «INF» - общая информация; «SPD» - диагностическая информация от устройств СПД
Btr_file=	Да	Полный путь к файлу базы данных для данной группы
RecCount=	Нет	Определяет количество записей в кольцевой базе данных. Используется только с Kind=INF. При значении -1 старые записи не удаляются. Значение по умолчанию: -1.
MoveTo=	Нет	Определяет имя группы и шаблоны условий для перенаправления данных в другую группу. Изменять значения можно только по указанию разработчика
CopyTo=	Нет	Определяет имя группы и шаблоны условий для копирования данных в другую группу. Изменять значения можно только по указанию разработчика
CE= CS= CV=	Да	Используются только с Kind=SPD. Служат для определения подтипа информации. Изменять значения можно только по указанию разработчика

ПРИЛОЖЕНИЕ 2

Структура файла конфигурации отладочных данных

При необходимости отладки работы программы, ведения журнала ошибок, нужно настроить файл конфигурации отладочных данных lg_cvt. ini (имя файла может быть любое) и указать полный путь к нему в файле сс_cvt. ini, секции [Path], параметре Log (Приложение 1).

Название и назначение секций и параметров файла конфигурации приведены в Таблица 4.

Таблица 4 Структура файла конфигурации отладочных сообщений

Параметр	Значение по умолч.	Назначение
[Mode]		Секция основных настроек
DefPath	.\	каталог, в котором программа размещает файлы отладочных данных. Например, DefPath=.\log\
DefSize	300	максимальный размер отладочного файла (в килобайтах). Если файл превысил заданный размер, программа создает копию этого файла, а текущий файл обнуляется и начинается заново. Если этот параметр равен «-1», размер файла неограничен.
DefBackup	No	при старте программы разрешает создание резервной копии файла отладочных данных, созданного при предыдущем запуске программы.
DefRewrite	No	при старте программы разрешает обнуление файла отладочных данных, созданного при предыдущем запуске программы.
[Files]		Секция описания файлов отладочных данных
ERR		имя файла сообщений об ошибках функционирования программы. Например, «ERR=errors. log»
WARN		имя файла сообщений о вероятных нарушениях логики работы программы. Например, «WARN=warn. log»
WSOCK		имя файла сообщений о статусах завершения операций с IP сокетами. Например, «WSOCK=wsock. log»

ЛИСТ РЕГИСТРАЦИИ ИЗМЕНЕНИЙ

Номера листов (страниц)	Всего листов в доку- менте	Номер доку- мента	Вх. № сопроводит. документа и дата	Подп.	Дата.
Изм.	Изменен- ных	Заменен- ных	Новых	Аннулиро- ванных