Администратор системы передачи данных

45602127.49931.310-01 32 01-ЛУ

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

Администратор системы передачи данных

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

ПО Администратор СПД

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

45602127.49931.310-01 32 01

Листов 1

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

2005

АННОТАЦИЯ

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

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

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

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

КИ – концентратор информации КИ-6М;

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

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

СОДЕРЖАНИЕ:

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

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

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

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

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

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

3        Установка программы        8

4        Настройка ПО        9

5        Проверка программы        10

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

ПРИЛОЖЕНИЕ 1        13

Структура файла spdadmin. ini        13

ПРИЛОЖЕНИЕ 2        16

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

Общие сведения о программе Назначение и функции программы

Программное обеспечение (ПО) «Администратор СПД» предназначено для администрирования устройств СПД (концентраторы информации  и периферийные контроллеры). Связь с СПД осуществляется через программно аппаратный комплекс «Центральный концентратор информации». ПО «Администратор СПД» обеспечивает решение следующих задач:

автоматическую диагностику (опрос) устройств и каналов связи; обнаружение неисправностей устройств СПД; включение визуальной и звуковой сигнализации при обнаружении отказов.

ПО «Администратор СПД» позволяет пользователю выполнять в интерактивном режиме следующие функции:

редактирование схемы топологии СПД и параметров (настроек) устройств СПД;

получение информации о состоянии устройств СПД;

получение информации версии программного обеспечения устройств СПД;

принудительная инициализация устройств СПД;

перезапуск программного обеспечения устройств СПД.

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

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

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

Наименование характеристики	Требование
Процессор	не менее Pentium
Тактовая частота процессора	не менее 400 мГц
Память (ОЗУ)	не менее 128 MB
Свободного места на жестком магнитном диске	не требует
Видеоадаптер	SVGA, с разрешением не менее 1024х768
Видеомонитор	Диагональ не менее 15 дюймов, поддерживающий разрешение не менее 1024х768;
Манипулятор	"Мышь", двухкнопочная
Клавиатура	Русифицированная, 102 клавиши
Звуковая карта

ПО «Администратор СПД» предназначено для функционирования в операционной среде Windows 98/NT4.0/2000/XP.

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

В ПО «Администратор СПД» включены файлы, состав и назначение которых приведены в Таблица 2.

Таблица 2. Состав поставляемого ПО «Администратор СПД».

Имя файла/каталога	Назначение
spdadmin. exe	исполняемый файл основной программы
spdedit. exe	исполняемый файл программы редактирования конфигурации «Редактор схем СПД»
spdinit. dll	файл динамической библиотеки, необходимый для работы spdedit. exe
spdadmin. ini	конфигурационный файл основной программы
lg_adm. ini	файла конфигурации отладочной информации
spd_cfg. dev	«пустой» файл конфигурации СПД
input. btr	«пустой» файл базы данных состояний устройств СПД
.\WAVE	каталог для размещения файлов звуковой сигнализации
отказ. wav	содержит слово «Отказ»
нет_связи. wav	содержит слова «Нет связи с»
class_armlpk. wav	содержит слова «АРМ ЛПК»
class_ki. wav	содержит слово «КИ-6»
class_ktsm. wav	содержит слово «КТСМ»
class_pk01.wav	содержит слово «ПК-01»
class_pk04.wav	содержит слово «ПК-04»
ЦКИ. wav	содержит слово «ЦКИ»

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

Для отображения текущей информации о состоянии устройств СПД необходимо иметь доступ к  кольцевой базе данных состояний в формате СУБД «Pervasive SQL».

Обычно ПО «Администратор СПД» размещается на файловом сервере и запускается на рабочей станции из сетевого ресурса.

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

Программа spdadmin. exe при запуске загружает в память данные конфигурации из файла spdadmin. ini, данные из файла конфигурации СПД, и переходит в режим информационного обмена с ЦКИ. При этом сначала считывается информация о текущем состоянии устройств СПД, а затем  формируются необходимые запросы в устройства СПД. Запросы посылаются с помощью сетевого протокола UDP/IP непосредственно через ЦКИ.

При обнаружении новых данных о состоянии контролируемых устройств, программа считывает эти данные и изменяет соответствующим образом символическое изображение объекта на соответствующей схеме. При получении информации о наличии неисправностей в устройствах, программа отправляет им запрос для получения расширенной информации о неисправности.

Установка программы

Установка ПО «Администратор СПД» должна производится в следующей последовательности:

зарегистрироваться в системе пользователем с правами локального администратора; создать на сетевом или локальном диске рабочий каталог. Обычно используется «D:\Progs\SpdAdmin\»; скопировать все файлы кроме «spd_cfg. dev» и «input. btr»  с установочного диска в рабочий каталог программы; скопировать файл «spd_cfg. dev» на FTP-ресурс, предназначенный для загрузки конфигурации ЦКИ; скопировать файл «input. btr» в каталог баз данных сервера. Обычно используется «D:\Db\Spd\»; создать ярлыки для запуска программ «Администратор СПД» и «Редактор схем СПД», скопировать их на «Рабочий стол».

