Руководство программиста OPC Tuneller 'Xpert' уководство... · Многие из OPC протоколов базируются на Windows-технологиях:

ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ

ОРС Тунеллер ”Xpert”

OPC Tuneller ”Xpert”

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

на 20 листах

08/2018, Версия 1.0.0

2 \ 20

Оглавление 1 Список принятых сокращений...................................................................................................3 2 Назначение и условия применения..........................................................................................4

2.1. Назначение программы......................................................................................................42.2. Функции программы............................................................................................................42.3. Технические требования.....................................................................................................5

3 Конфигурирование OPC Tuneller “Xpert”..................................................................................63.1. Общая информация............................................................................................................63.2. Настройка серверной части...............................................................................................63.3. Настройки клиентской части..............................................................................................8

3.3.1 Активация приложения...............................................................................................8 3.3.2 Общие сведения.........................................................................................................9 3.3.3 Настройки конфигуратора клиентской части..........................................................12 3.3.4 Добавление сервера................................................................................................13 3.3.5 Удаление сервера.....................................................................................................15

3.4. Логирование......................................................................................................................163.5. Настройка брандмауэра...................................................................................................18

4 Устранение неисправностей...................................................................................................19

ООО «СМИС Эксперт»г. Москва, Каширское шоссе, д. 12 www.smis-expert.com

телефон:эл.почта:

+7 (495) [email protected]

http://www.smis-expert.com/

3 \ 20

1 Список принятых сокращений

DCOM Distributed Component Object Model — это протокол, с помощью которого компоненты программного обеспечения поддерживают связь по сети. Модель DCOM может использовать несколько сетевых транспортов.

HTTP HyperText Transfer Protocol («протокол передачи гипертекста») — протокол прикладного уровня передачи данных (изначально — в виде гипертекстовых документов в формате «HTML», в настоящий момент используется для », в настоящий момент используется для передачи произвольных данных). Основой HTTP является технология «клиент-сервер», то есть предполагается существование потребителей и поставщиков.

OPC Open Platform Communications (ранее англ. OL», в настоящий момент используется для E for Process Control) — семейство программных технологий, предоставляющих единый интерфейс для управления объектами автоматизации и технологическими процессами. Многие из OPC протоколов базируются на Windows-технологиях: OL», в настоящий момент используется для E, ActiveX,COM/DCOM. Такие OPC протоколы, как OPC XML», в настоящий момент используется для DA и OPC UA, являются платформонезависимыми.

OPC DA Data Access — основной и наиболее востребованный стандарт. Описывает набор функций обмена данными в реальном времени с ПЛК, РСУ, ЧМИ, ЧПУ идругими устройствами.

OPC AE Alarms & Events — предоставляет функции уведомления по требованию о различных событиях: аварийные ситуации, действия оператора, информационные сообщения и другие.





4 \ 20

2 Назначение и условия применения

2.1. Назначение программыПрограмма OPC Tuneller ”Xpert” предоставляет сетевой доступ к удаленным OPC-серверам, исключая необходимость конфигурирования DCOM. Обмен данными междусервером и клиентом происходит по стандартам OPC DA 2.05a и OPC AE 1.05.

2.2. Функции программыOPC Tuneller ”Xpert” имеет следующие функции:

• Работа с группами (добавление / удаление / редактирование).• Работа с переменными (добавление / удаление / редактирование).• Получение значений переменных.• Запись значений в переменные.• Шифрование передаваемых данных.• Поддержка множественных подключений.

Сервер (OPCTunellerXpertServer) — специализированный ОРС клиент, устанавливается на хост с запускаемым OPC-сервером, опрашивает его и передает данные далее по HTTP-протоколу.

Клиент (OPCTunellerXpertClient) — устанавливается на удаленный хост, для приёма данных от Сервера по HTTP-протоколу. Регистрирует себя в качестве локального OPC-сервера и предоставляет данные любому локальному OPC-клиенту, через OPC-интерфейсы.




Рисунок 1. Схема прохождения запроса / ответа, между OPC-клиентом иклиентом ивыбранным OPC-клиентом исервером.


5 \ 20

2.3. Технические требованияСовместимость с операционными системами:

