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

УТВЕРЖДЕН
45602127.49931.310-01 32 01-ЛУ
Система передачи данных на базе концентраторов информации
КИ-6М СПД ЛП
Администратор системы передачи данных
Программное обеспечение
ПО Администратор СПД
Руководство программиста
45602127.49931.310-01 32 01
Листов 15
Екатеринбург
2005
-2–
45602127.49931.001-01 32 01
АННОТАЦИЯ
Настоящее руководство предназначено для системных программистов и системных
администраторов, обеспечивающих установку, пуск и эксплуатацию программного обеспечения
«Администратор СПД».
Руководство содержит основные требования к составу и характеристикам технических и
системных
программных
средств,
необходимых
для
нормального
функционирования
программного обеспечения «Администратор СПД», а также порядок конфигурации программы
для конкретных условий применения и указания по восстановлению после сбоев или отказов..
В настоящем документе приняты следующие условные обозначения:
СПД – система передачи данных;
КИ – концентратор информации КИ-6М;
ЛВС – локальная вычислительная сеть;
ЦКИ – центральный концентратор информации.
-3–
45602127.49931.001-01 32 01
СОДЕРЖАНИЕ:
1
ОБЩИЕ СВЕДЕНИЯ О ПРОГРАММЕ ............................................................................................ 4
1.1 НАЗНАЧЕНИЕ И ФУНКЦИИ ПРОГРАММЫ ..................................................................................................4
1.2 УСЛОВИЯ ПРИМЕНЕНИЯ...........................................................................................................................4
2
СТРУКТУРА ПРОГРАММЫ .............................................................................................................. 6
2.1 ПЕРЕЧЕНЬ ПРОГРАММНЫХ КОМПОНЕНТОВ .............................................................................................6
2.2 ВЗАИМОДЕЙСТВИЕ КОМПОНЕНТОВ .........................................................................................................7
3
УСТАНОВКА ПРОГРАММЫ ............................................................................................................ 8
4
НАСТРОЙКА ПО .................................................................................................................................. 9
5
ПРОВЕРКА ПРОГРАММЫ .............................................................................................................. 10
6
СООБЩЕНИЯ ПРОГРАММИСТУ ................................................................................................. 11
ПРИЛОЖЕНИЕ 1 ........................................................................................................................................ 12
СТРУКТУРА ФАЙЛА SPDADMIN.INI ............................................................................................................... 12
ПРИЛОЖЕНИЕ 2 ........................................................................................................................................ 14
СТРУКТУРА ФАЙЛА КОНФИГУРАЦИИ ОТЛАДОЧНЫХ ДАННЫХ .................................................................... 14
-4–
45602127.49931.001-01 32 01
1 Общие сведения о программе
1.1 Назначение и функции программы
Программное
обеспечение
(ПО)
«Администратор
СПД»
предназначено
для
администрирования устройств СПД (концентраторы информации и периферийные контроллеры).
Связь с СПД осуществляется через программно аппаратный комплекс
«Центральный
концентратор информации». ПО «Администратор СПД» обеспечивает решение следующих задач:

автоматическую диагностику (опрос) устройств и каналов связи;

обнаружение неисправностей устройств СПД;

включение визуальной и звуковой сигнализации при обнаружении отказов.
ПО «Администратор СПД» позволяет пользователю выполнять в интерактивном режиме
следующие функции:
редактирование схемы топологии СПД и параметров (настроек) устройств СПД;
получение информации о состоянии устройств СПД;
получение информации версии программного обеспечения устройств СПД;
принудительная инициализация устройств СПД;
перезапуск программного обеспечения устройств СПД.
1.2 Условия применения
ПО «Администратор СПД» предназначено для функционирования на ЭВМ класса IBM PC
или совместимой, подключенной к локальной вычислительной сети в качестве рабочей станции, и
соответствующей требованиям, приведенным в Таблица 1.
Таблица 1. Технические характеристики ПЭВМ.
Требование
Наименование характеристики
Процессор
не менее Pentium
Тактовая частота процессора
не менее 400 мГц
Память (ОЗУ)
не менее 128 MB
Свободного места на жестком магнитном диске не требует
Видеоадаптер
SVGA, с разрешением не менее 1024х768
Видеомонитор
Диагональ не менее 15 дюймов,
поддерживающий разрешение не менее
1024х768;
-5–
45602127.49931.001-01 32 01
Наименование характеристики
Требование
Манипулятор
"Мышь", двухкнопочная
Клавиатура
Русифицированная, 102 клавиши
Звуковая карта
ПО «Администратор СПД» предназначено для функционирования в операционной среде
Windows 98/NT4.0/2000/XP.
-6–
45602127.49931.001-01 32 01
2 Структура программы
2.1 Перечень программных компонентов
В ПО «Администратор СПД» включены файлы, состав и назначение которых приведены в
Таблица 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».
-7–
45602127.49931.001-01 32 01
Обычно ПО «Администратор СПД» размещается на файловом сервере и запускается на
рабочей станции из сетевого ресурса.
2.2 Взаимодействие компонентов
Программа spdadmin.exe при запуске загружает в память данные конфигурации из файла
spdadmin.ini, данные из файла конфигурации СПД, и переходит в режим информационного обмена
с ЦКИ. При этом сначала считывается информация о текущем состоянии устройств СПД, а затем
формируются необходимые запросы в устройства СПД. Запросы посылаются с помощью сетевого
протокола UDP/IP непосредственно через ЦКИ.
При обнаружении новых данных о состоянии контролируемых устройств, программа
считывает эти данные и изменяет соответствующим образом символическое изображение объекта
на соответствующей схеме. При получении информации о наличии неисправностей в устройствах,
программа отправляет им запрос для получения расширенной информации о неисправности.
-8–
45602127.49931.001-01 32 01
3 Установка программы
Установка
ПО
«Администратор
СПД»
должна
производится
в
следующей
последовательности:
 зарегистрироваться в системе пользователем с правами локального администратора;
 создать на сетевом или локальном диске рабочий каталог. Обычно используется
