Установка Tagnet модуля ввода/вывода под Windows

Подготовка к установке

1. Проверка наличия установленной Java в 64 разрядности

Для этого выполнить команду:

> java -version

При установленной Java будет выдана схожая информация:

java version "1.8.0_231"
Java(TM) SE Runtime Environment (build 1.8.0_231-b11)
Java HotSpot(TM) 64-Bit Server VM (build 25.231-b11, mixed mode)

Если Java не установлена, необходимо скачать дистрибутив и установить.

2. Создание папок для сервера

Создать папку с именем сервера

Например:

C:\tagnet\opcua-client

(В последующих примера будем ссылаться на эту папку)

3. Развертывание файлов

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

bin/
config/
core/
doc/
lib/
prop/

Настройка и запуск сервера

1. Настройка параметров запуска

Настроечные параметры находятся в файле:

 bin/setenv.cmd

В этом файле необходимо обязательно выставить следующие параметры, которые зависят от текущего системного окружения:

Параметр SERVICE_NAME - имя создаваемого Windows сервиса

Пример:

 set SERVICE_NAME=TagNet.OPCUA.Server-1

Параметр PR_JVM - путь до Java машины, к файлу jvm.dll

Пример:

set PR_JVM=C:\Program Files\Java\jdk1.8.0_172\jre\bin\server\jvm.dll

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

2. Создание Windows сервиса для автоматического запуска сервера

Для установки модуля как Windows сервиса необходимо зайти в папку bin и запустить скрипт install_service.bat

ВНИМАНИЕ!!! Скрипт должен запускаться с правами администратора, так как он создает в системе новый Windows сервис!

В результате исполнения скрипта будет установлена служба, и в папке bin появится файл утилиты с именем, следующего формата:

<Имя службы>w.exe

где <Имя службы> -это значение переменной SERVICE_NAME

Эта утилита предназначена для управления запуском, настройкой и остановом созданной службы. Помимо этой утилиты запуск и останов сервиса может выполнятся через стандартную оснастку управления сервисами Windows: (запуск оснастки можно запустить из командной строки - services.msc)

3. Запуск сервиса

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

4. Корректировка параметров запуска сервиса

В случае если нужно изменить параметры запуска сервиса (например, размер выделяемой памяти), необходимо откорректировать соответствующие параметры в файле bin\setenv.cmd и выполнить с правами администратора скрипт

> reinstall_service.bat

5. Удаление сервиса

Для удаления сервиса необходимо запустить с правами администратора скрипт bin/uninstall_service.bat

Приложение

Параметры запуска сервиса в файле setenv.cmd

Параметры, которые разрешены для корректировки:

  1. Описание Windows сервиса:
    SERVICE_NAME - имя создаваемого Windows сервиса
    PR_DESCRIPTION - описание создаваемого Windows сервиса

  2. Настройки вывода диагностики сервиса
    PR_LOGPREFIX - префикс имени файла с журнальными сообщениями
    PR_LOGPATH - папка для файлов перенаправленных стандартных выводов
    PR_STDOUTPUT - файл для перенаправления стандартного вывода
    PR_STDERROR - файл для перенаправления стандартного вывода ошибок
    PR_LOGLEVEL - уровень вывода информации

  3. Настройки Java
    PR_JVM - полный или относительный путь к java машине - jvm.dll

  4. Параметры запуска и остановка сервиса
    PR_STARTUP - режим запуска сервиса
    PR_ServiceUser - из под какого аккаунта запускается сервис
    PR_STOPTIMEOUT - пауза перед остановом

  5. Параметры использования ресурсов памяти для JVM
    PR_JVMMS -начальный размер кучи (pool size) MB
    PR_JVMMX - максимальный размер кучи (pool size) MB
    PR_JVMSS - размер стека каждого потока KB