• Microsoft Windows Server 2016 / 2012 / 2008 Standart• Microsoft Windows 10 / 7 Professional, Embedded Pro, Embedded Enterprise• Microsoft Windows XP Professional SP3

Минимальные требования:

• Microsoft Windows XP SP3• Intel Core 2 Duo — 2 ГГц или аналогичный• ОЗУ 512 Мб• 50 Мб на жестком диске• Сетевая карта (10/100 Мбит/с)• Мышь PS/2• Порт USB 2.0• Монитор SVGA

Рекомендуемые требования:

• Microsoft Windows 7 Professional / Windows Server 2008 Standart• Intel Core 2 Duo — 3,2 ГГц или аналогичный• ОЗУ 1 Гб• 1 Гб на жестком диске• Сетевая карта (10/100 Мбит/с)• Мышь USB• Порт USB 2.0 и выше• Монитор SVGA

Сведения о связях с другими программными компонентами.

При использовании приложения необходимо, чтобы в системе были развернуты компоненты ОРС (OPC Core Componenets). Требуется для индексации удаленных OPC-серверов.





6 \ 20

3 Конфигурирование OPC Tuneller “Xpert”

3.1. Общая информацияПриложение OPC Tuneller ”Xpert” состоит из нескольких устанавливаемых компонентов:

• OPC Tuneller Xpert Серверная часть• OPC Tuneller Xpert Клиентская часть

Примечание: Рекомендуется добавить все приложения OPC Tuneller Xpert в исключенияпрограммы-антивируса. Запуск конфигуратора клиентской части тунеллера, выполнять справами Администратора.

3.2. Настройка серверной частиВыполняется на хосте с целевым OPC-сервером. Запустите конфигуратор серверной частииз меню Пуск / OPC Tuneller Xpert Конфигурация серверной части. При запускеоткрывается окно с настройками. Рассмотрим подробно их назначение.

Основные

Порт — локальный порт хоста, для взаимодействия с клиентской частьюOPCTunellerXpertClient по HTTP-протоколу. При изменении значения порта, такжеизменяется и правило в брандмауэре Windows для OPCTunellerXpertServer.





7 \ 20

Автозагрузка — задает возможность автозагрузки серверной части. Возможные значения:

• Нет — серверная часть в автозагрузку не добавляется и запускается вручную.• Для текущего пользователя — выполняется автозагрузка только для текущего

пользователя.• Для всех пользователей — выполняется автозагрузка для всех пользователей

системы.

Настройки логирования

Настройки данной группы задают параметры логирования работы сервера. Подробнее проних написано в разделе Логирование. После изменения значений настроек необходимоподтвердить их кнопкой Сохранить. Изменения будут сохранены в файл конфигурацииOPCTunellerXpertServerConfig.ini, расположенного в папке установки серверной части.

Настройки шифрования

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

Шифрование — включение / отключение шифрования данных.

Ключ шифрования — строка символов, в которой содержится пароль в открытом виде, вслучае, если опция шифрования включена. Аналогичный ключ должен быть задан внастройках клиентской части тунеллера, если требуется зашифрованная передача данных.





8 \ 20

3.3. Настройки клиентской части

3.3.1 Активация приложенияЛицензированию подлежит только OPC Tuneller Xpert Клиентская часть. Запустимконфигуратор клиентской части. При первом запуске программа запросит активацию иоткроется окно Активация приложения.

В поле Код сигнатуры отображается строка, по которой будет сгенерирован код активации.

Код сигнатуры необходимо скопировать, нажав на кнопку Копировать в буфер (1) ивключить в запрос на активацию приложения. Запрос на активацию необходимо отправитьпо электронной почте либо сообщить специалисту по установке программы. Послеформирования запроса на активацию и получения лицензионного ключа, его необходимоввести в поле Код активации. Доступна функция вставки из буфера обмена по кнопкеВставить (2) После ввода кода активации нужно нажать на кнопку Активировать (3).

В случае, если код активации введен верно, будет выведено сообщение Активация прошлауспешно! и появится окно с настройками клиентской части. При повторных запускахактивация приложения не требуется.

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





9 \ 20