«D:\Progs\SpdAdmin\»;
 скопировать все файлы кроме «spd_cfg.dev» и «input.btr» с установочного диска в рабочий
каталог программы;
 скопировать
файл
«spd_cfg.dev» на
FTP-ресурс,
предназначенный
для
загрузки
конфигурации ЦКИ;
 скопировать файл «input.btr» в каталог баз данных сервера. Обычно используется
«D:\Db\Spd\»;
 создать ярлыки для запуска программ «Администратор СПД» и «Редактор схем СПД»,
скопировать их на «Рабочий стол».
-9–
45602127.49931.001-01 32 01
4 Настройка ПО
Настройка ПО производится в следующем порядке:
 Средствами сетевого администрирования обеспечить доступ с правами на чтение
рабочей станции к файлам: конфигурации СПД, звуковым файлам сигнализации, а также к
файлу состояний устройств СПД.
 Отредактировать любыми текстовым редактором файл spdadmin.ini в соответствии с
Приложением 1:
o в секции [Mode] в параметрах Active= указать имена рабочих станций, с которых
ПО будет запускаться в активном режиме; в параметрах Passive= указать имена рабочих
станций, с которых ПО будет запускаться в пассивном режиме;
o в секции [FTP] указать значения «Username» и «Password», необходимые для
доступа к FTP ресурсу.
o в секции [Path] указать ссылку на файл конфигурации СПД (Devices=); путь к
файлу состояний устройств СПД (Answer=) и путь к звуковым файлам (SoundPath=).
- 10 –
45602127.49931.001-01 32 01
5 Проверка программы
Запустить программу spdadmin.exe, используя команду Windows «Выполнить» или ярлык на
рабочем столе.
Если в процессе загрузки на экран монитора не выводится окно с сообщениями об ошибках,
то это означает, что установка и конфигурация программы выполнена правильно.
Нажать кнопку
в верхнем левом углу экрана. Должно появиться информирующее окно
Рис. 1
Рис. 1
Проверить правильность «Способа работы» и путей к файлам конфигурации и состояния.
Если на данный момент ЦКИ уже настроен и запущен, то необходимо нажать кнопку
в
верхнем правом углу экрана. Появится окно управления ЦКИ Рис. 2. Нажать кнопку «Сбор
диагностики по линиям». При правильной конфигурации и наличие связи с ЦКИ в окне должно
появиться сообщение «Команда принята!».
Рис. 2
- 11 –
45602127.49931.001-01 32 01
6 Сообщения программисту
Текст сообщения
Возможная причина
Действия
«Не найден файл инициализации»
программа не обнаруживает
обязательный файл настроек
spdadmin.ini. файл был
случайно удалён или
программа запускается из
другого каталога
Скопируйте файл
настроек с установочной
дискеты в рабочий
каталог программы и
произведите в нём
необходимые
исправления
«Не задан путь к файлу …»
программа не обнаруживает
необходимых переменных в
файле настроек sdpadmin.ini.
Необходимо
отредактировать его в
соответствии с
Приложением 1
«Ошибка Btrieve …»
не установлена или не
правильно работает СУБД.
подробную информацию
по кодам ошибок СУБД
Btrieve можно найти в
документации,
поставляемой в ее
составе
- 12 –
45602127.49931.001-01 32 01
ПРИЛОЖЕНИЕ 1
Структура файла spdadmin.ini
Файл конфигурации «spdadmin.ini» состоит из текстовых строк, разделенных кодами
«возврата каретки» и «перевода строки». Строки файла содержат имена секций, заключенных в
квадратные скобки. В каждой секции может быть несколько параметров. Параметр состоит из
имени, знака «=» и значения. Символы, следующие после «;» (точка с запятой) являются
комментариями.
Название и назначение секций и параметров приведены в Таблица 3.
Таблица 3 Структура файла настроек
Параметр
Значение по
умолчанию
Секция основных настроек
[Mode]
Multy
Назначение
No
позволяет запускать более одной копии программы на рабочей
станции.
UseLocalExe
No
автоматически копирует exe-файл программы на локальный
диск (в каталог Windows) перед его первым запуском, для
предотвращения блокировки exe-файла на сетевом устройстве.
При изменении exe-файла программы, находящегося на
сетевом устройстве, происходит его повторное
автоматическое копирование на локальный диск рабочей
станции.
Sound
Yes
Active
включает звуковую сигнализацию отказов.
определяет имена компьютеров, на которых программа
запускается в активном режиме. В активном режиме
автоматически посылаются запросы в ЦКИ для получения
версии устройств и расширенной информации о состоянии
устройств.
Passive
определяет имена компьютеров, на которых программа
запускается в пассивном режиме. В пассивном режиме
программа позволяет пользователю вручную посылать
запросы в ЦКИ.
SingleRequestCount 3
определяет количество одновременно посылаемых через ЦКИ
- 13 –
45602127.49931.001-01 32 01
Параметр
Значение по
умолчанию
Назначение
запросов. Допустимые значения от 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).
- 14 –
45602127.49931.001-01 32 01
ПРИЛОЖЕНИЕ 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»
- 15 –
45602127.49931.001-01 32 01
ЛИСТ РЕГИСТРАЦИИ ИЗМЕНЕНИЙ
Номера листов (страниц)
Изм.
Измененных
Замененных
Новых
Аннулированных
Всего
листов
в документе
Номер
документа
Вх. №
сопроводит.
документа
и дата
Подп.
Дата.