Комплекс программных средств для построения систем учета электроэнергии
ЭлектроУчет
Р У К О В О Д С Т В О ПО Э К С П Л У А Т А Ц И И
на __ листах
г. Киев
2009 г.
АННОТАЦИЯ
Данный документ описывает действия по установке и эксплуатации комплекса программных средств для построения систем учета энергоносителей ЭлектроУчет (далее – комплекс). Комплекс может быть использован для построения различных систем коммерческого, технического учета и диспетчерского контроля для объектов энергопотребления, энергогенерирующих и распределительных предприятий. Комплекс может использоваться самостоятельно либо в составе другой системы.
СОДЕРЖАНИЕ
1. Назначение
2. Условия применения
3. Установка системы
3.1 Файл-лицензия Electro. ini
3.2. Установка программ сторонних производителей.
3.2.1 Электронные таблицы MS Office Excel
3.2.2 Сервер Базы Данных
3.3. Установка комплекта ПО ЭлектроУчет
3.3.1. Перенос файлов ЭлектроУчет на целевой компьютер
3.3.2 Первый запуск ЭлектроУчет
3.3.3 Подключение и настройка опроса устройств
4. Настройка компонент комплекса ЭлектроУчет
4.1 RepCNF – редактор шаблонов и генератор отчетов
4.1.1 Дополнительные возможности RepCNF
4.1.2 Замечания и рекомендации по использованию RepCNF
4.2 RepGen.exe – пакетный генератор отчетов
4.3 XmlGen.exe - Пакетный исполнитель заданий
4.3.1 Генерация макетов
4.4. Mak2Xml.exe – конвертор макетов
4.5. LGXml2Xml.exe – конвертор форматов
4.6. ChkData.exe – проверка полноты БД Electro
5. Конфигуратор Электро
6. Настройка внешних СУБД
6.1. Общая информация.
6.2. Настройка ODBC-интерфейса СУБД
6.2.1. Особенности работы с СУБД FireBird (SQL=FIREBIRD)
6.2.2. Работа системы с СУБД Microsoft SQL Server (SQL=MSSQL)
1. Назначение
Комплекс ЭлектроУчет предназначен для построения различных систем коммерческого, технического учета и диспетчерского контроля для объектов энергопотребления, энергогенерирующих и распределительных предприятий.
Комплекс также может быть использован для построения интегрированных систем учета различных типов энергоресурсов (электроэнергия, вода, газ, тепло и др.) при наличии в составе системы модулей опроса соответствующих устройств.
2. Условия применения
Комплекс функционирует под управлением операционной системы Windows NT, Windows XP, Windows 2000, Windows2003 Server. Минимальные требования к аппаратному обеспечению: IBMPC-совместимый компьютер с частотой процессора не ниже 400 МГц и обьемом оперативной пямяти не менее 96 МБ. Требуемый обьем на жеском диске – 10МБ для программ комплекса и 100МБ и более (в зависимости от конфигурации) для файлов базы данных.
Отдельная версия комплекса функционирует под управлением операционной системы Linux. В данный документ описание linux-версии не входит.
3. Установка системы
В процессе установки системы можно условно выделить несколько этапов:
- получение файла-лицензии Electro. ini с параметрами настройки и ограничениями по использованию системы (тип SQL-сервера, максимальное количество устройств и их тип, состав дополнительных приложений системы);
- установка и настройка программного обеспечения сторонних производителей, необходимого для работы системы ЭлектроУчет (в частности, используемого SQL-сервера);
- установка комплекта программного обеспечения ЭлектроУчет и начальный запуск;
- подключение и настройка опроса устройств;
- настройка отдельных компонент комплекса ЭлектроУчет (Генератор Отчетов; подсистема автоматического опроса; подсистема оповещения об аварийных событиях и др.)
- опытная эксплуатация и оптимизация производительности комплекса ЭлектроУчет.
Комплекс ЭлектроУчет распространяется на основании Лицензионного Соглашения, в котором оговорены права Покупателя на использование комплекса ЭлектроУчет на месте установки. Частью лицензионного соглашения является файл Electro. ini, размещаемый в системном каталоге используемой операционной системы.
Демонстрационная версия комплекса ЭлектроУчет не требует наличия файла-лицензии electro. ini так как вся необходимая информация содержится внутри демонстрационной версии библиотеки Ядра electro. dll.
Пример файла-лицензии Electro. ini:
;*** Файл-лицензия ***
; !!! РЕДАКТИРОВАНИЕ ЗАПРЕЩЕНО, ФАЙЛ ЗАЩИЩЕН ЦИФРОВОЙ ПОДПИСЬЮ!!!
;
; общая информация о лицензии
LICENZ=32 OWN="Тестовая версия CorHost" TMLIM=2009/01 DEV=20 OBJ=5000 NRS=0
;
; конфигурация локальной базы данных
LOCALDB=CorusDB SQL=SQLITE FLAG=3
;
; список фиксированных устройств
DEV=1 SERIAL=SLB_EP25208 TYPE=33 NAME="Вычислитель SEVC-D"
DEV=2 SERIAL=SLB_SC TYPE=32 NAME="Вычислитель Corus"
;
; цифровая подпись
SIGN=
В секции общая информация о лицензии указан номер Лицензии, наименовании Владельца Лицензии (OWN), ограничение по времени использования (TMLIM), максимальное количество устройств (DEV) и максимальное количество параметров по всем устройствам (OBJ).
Значение TMLIM=2009/01 запрещает запись в БД информацию с метками времени, превышающими указанную дату (01 января 2009г). При этом комплекс продолжает функционировать, вне зависимости от текущего времени компьютера. Значение TMLIM=0 устанавливает неограниченное время использования.
Значение DEV=20 устанавливает максимальное количество устройств в конфигурации комплекса. При превышении установленного лимита необходимо удалить из конфигурации комплекса лишние устройства либо заказать у поставщика комплекса обновление Лицензии.
Значение OBJ=5000 устанавливает максимальное суммарное по всем устройствам количество параметров. Значение данного ключа устанавливается поставщиком Лицензии исходя из максимального количества устройств для данной Лицензии и среднего количества параметров в одном устройстве.
Секция конфигурация локальной базы данных обычно содержит стандартную строку, в частности указывается использование СУБД SQLite (http://www.sqlite.org). Коды СУБД встроены в Ядро комплекса electro. dll. СУБД SQLite бесплатна, компактна, надежна и требует минимальных действий по администрированию. Однако в некоторых случаях (количество устройств более 40-50, особые пожелания заказчика) можно использовать другую СУБД (MS SQL, MySQL, Oracle и др). В этом случае необходимо заказать у поставщика комплекса обновление Лицензии. Это можно сделать в процессе развития системы – имеется возможность перенести базы данных конфигурации и измерений под новую СУБД.
В секции список фиксированных устройств содержится начальный список устройств. Эти устройства принудительно заносятся в БД конфигурации при запуске комплекса.
Ключ SERIAL содержит уникальный идентификатор устройства, составленный на основе его серийного номера.
Ключ TYPE указывает тип устройства.
В процессе настройки и работы комплекса разрешается добавлять новые устройства тип которых упомянут в списке фиксированных устройств.
ВАЖНО! Комплекс проверяет условие – в текущем списке устройств не менее половины должны быть упомянуты в списке фиксированных устройств. Это является элементом защиты от несанкционированного использования Лицензии. В случае возникновения проблемы следует обратиться к поставщику Лицензии.
В случае наличия в лицензии ограничения TMLIM условие «половина списка» не проверяется. Это дает возможность пользователю начать полноценную работу с комплексом и впоследствии запросить у поставщика полноценную Лицензию.
Файл-лицензию Electro. ini запрещено редактировать. При запуске комплекс проверяет цифровую подпись и в случае ее нарушения прекращает работу («ошибка инициализации библиотеки electro.dll»). Если вы предполагаете наличие данной проблемы, восстановите файл-лицензию из архивной копии и повторно запустите комплекс.
Для работы комплекса ЭлектроУчет необходима установка и настройка программ сторонних производителей. Эти программы не входят в комплект поставки ЭлектроУчет и приобретаются Покупателем отдельно.
3.2.1 Электронные таблицы MS Office Excel
Штатные компоненты РедакторОтчетов (RepCnf.exe) и ГенераторОтчетов (RepGen.exe) комплекса ЭлектроУчет функционируют совместно с MS Excel версии не ниже 8 (MS Office2000). Данный продукт должен быть установлен на компьютере, на котором функционируют указанные компоненты.
3.2.2 Сервер Базы Данных
Комплекс ЭлектроУчет хранит информацию под управлением внешней СУБД. Исключение составляет вариант с использованием встроенной СУБД SQLite. В этом случае коды СУБД SQLite встроены в библиотеку Ядра electro. dll.
Тип используемой СУБД определяется в Лицензионном Соглашении. Работа комплекса проверена с СУБД MS SQL Server, MySQL, PostgreSQL, Interbase, Sybase, Oracle, Informix. Выбор СУБД осуществляется исходя из технико-экономических требований.
Данный документ не содержит инструкций по установке и эксплуатации конкретной СУБД. Необходимая информация может быть получена из документации конкретной СУБД и дополнительной документации из комплекта поставки ЭлектроУчет.
Встроенная в Ядро electro.dll СУБД SQLite не требует установки и дополнительного обслуживания.
Комплект ПО Electro поставляется покупателю в виде набора файлов на компакт-диске либо на другом оговоренном в Соглашении носителе. Структура каталогов дистрибутива соответствует целевой структуре каталогов. Таким образом, первый шаг установки ЭлектроУчет заключается в копировании дерева каталогов с дистрибутива.
3.3.1. Перенос файлов ЭлектроУчет на целевой компьютер
Скопируйте папку ELECTRO со всем содержимым с носителя дистрибутива в корень диска C: целевого компьютера. Возможна установка ЭлектроУчет и в другое место – см. п. Х.Х – однако сейчас примем, что файлы скопированы в папку C:\Electro. Содержимое папки следующее (возможны отличия в конкретной поставке):
\Doc - папка с штатной и дополнительной документацией
\System32 - папка с файлами которые необходимо перенести в системный каталог WINNT\System32:
Electro.dll - библиотека Ядра ЭлектроУчет. Файлы Electro_sqlite.dll, Electro_mysql.dll, Electro_odbc.dll являются вариантами Ядра предназначенными для работы с различными типами СУБД. Необходимо выбрать требуемый вариант и переименовать в «Electro.dll»
Electro.ini - файл-лицензия.
Libxml2.dll - библиотека работы с XML-форматами.
И другие библиотеки, в частности реализующие протоколы обмена с устройствами.
DBView.exe - программа просмотра БД
RepCnf.exe - Редактор/Генератор отчетов
RepGen.exe - Генератор отчетов
AppName.exe - Оболочка/конфигуратор
ElectroXML.exe - XML-консоль
GetDev.exe - консоль опроса устройств
ElectroHost.exe - Диспетчер/Сервер удаленных вызовов системы Electro.
3.3.2 Первый запуск ЭлектроУчет
После формирования папки C:\Electro и переноса необходимых библиотек в системную папку system32 возможно понадобится некоторая настройка используемой СУБД (создание баз данных и прав доступа к ним и т. п.). Эти действия описаны в дополнительной документации.
После этого комплекс ЭлектроУчет в принципе готов к первому запуску. Запустите приложение DBView. Автоматически будет активизирована библиотека ядра electro. dll и включится механизм запуска серверного приложения ElectroHost, которое проверяет конфигурацию системы и при необходимости инициирует дополнительные действия по созданию дополнительных папок, разметки таблиц Базы Данных и прочее.
Все эти действия выполняются автоматически и, при отсутствии внештатных ситуаций, приводят к полному развертыванию комплекса ЭлектроУчет и появлению на экране экранной формы запущенного приложения (в нашем случае DBView):
В противном случае на экране появляется окно вида
либо не то и не другое; что свидетельствует о несколько больших неприятностях. В любом случае следует изучить содержимое папки electro/Logs – в этом месте содержатся всевозможные журналы событий.
При успешном развертывании ЭлектроУчет в папке electro будут в общем случае автоматически созданы дополнительные папки:
Logs - для журналов событий
Settings - для файлов настроек
Reports - для результатов работы ГенератораОтчетов
Xml - для файлов XML-консоли
WebRoot - для файлов встроенного Вэб-сервера
Patterns - для временных файлов ГенератораОтчетов
DataArc - для файлов данных системы архивирования
3.3.3 Подключение и настройка опроса устройств
После успешной установки системы запустите программу AppName.exe зарегистрируйтесь как Supervisor (Пользователи à Регистрация) (начальное значение пароля - 'best4you') и перейдите в Конфигуратор (Настройки à Конфигуратор).
ШАГ 1.
Выберите закладку Модемы и определите новое устройство передачи данных (правый щелчек на [пустом] списке устройств). Предположим, для определенности, что к компьютеру через оптопорт подключен счетчик Elvin (протокол МЭК 1107, начальная скорость 300бод).
Вводим произвольное наименование (Нуль-модем COM1), выбираем тип модема (NULL modem).
Параметры «Простой до разъединения» и «Max продолжительность» (ограничения на длительность сеанса связи) ставим в 0. Выбираем номер COM-порта (1), скорость (300) и управление потоком данных (NONE).
В целях отладки протокол обмена с устройством можно записать в файл. Укажите полное имя файла для записи протокола обмена и отметьте чекбокс log2file. Не рекомендуется оставлять отметку после ввода в промышленную эксплуатацию (размер лог-файла будет неограниченно увеличиваться).
Сохраним изменения и перейдем к следующему шагу.
ШАГ 2.
Выберите закладку Соединения и создайте новое соединение (правый щелчек на [пустом] списке соединений). При заполнении свойств соединения следует руководствоваться документом DllOptions.doc. В частности, для счетчиков Elvin необходимо указать драйвер SLB (это библиотека SLB.dll). Введите произвольное наименование соединения (Опрос Elvin), выберите модем (из ранее созданого списка на Шаге 1):
Строка описания канала передачи данных предназначена для указания дополнительных настроек (ключей) соединения. В данном случае ее можно оставить пустой, однако для примера укажем ключи «RESP=3000 ECHO=0» (см. описание в DllOptions.doc).
Сохраним изменения и перейдем к следующему шагу.
ШАГ 3.
Выберите закладку Устройства. Список изначально содержит устройства, определенные в лицензии Electro.ini. Выберите желаемое устройство либо создайте новое (правый щелчок на списке устройств).
Деактивация флага Активно сигнализирует о том, что данное устройство временно снято с эксплуатации. В частности, все попытки опроса устройства через функцию ElectroXML() (приложения ElectroXML.exe, XmlGen.exe) будут игнорироваться (имитируется успешный код завершения). Состояние флага не влияет на работу программы ручного опроса GetDev.exe – она честно будет пытаться связаться с устройством.
Введите произвольное наименование устройства (Счетчик Elvin в лаборатории), выберите соединение (из ранее созданого списка на Шаге 2). В окне, ниже выбранного соединения, указываются дополнительные ключи настройки связи с устройством (см. DllOptions.doc). В примере указан ключ DEVADDR=01 (адрес устройства по протоколу МЭК 1107), однако оставьте окно пустым либо укажите правильный адрес!
Обратите внимание – серийный номер для нового устройства имеет вид NEWDEV_nnn. Это «магический» код, который при первой возможности будет автоматически заменен на реальный серийный номер опрашиваемого устройства.
Остальные поля пока не трогаем (их назначение описаны в документе ElectroFAQ.doc).
Сохраним изменения и перейдем к следующему шагу.
ШАГ 4.
Запустите программу GetDev.exe (иконка «Получение данных» в секции «Данные» оболочки Электро), выберите соединение (Опрос Elvin) и устройство (Счетчик Elvin в лаборатории), нажмите Open.
Сработало важное свойство системы Electro – обнаружение новых устройств. Драйверу сообщалось об устройстве с серийным номером 'any' - см. п.6.3. Драйвер же обнаружил устройство с серийным номером SIM_ELV0013.
Вернитесь в AppName.exe и в закладке Устройства доопределите для нового устройства настройку режима:
Снова запустите GetDev.exe, но уже для устройства SIM_ELV0013:
Выполнился опрос устройства, в результате чего в конфигурацию системы были автоматически занесены тэги устройства SIM_ELV0013.
Удостовериться в этом можно вновь запустив Конфируратор, в закладке Обьекты вы обнаружите
4. Настройка компонент комплекса ЭлектроУчет
Программа RepCNF совмещает два режима работы – (1) создание/редактирование шаблона отчета и (2) генерация/просмотр отчета. Доступность режимов определяется правами пользователя.
Принцип работы программы основан на OLE-автоматизации MS Excel. Пользователю доступны все возможности Excel (xls-документ является как бы частью программы RepCNF), при этом обеспечивается привязка ячеек электронной таблицы к БД Электро и сценарий работы генератора отчетов.
Предупреждение. Ответственность за отсутствие лицензии на программу MS Excel возлагается на пользователя.
Для работы с RepCNF важно уяснить следующую терминологию.
Xls-документ – произвольный документ (файл) программы MS Excel.
Шаблон отчета (далее – Шаблон) – это xls-документ, импортированный в среду программы RepCNF и содержащий заготовку отчетной формы с привязками к БД Электро. Шаблон хранится в БД ElectroCNF. Преобразование шаблона (внутреннее хранение) в xls-документ (файл) и обратно обеспечивается командами FileàExport и FileàImport. Шаблон доступен для редактирования (при условии наличия соответствующего полномочия у пользователя) и генерации Отчета.
Отчет – это результат исполнения Шаблона. Вне зависимости от полномочий пользователя отчет доступен только для просмотра и печати. Отчет также можно сохранить в БД ElectroCNF командой PrintàPaperSave.
В зависимости от текущего состояния программы RepCNF (полномочия пользователя; наличие и тип документа (Шаблон/Отчет)) пользователю доступен определенный набор команд. Запрещенные в данном состоянии команды затенены.
Внешний вид экранной формы при запуске программы RepCNF следующий:
Пользователю необходимо нажать на кнопку LogON для выполнения регистрации. В зависимости от полномочий пользователя ему будет доступны все режимы работы либо только генерация/просмотр отчетов.
ВНИМАНИЕ. При первоначальной установке системы создается единственный пользователь – Supervisor (все полномочия) с паролем best4you.
После регистрации пользователю доступна кнопка Open (дублирует пункт меню FileàOpen) для открытия либо создания нового шаблона отчета:
|
Из за большого объема этот материал размещен на нескольких страницах:
1 2 3 4 |