3.3.2 Общие сведенияДля настройки Клиентской части необходимо с правами Администратора системызапустить программу конфигуратора с OPCTunellerXpertClientConfig.exe

Если запуск выполняется впервые, то на экран будет выведено окно активации программы. Подробнее в справке Активация приложения.

Окно конфигуратора клиентской части можно разделить на следующие элементы:

• Панель меню.• Панель инструментов.• Панель серверов.• Панель свойств.

Панель инструментов

На панели инструментов располагаются следующие кнопки:

Добавить сервер — позволяет добавить удаленный сервер в дерево серверов. При этом на текущем хосте он будет зарегистрирован, как локальный.

Удалить сервер — позволяет удалить удаленный сервер из дерева серверов. При этом на текущем хосте выполняется удаление раннее добавленного локального OPC-

сервера.

Обновить — позволяет обновить дерево серверов.





10 \ 20

Настройка — вызывает окно настроек конфигуратора клиентской части.

Информация — вызывает окно «О программе».

Панель меню

Панель меню дублирует кнопки панели инструментов за исключением подменю Справка / Лицензия. Данная команда позволяет просмотреть информацию об активации приложения и активировать его в случае необходимости.

Панель серверов

На панели серверов расположено дерево серверов.

Корневой узел дерева называется "Удаленные соединения" и имеет следующую структуру:

• Первый уровень вложенности (1) — корень дерева, объединяющий все хосты с требуемыми сетевыми соединениями.

• Второй уровень вложенности (2) — IP-адреса удаленных или локальных хостов, с целевыми OPC-серверами.

• Третий уровень вложенности (3) — добавленные вручную тунеллированные OPC-сервера указанных хостов. По нажатию на данный тип узла на панели свойств, отображаются свойства удаленного сервера.

Есть возможность переименования уже имеющихся серверов. Для этого нужно кликнутьлевой кнопкой мыши по узлу дерева и в режиме редактирования узла задать новое имясервера. В случае, если сервер с таким именем уже имеется, на экран будет выведеносообщение о невозможности переименования. Тунеллированный сервер всегда должениметь префикс — XpertTunneller. Если при ручном редактировании префикс был измененили удален, при сохранении он будет скорректирован автоматически.





11 \ 20

Панель свойств

На панели свойств отображаются свойства выбранного в дереве сервера.

Настройки сервера

Все настройки данной группы недоступны для редактирования и отображают свойства сервера удаленного хоста.

• Наименование (1) — имя удаленного сервера.• Описание (2) — описание удаленного сервера.• Производитель (3) — производитель удаленного сервера.• OPC-клиентом иинтерфейсы (4) — поддерживаемые OPC-интерфейсы удаленного сервера.

Настройки соединения

• Хост (5) — IP-адрес удаленного хоста.• Порт (6) — порт удаленного хоста.• Таймаут соединения (7) — максимальное время ожидания ответа на запросы

клиента.

Настройка портов подписки

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





12 \ 20

Свободный порт будет выбран из заданного диапазона как первый незанятый на локальном хосте.

• Начало диапазона (8) — начальный порт в указанном диапазоне.• Конец диапазона (9) — конечный порт в указанном диапазоне.

Настройка логирования

Подробнее о Настройках логирования (10) в разделе Логирование.

Настройки шифрования

• Шифрование (11) — включение / отключение шифрования данных.

• Ключ шифрования (12) — строка символов, в которой содержится пароль в открытом виде. Пароль активен, только при включённой опции шифрования.

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

3.3.3 Настройки конфигуратора клиентской частиРазберем настройки программы конфигуратора клиентской части. Вызовем их, нажав кнопку Настройки на панели инструментов.





13 \ 20

Настройки по умолчанию

Параметры данной группы применяются в качестве стандартной настройки по умолчанию, при добавления серверов с удаленного хоста.

• Порт (1) — порт удаленного хоста.• Таймаут соединения (2) — максимальное время ожидания ответа сервера.• Маска имени сервера (3) — задает маску имени сервера при добавлении. В значении

маски допустимо использование ключевых слов {ИмяСервера}, {Хост} и {Порт}. При добавлении данные ключевые слова заменятся на соответствующие значения.