Настройка ПО

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

Средствами сетевого администрирования обеспечить доступ с правами на чтение рабочей станции к файлам: конфигурации СПД, звуковым файлам сигнализации, а также к файлу состояний устройств СПД. Отредактировать любыми текстовым редактором файл spdadmin. ini в соответствии с Приложением 1:

в секции [Mode] в параметрах Active= указать имена рабочих станций, с которых ПО будет запускаться в активном режиме; в параметрах Passive= указать имена рабочих станций, с которых ПО будет запускаться в пассивном режиме; в секции [FTP] указать значения «Username» и «Password», необходимые для доступа к FTP ресурсу. в секции [Path] указать ссылку на файл конфигурации СПД (Devices=); путь к файлу состояний устройств СПД (Answer=)  и путь к звуковым файлам (SoundPath=).

Проверка программы

Запустить программу spdadmin. exe, используя команду Windows «Выполнить» или ярлык на рабочем столе.

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

Нажать кнопку в верхнем левом углу экрана. Должно появиться информирующее окно Рис. 1

Рис. 1

Проверить правильность «Способа работы» и путей к файлам конфигурации и состояния.

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

Рис. 2

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

Текст сообщения	Возможная причина	Действия
«Не найден файл инициализации»	программа не обнаруживает обязательный файл настроек spdadmin. ini. файл был случайно удалён или программа запускается из другого каталога	Скопируйте файл настроек с установочной дискеты в рабочий каталог программы и произведите в нём необходимые исправления
«Не задан путь к файлу …»	программа не обнаруживает необходимых переменных в файле настроек sdpadmin. ini.	Необходимо отредактировать его в соответствии с Приложением 1
«Ошибка Btrieve …»	не установлена или не правильно работает СУБД.	подробную информацию по кодам ошибок СУБД Btrieve можно найти в документации, поставляемой в ее составе

ПРИЛОЖЕНИЕ 1

Структура файла spdadmin. ini

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

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

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

Параметр	Значение по умолчанию	Назначение
[Mode]	Секция основных настроек
Multy	No	позволяет запускать более одной копии программы на рабочей станции.
UseLocalExe	No	автоматически копирует exe-файл программы на локальный диск (в каталог Windows) перед его первым запуском, для предотвращения блокировки exe-файла на сетевом устройстве. При изменении exe-файла программы, находящегося на сетевом устройстве, происходит его повторное автоматическое копирование на локальный диск рабочей станции.
Sound	Yes	включает звуковую сигнализацию отказов.
Active	определяет имена компьютеров, на которых программа запускается в активном режиме. В активном режиме автоматически посылаются запросы в ЦКИ для получения версии устройств и расширенной информации о состоянии устройств.
Passive	определяет имена компьютеров, на которых программа запускается в пассивном режиме. В пассивном режиме программа позволяет пользователю вручную посылать запросы в ЦКИ.
SingleRequestCount	3	определяет количество одновременно посылаемых через ЦКИ запросов. Допустимые значения от 1 до 32.
IgnoreEventTime	No	определяет, должно ли время фиксации события устройством сбора информации сравниваться с текущим временем на компьютере. При значении «No» устаревшие события не будут обрабатываться.
[FTP]	Секция настройки соединения с FTP сервером
Passive	Yes	определяет способ подключения.
Username	«anonymous»	указывает имя пользователя, используемое при подключении.
Password	spdadmin @infotecs. mps	указывает пароль, используемый при подключении.
[Path]	Секция полных рабочих путей
Log	Определяет имя файла настройки сообщений о функционировании программы в период её адаптации.
Devices	ссылка к файлу, в котором находится информация о конфигурации сети СПД (*.dev). В данном параметре можно указать путь к файлу, размещенному на ftp сервере.
Answers	указывает путь к файлу состояния СПД. Данный файл формируется программой «Конвертер СПД».
SoundPath	каталог, где размещены файлы в формате *.wav, которые будет проигрываться при отказах.
Sound_FaultCICPrefix	имя файла, который будет проигрываться при потере связи с ЦКИ.(Нет_связи. wav)
Sound_FaultCIC	файл имени ЦКИ по умолчанию (ЦКИ. wav)
Sound_FaultPrefix	имя файла, который будет проигрываться при отказе устройства СПД (Отказ. wav).

ПРИЛОЖЕНИЕ 2

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

При необходимости отладки работы программы, ведения журнала ошибок, нужно настроить файл конфигурации отладочных данных lg_adm. 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»

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

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