Настройка портов подписки

Настройки задают диапазон портов подписки (4) для вновь добавляемых серверов. Приизменении значений изменяется также входящее правило для OPCTunellerXpertClient вБрандмауэре Windows.


Задаваемые настройки логирования (5) по умолчанию. Вновь создаваемые серверы, неимеющие собственных настроек логирования, работают со значениями настроек этойгруппы. Подробнее про эти настройки написано в разделе Логирование.

После изменения значений настроек, нажать на кнопку Сохранить. Изменения будутсохранены в файл конфигурации OPCTunellerXpertClientConfig.ini, расположенный в папкеустановки.

3.3.4 Добавление сервераДля добавления сервера перейдите на узел с IP-адресом целевого хоста. Либо выберитекорневой узел дерева серверов и нажмите Добавить сервер. Откроется окно добавлениясервера. На первой вкладке будут отображены настройки параметров соединения судаленным хостом.





14 \ 20

Настройки соединения

• Хост (1) — IP-адрес удаленного хоста.• Порт (2) — порт удаленного хоста.• Таймаут соединения (3) — максимальное время ожидания ответа сервера.

Последовательность шагов:

1. После настройки параметров соединения нажмите Далее.

• В случае недоступности хоста, будет выведено сообщение об ошибке соединения.

• При положительном ответе хоста, но остановленной серверной частиOPCTunellerXpertServer, будет выведено сообщение об ошибке доступа к HTTP-серверу.

2. Далее отобразится список доступных OPC-серверов удаленного хоста. Выберите чек-боксами ОРС-серверы, доступ к которым необходимо организовать на текущем хосте.

3. Для возврата к настройкам соединения необходимо нажать Назад.

4. Для добавления выбранных серверов необходимо нажать ОК. Выбранные сервера добавятся в качестве локальных OPC-серверов и появятся в дереве, как дочерние узлы выбранного хоста.

• Имя локального OPC-сервера задаётся в соответствии с настройкой Маска имени сервера и в дальнейшем может быть изменено вручную.





15 \ 20

• Если сервер с таким именем существует, к нему будет добавлен постфикс _{i}i}}, где i} – первый незанятый индекс, при добавлении которого к имени сервера, оно будет уникальным.

3.3.5 Удаление сервераПроцедура удаления сервера довольно проста. Выделите его в дереве серверов (2), нажмите на кнопку Удалить сервер (1), подтвердите удаление (3).

Имеется возможности удалить все тунеллированные серверы выбранного хоста. Для этого необходимо выделить хост в дереве серверов, нажать на Удалить сервер и подтвердить удаление.





16 \ 20

3.4. ЛогированиеВ клиентской и серверной частях предусмотрена возможность логирования событий. В каждом из конфигураторов доступна секция типовых настроек логирования.


• Логирование (1) — включено / выключено.• Уровень (2) — уровень детализации логирования. Возможные значения:

◦ INFO — в лог записываются все события (информационные и ошибочные)◦ ERROR — в лог записываются только сообщения об ошибках приложения◦ EXTENDED — производится расширенное логирование.

• Путь к папке с логами (3) — путь к папке, где будут хранится файлы с логами. Название файла с логами в виде OPCTunellerXpertServer_Дата.selogДата.selog, где Дата — дата [YYYY.MM.DD]YYYY.MM.DD] записи события в лог.

В случае, если файл уже существует, событие будет добавлено в конец файла. Еслинастройка выполняется для конфигуратора серверной или клиентской частей, допустимоиспользование маски с ключевыми словами {i}ИмяСервера}, {i}Хост} и {i}Порт}. Если настройкавыполняется для конкретного сервера, использование маски является недопустимым. Самозначение в данном случае уже отображается с учетом маски, заданной в настройкеклиентской части.

Файлы логов имеют расширение *.selog и представляют собой текстовые файлы сразделителями "|".

Просмотр может быть выполнен любым текстовым редактором или входящей в дистрибутивутилитой OPCTunellerXpertLogViewer.exe





17 \ 20

Утилита OPCTunellerXpertLogView позволяет быстро фильтровать лог-файл по Типу (1)зарегистрированного события, Времени (2), Клиенту (3), а так же по Содержимомусообщения (4).





18 \ 20

3.5. Настройка брандмауэра

При установке сервера по умолчанию задан диапазон TCP-портов 20888-клиентом и20899, значениякоторого можно менять. Для клиента по умолчанию используется диапазон TCP-портовподписки 1900-клиентом и1920. Порты 0-клиентом и1023 зарезервированы и недоступны для выбора. Приизменении настроек портов в конфигураторе сервера или клиента, автоматически создаютсяразрешающие правила брандмауэра Windows для входящих соединений.

Для работы тунеллера должны быть активны входящие правила брандмауэра:

• На хосте с OPCTunellerXpertServer, открыт входящий порт указанный в настройках сервера (20888-клиентом и20899).

• На хосте с OPCTunellerXpertClient, открыт диапазон входящих портов подписки (1900-клиентом и1920).

Также в брандмауэре Windows необходимо разрешить запросы входящего эха ICMP.Обычно используется для устранения неполадок, например, при проверке связи с

компьютером. Запросы этого типа разрешаются автоматически, если TCP-порт 445 включен.





19 \ 20

4 Устранение неисправностейБольшинство неисправностей при работе с программой OPC Tuneller “Xpert” можно решить,описанными ниже методами решения проблем.

При анализе неисправностей рекомендуем включить на сервере и клиенте режимлогирования EXTENDED. А также использовать утилиту просмотра и сортировки логов

OPCTunellerXpertLogViewer.exe

Удаленный клиент не отвечает на запросы сервера

1. Зависание или выгрузка клиентской части тунеллера из-за системного сбоя:

◦ В лог-файле OPCTunellerXpertServer найдена ошибка "| error | TOPCDataCallback.OnDataChange, невозможно подключиться к удаленному хосту, FRemoteHost=XXX.XXX.XXX.XXX, FRemotePort=1900".

◦ На хосте с клиентской частью выполнить Диспетчер задач > отсутствует или не активен процесс OPCTunellerXpertCliet > Завершить процесс > Запустить OPCTunellerXpertCliet заново.

2. Порты подписки на клиентской стороне заблокированы правилами брандмауэра Windows:

◦ На серверной стороне проверить входящие правила открытия порта сервера.

◦ На клиентской стороне проверить входящие правила открытия портов подписки.

Не индексируются ОРС сервера, удаленно и локально

1. На всех хостах с клиентами и серверами, должен быть установлен пакет OPC Core Components:

◦ Доступен в качестве компонента, при установке OPCTunellerXpert начиная с версии 1.1.1.1.

◦ Последняя версия пакета доступна для скачивания, после регистрации на официальном сайте OPC Foundation.

Не удается открыть конфигурацию клиента

1. Попытка запуска ОРСTunellerXpertClientConfig с правами обычного пользователяWindows. Устраните неисправность запуском конфигуратора с правамиАдминистратора.





https://opcfoundation.org/developer-tools/samples-and-tools-classic/core-components/

20 \ 20

Невозможно установить удаленное соединение с хостом

1. Удаленный хост доступен, но не запущена Серверная часть тунеллера. Необходимовыбрать

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

1. Используемый клиент запущен в демонстрационном режиме. Дляполнофункциональной работы тунеллера необходимо активировать лицензию.

Удаленный сервер не работает в асинхронном режиме

1. Проверьте локальным клиентом, что сервер работает в асинхронном режиме.

2. Проверьте открытость портов тунеллера, как со стороны клиента, так и сервера.

3. Измените способ чтения на синхронный режим.

Принимаемые переменные имеют bad quali}ty

1. Проверьте локальным клиентом, что quality переменных также не имеет плохоезначение.

2. Используя метод GetItemProperties прочитать все свойства переменной, в том числеи quality.

3. Проверить, что в синхронном режиме, quality также имеет плохое значение, иначеэто ошибка асинхронного режима.

4. Проверить порты и запущенные процессы тунеллера.





Documents

Руководство программиста OPC Tuneller 'Xpert' уководство... · Многие из OPC протоколов базируются на Windows-технологиях: