Обновление и удаление
Переход с версии 2.5
ВНИМАНИЕ: установщик Сервера версии 2.6 пока не опубликован (смотрите Загрузка); пока его нет, переход выполнить нельзя. Порядок ниже — порядок установки обоих пакетов версии 2.6, как он задуман; на Windows он еще не проверялся. Прежде чем выполнять его на работающем объекте, уточните в описании выпуска или в ООО «Телеконтроль» (mail@telecontrol.ru), что он подтвержден.
Версии 2.5 и ранее устанавливали один процесс — службу Telecontrol SCADA
Server — и хранили его данные в папках Configuration, History и
FileSystem внутри %ProgramData%\Telecontrol\SCADA Server. Команда
scada-setup migrate переносит эти данные в процессы версии 2.6:
| Данные версии 2.5 | Куда копируются |
|---|---|
Конфигурация Configuration\configuration.sqlite3 |
config\Configuration |
Пароли пользователей Configuration\password.dat |
Туда же, рядом с конфигурацией |
Архивы History |
historian\History |
Файлы мнемосхем FileSystem |
filestore\FileSystem |
Все пути указаны относительно %ProgramData%\Telecontrol\SCADA Server; если в
server.json версии 2.5 были заданы другие папки, команда берет их оттуда.
Конфигурация копируется только в scada-config: он передает ее процессам
протокольного уровня и scada-historian (список исторических БД и назначение
объектов), а scada-proxy читает у него имена и пароли пользователей Клиента.
В БД scada-filesystem (filestore\Configuration) конфигурация не
переносится: этому процессу нужна только служебная учетная запись svc, и
apply оставляет в его БД только ее.
Папки версии 2.5 только читаются: команда ничего в них не изменяет и не удаляет. Это важно, потому что при первом запуске процессы 2.6 преобразуют свои копии в новый формат, после которого версия 2.5 работать с ними уже не сможет. Удалите старые папки сами, когда убедитесь, что обновленная система работает.
Проверьте план до установки версии 2.6. Переход удаляет службу версии
2.5, а пакет Клиента версии 2.6 — и саму программу 2.5; то же, что мешает
переходу (смотрите список ниже), исправляется только в версии 2.5. Поэтому
сначала проверьте план программой scada-setup, распакованной из пакета
Сервера 2.6 без установки.
Версия 2.6 устанавливается двумя пакетами, и их порядок важен. Пакет
Сервера scada-server-<версия>.msi (все процессы Сервера и scada-setup)
устанавливается рядом с версией 2.5 и ничего из нее не удаляет. Пакет Клиента
telecontrol-scada-<версия>.msi (Клиент и документация) — обновление той
программы, которую устанавливал выпуск 2.5: он удаляет программу версии 2.5.
Поэтому сначала устанавливается пакет Сервера и переносятся данные (шаги 5
и 6), а пакет Клиента — только после этого (шаг 7).
Порядок перехода — на компьютере, где работал Сервер 2.5, в командной строке с правами администратора:
- Получите лицензию версии 2.6 (файл
license.json) в ООО «Телеконтроль» и положите ее в%ProgramData%\Telecontrol\SCADA Server\license.json. Аппаратный ключ HASP или Guardant версией 2.6 не используется: ООО «Телеконтроль» обменивает его на лицензию — смотрите Обмен аппаратного ключа. - Сделайте резервную копию всей папки
%ProgramData%\Telecontrol\SCADA Server. -
Распакуйте пакет Сервера версии 2.6 во временную папку — он при этом не устанавливается, и Сервер 2.5 продолжает работать — и найдите в ней
scada-setup.exe:msiexec /a scada-server-<версия>.msi /qb TARGETDIR=C:\scada-2.6-setup dir /s /b C:\scada-2.6-setup\scada-setup.exe -
Посмотрите план перехода распакованной программой, указав полный путь, который вывела команда
dir, и процессы этого компьютера (команда ничего не меняет):"<путь к распакованному scada-setup.exe>" migrate --tiers config,historian,filesystem,iec104,proxyВ
--tiersперечислите, кромеconfig,historian,filesystemиproxy, процесс протокольного уровня для каждого протокола, по которому работают устройства версии 2.5 (в примере — МЭК 60870-5-104,iec104; для MODBUS —modbus, для МЭК 61850 —iec61850). Если в конфигурации версии 2.5 есть включенные связи или устройства протокола, процесс которого не указан, план предупреждает об этом строкойWARNING: … will not run the '<процесс>' process: конфигурация будет перенесена, но данные с этих устройств собираться не будут, если процесс не работает на другом компьютере объекта.Она перечисляет, что и куда будет скопировано, сколько места для этого нужно, какие настройки версии 2.5 не переносятся и, под заголовком
Cannot migrate, что мешает переходу. Исправьте это в версии 2.5 и повторите команду, пока список не станет пустым. Затем папкуC:\scada-2.6-setupможно удалить.Обычно проверка выполняется, пока Сервер 2.5 работает. Если в списке
Cannot migrateесть строкаCan't read the 2.5 configuration database … stop the 2.5 service and run the migration again, конфигурационную БД, скорее всего, не дал прочитать работающий Сервер 2.5: остановите службу Telecontrol SCADA Server (Панель управления — Службы), повторите проверку и затем снова запустите службу. -
Остановите службу Telecontrol SCADA Server (Панель управления — Службы) и установите пакет Сервера версии 2.6:
msiexec /i scada-server-<версия>.msi /qn /norestart /l*v install.logПакет устанавливается в ту же папку
C:\Program Files\Telecontrol SCADA, что и версия 2.5, поэтому служба версии 2.5 на это время должна быть остановлена. Программа и данные версии 2.5 остаются на месте, служба остается зарегистрированной — ее удалит следующий шаг. -
Выполните переход с теми же
--tiers, что и в шаге 4:"C:\Program Files\Telecontrol SCADA\bin\scada-setup.exe" migrate --execute --tiers config,historian,filesystem,iec104,proxy --svc-password <пароль> --root-password <пароль root>Команда еще раз проверяет план, останавливает и удаляет службу Telecontrol SCADA Server, если она еще осталась, копирует данные (строки
Copied …) и затем выполняетscada-setup apply: создает файлы параметров и, если его еще нет, сертификат Сервера, регистрирует и запускает службы процессов. Пароли пользователей переносятся, а парольrootверсии 2.5 — и заданный параметромsecurity.rootPassword, и измененный из Клиента — при первом запуске процессов 2.6 заменяется паролем root из--root-password. -
Только после шага 6 установите на этом же компьютере пакет Клиента версии 2.6:
msiexec /i telecontrol-scada-<версия>.msi /qn /norestart /l*v install.logОн удаляет программу версии 2.5 (из Программ и компонентов исчезает программа ОИК Телеконтроль версии 2.5) и устанавливает Клиент 2.6. Если Клиент на этом компьютере не нужен, удалите пиктограмму Клиент с рабочего стола, но пакет установите: иначе программа версии 2.5 остается установленной. Затем проверьте службы:
"C:\Program Files\Telecontrol SCADA\bin\scada-setup.exe" status. Если какой-то процесс не запускается и в его журнале сказано, что не найден файл, восстановите пакет Сервера командойmsiexec /fa scada-server-<версия>.msiи повторитеstatus. - Установите Клиент версии 2.6 на каждом рабочем месте: Клиент 2.6 отображает мнемосхемы своим модулем отображения (смотрите Отображение мнемосхем). Работа Клиента версии 2.5 с Сервером 2.6 не проверялась.
- Подключитесь Клиентом (порт 2000, как и раньше) под учетной записью пользователя и проверьте объекты, архивы и мнемосхемы.
Если migrate --execute завершилась ошибкой:
- после того, как скопировала все данные (в выводе есть строка
Copiedдля каждой строки плана) — не повторяйтеmigrate: она откажется, потому что папки назначения уже существуют. Устраните причину ошибки и завершите переход командойapplyс теми же--tiersи паролями; - на середине копирования — удалите созданные ею папки
config,proxy,historianиfilestoreв%ProgramData%\Telecontrol\SCADA Server(папки версии 2.5Configuration,HistoryиFileSystemне трогайте) и повторитеmigrate --execute.
Переход не выполняется, а команда объясняет причину, если:
- конфигурация версии 2.5 хранится не в SQLite (например, в PostgreSQL) — перенесите ее в SQLite утилитой администрирования версии 2.5 (ее можно получить в ООО «Телеконтроль»);
- в версии 2.5 есть пользователь с идентификатором 100 — он занят служебной
учетной записью
svc. Создайте в версии 2.5 такого же пользователя под другим именем, удалите старого и повторите проверку; - конфигурационную БД версии 2.5 не удалось прочитать
(
Can't read the 2.5 configuration database …) — остановите службу Telecontrol SCADA Server версии 2.5 и повторите команду; - на этом компьютере не выбран процесс
config; - данные уже были перенесены (папки назначения существуют — команда никогда их не перезаписывает);
- на диске недостаточно места.
Параметры --from <папка> (папка с server.json версии 2.5, если это не
%ProgramData%\Telecontrol\SCADA Server) и --from-exe-dir <папка> (папка
программы версии 2.5 — нужна, только если server.json не задавал папку
данных и она находилась рядом с программой) используются редко.
Если в версии 2.5 были включены клиент OPC или интеграция с ОИК Видикон, в
версии 2.6 это отдельные процессы scada-opc и scada-vidicon: лицензия
должна их включать. Команда migrate напоминает об этом в списке непереносимых
настроек.
Обмен аппаратного ключа
Версия 2.6 не читает ключ Guardant или HASP: ООО «Телеконтроль» обменивает его на подписанную лицензию. План переноса (шаг 4) лицензии не требует, а его примечания заканчиваются строкой запроса, например:
TIERS=config,historian,filesystem,iec104,proxy
Пришлите эту строку в ООО «Телеконтроль» вместе с серийным номером
аппаратного ключа и получите долгосрочный license.json на эти процессы.
Строка перечисляет все, что работало в Сервере версии 2.5, — config,
historian и proxy, filesystem, если было включено файловое хранилище,
процесс для каждого протокола, по которому работают устройства версии 2.5, и
opc и vidicon, если были включены клиент OPC или интеграция с ОИК
Видикон, — а также все процессы, указанные в --tiers. Одна лицензия
действует на всех компьютерах объекта, поэтому строка называет процессы
объекта, а не только этого компьютера.
Возврат к версии 2.5
Если после перехода Сервер 2.6 не работает (например, его службы не
запускаются), вернуть версию 2.5 можно, но не установкой поверх:
установщик 2.5.7 отказывается устанавливаться, пока установлен пакет
Клиента более новой версии (сообщение A later version of ОИК Телеконтроль is already
installed), а служба Telecontrol SCADA Server версии 2.5 уже удалена командой
migrate --execute. На том же компьютере, в командной строке с правами
администратора:
-
Удалите оба пакета версии 2.6 в Панели управления — Программы и компоненты (издатель обоих — ООО Телеконтроль): сначала программу ОИК Телеконтроль — Сервер, затем программу ОИК Телеконтроль версии 2.6. То же командами:
msiexec /x scada-server-<версия>.msi /qn /norestart /l*v uninstall-server.log msiexec /x telecontrol-scada-<версия>.msi /qn /norestart /l*v uninstall-client.logКоманде
msiexec /xнужен файл того самого пакета, который установлен; если его нет, удаляйте через Панель управления. Пакет Сервера сам останавливает и удаляет службы версии 2.6, а данные в%ProgramData%\Telecontrol\SCADA Serverоставляет (смотрите Удаление Сервера).Если переход остановился до шага 7 и в списке программ еще есть программа ОИК Телеконтроль версии 2.5, удалите только пакет ОИК Телеконтроль — Сервер и, прежде чем продолжать, узнайте порядок возврата в ООО «Телеконтроль» (mail@telecontrol.ru): такой возврат не проверялся.
- Установите выпуск 2.5.7 (
telecontrol-scada-2.5.7.msiсо страницы выпусков) так же, как устанавливали версию 2.5, и подключите аппаратный ключ HASP или Guardant. - На каждом рабочем месте, куда при переходе был установлен пакет версии 2.6 (шаг 8 выше), удалите программу ОИК Телеконтроль в Панели управления — Программы и компоненты и установите Клиент выпуска 2.5.7 так же, как он был установлен раньше. Установщик 2.5.7 и на рабочем месте отказывается устанавливаться поверх версии 2.6.
- Проверьте, что служба Telecontrol SCADA Server работает, и подключитесь Клиентом версии 2.5.
Папки версии 2.5 Configuration, History и FileSystem команда migrate
не изменяла, поэтому Сервер 2.5 продолжит работу с данными на момент
перехода: изменения конфигурации и архивы, накопленные версией 2.6, в
версию 2.5 не переносятся. Если папки версии 2.5 уже удалены, верните их из
резервной копии, сделанной перед переходом. Папки процессов 2.6 (config,
proxy, historian, filestore и др.) и файл лицензии 2.6 license.json
версии 2.5 не нужны; удалите их, когда убедитесь, что они больше не понадобятся.
Возврат после неудачного обновления
То же относится к обновлению в пределах версии 2.6 (до более новой 2.6.x):
установщик отказывается ставить более старую версию поверх новой (сообщение
A later version of ОИК Телеконтроль — Сервер is already installed), а восстановление
резервной копии на том же компьютере лишь возвращает данные под
ту версию, которая установлена сейчас. Поэтому перед каждым обновлением
делайте резервную копию каждого компьютера Сервера: без нее пути назад нет.
Чтобы вернуться к прежней версии, на каждом компьютере Сервера, который успели обновить, в командной строке с правами администратора:
- Остановите процессы:
"C:\Program Files\Telecontrol SCADA\bin\scada-setup.exe" stop. - Удалите новую версию пакета Сервера: программу ОИК Телеконтроль — Сервер (издатель —
ООО Телеконтроль) в Панели управления — Программы и компоненты. Пакет
Сервера удаляет при этом службы и сертификат
Сервера из папки
C:\Program Files\Telecontrol SCADA\data\Certificates(смотрите Удаление Сервера); данные в папке данных и удостоверяющий центр объекта остаются. Службы снова создастapplyна шаге 5, сертификат вернется из резервной копии на шаге 4. -
Установите пакет Сервера прежней версии:
msiexec /i scada-server-<прежняя версия>.msi /qn /norestart /l*v install.log -
Верните из резервной копии, сделанной перед обновлением, папку данных (
%ProgramData%\Telecontrol\SCADA Serverили папку, заданную--data-root), заменив то, что в ней есть, а также папкуC:\Program Files\Telecontrol SCADA\data\Certificates. Возвращенный файл ключа получает права папки, поэтому ограничьте доступ к нему:icacls "C:\Program Files\Telecontrol SCADA\data\Certificates\ServerPrivateKey.pem" /inheritance:r /grant:r *S-1-5-18:F *S-1-5-32-544:FЕсли папки
Certificatesнет в резервной копии,applyсоздаст новый сертификат, и OPC UA-клиентам, которые доверяли прежнему, нужно будет доверять новому. Не оставляйте данные, с которыми работала новая версия: не проверено, изменяет ли новая версия базы при первом запуске, поэтому заведомо подходит прежней версии только копия, сделанная перед обновлением. - Выполните
scada-setup applyс параметрами компьютера и теми же паролямиsvcиroot. - Проверьте результат:
scada-setup status, затем войдите Клиентом.
Под Linux шаги те же, а команды выполняются через sudo. Удалять новую
версию перед установкой прежней не нужно: остановите процессы
(sudo /opt/telecontrol-scada/bin/scada-setup stop) и установите прежнюю
версию пакета поверх новой:
sudo apt install --allow-downgrades ./telecontrol-scada-server_<прежняя версия>_amd64.deb
При установке из архива распакуйте прежний архив той же командой
tar -xzf … -C /opt. Затем верните из резервной копии папку данных
(/var/lib/scada или папку, заданную --data-root) и папку
/opt/telecontrol-scada/data/Certificates и выполните шаги 5 и 6; шаг с
icacls не нужен.
Изменения конфигурации и значения, записанные в архив после резервного
копирования, теряются. Если рабочие места или пакет Клиента на компьютере
Сервера тоже были обновлены, так же удалите на них новый пакет Клиента
(ОИК Телеконтроль) и установите прежний (без команд scada-setup).
Удаление Сервера
Пакет Сервера сам удаляет службы. Прежде чем удалить файлы программы, он
выполняет scada-setup remove: останавливает и удаляет службы всех
процессов вместе с их параметрами в реестре. Затем он удаляет из папки
C:\Program Files\Telecontrol SCADA\data\Certificates
сертификат Сервера этого компьютера и его закрытый
ключ — файлы ServerCertificate.pem и ServerPrivateKey.pem и их копии,
отложенные apply. Удостоверяющий центр объекта — подпапка ca на
центральном компьютере — остается: после повторной установки apply
продолжит работать с ним, и сертификаты остальных компьютеров останутся
действительными. Но сертификат самого центрального компьютера apply
создаст заново, с другим отпечатком. Остальные компьютеры узнают его по
удостоверяющему центру, поэтому на них менять ничего не нужно; новый
отпечаток понадобится только для подключения новых компьютеров (смотрите
Отпечаток центрального компьютера изменился).
Данные
процессов в %ProgramData%\Telecontrol\SCADA Server (конфигурация,
пользователи, архивы, файлы, лицензия, файл паролей)
остаются. Если scada-setup remove
завершается ошибкой, удаление отменяется и программа остается
установленной: службы никогда не остаются без своих программ.
На каждом компьютере Сервера:
-
Сделайте резервную копию, если данные или сертификат могут понадобиться. Чтобы после повторной установки OPC UA-клиенты продолжали доверять Серверу, сохраните папку
data\Certificatesи верните ее доapply, или удалите программу командой с параметромSCADA_KEEP_CERTIFICATES=1(шаг 2) — тогда пакет Сервера не удаляет из папки ничего.Если компьютер навсегда выводится из объекта, удалите программу с параметром
SCADA_PURGE_CERTIFICATES=1: тогда удаляется вся папкаdata\Certificates, на центральном компьютере — вместе с удостоверяющим центром объекта (подпапкаcaс ключомca_key.pem). На центральном компьютере делайте так, только если объект больше не нужен: после повторной установкиapplyсоздаст новый удостоверяющий центр, и все остальные компьютеры объекта придется подключать заново (смотрите Новый удостоверяющий центр). -
Удалите пакет Сервера: в Панели управления — Программы и компоненты — программу ОИК Телеконтроль — Сервер (издатель — ООО Телеконтроль) или в командной строке с правами администратора:
msiexec /x scada-server-<версия>.msi /qn /norestart /l*v uninstall.logКоманде
msiexec /xнужен файл того самого пакета, который установлен; если его нет, удаляйте через Панель управления. Клиент, установленный на этом компьютере пакетомtelecontrol-scada-<версия>.msi, при этом остается; если он больше не нужен, удалите и его — программу ОИК Телеконтроль.Если удаление отменяется с ошибкой, найдите в
uninstall.logдействиеScadaSetupRemoveServicesи проверьте службы командой"C:\Program Files\Telecontrol SCADA\bin\scada-setup.exe" status. Если самаscada-setupне запускается, удалите службы средствами Windows и удалите программу с параметромSCADA_KEEP_SERVICES=1, который пропускает этот шаг:msiexec /x scada-server-<версия>.msi SCADA_KEEP_SERVICES=1 /l*v uninstall.log. - Если данные больше не нужны, удалите папку
%ProgramData%\Telecontrol\SCADA Server— данные процессов, файл лицензии и, если переход с версии 2.5 выполнялся, папки версии 2.5. ПапкаC:\Program Files\Telecontrol SCADAпосле удаления программы остается: в ней папкаdata\Certificatesс удостоверяющим центром объекта (на центральном компьютере) и сертификатами, которым доверяют процессы. Удаляйте ее целиком, только если компьютер навсегда выводится из объекта (или удаляйте программу сSCADA_PURGE_CERTIFICATES=1). -
Удалите правила брандмауэра, созданные в разделе Настройка сети (для правила, которого на компьютере нет,
netshсообщает, что подходящих правил нет, — это не ошибка):netsh advfirewall firewall delete rule name="Telecontrol SCADA Clients" netsh advfirewall firewall delete rule name="Telecontrol SCADA OPC UA"Так же, по заданному вами имени, удалите правила, созданные для связей, принимающих подключения (например, для порта 2404).
Под Linux
Под Linux sudo apt remove telecontrol-scada-server останавливает и
удаляет службы процессов и сертификат компьютера; данные в /var/lib/scada
и удостоверяющий центр объекта (на центральном компьютере — папка
/opt/telecontrol-scada/data/Certificates/ca) остаются, как и под Windows, и
после повторной установки остальные компьютеры подключать заново не нужно.
sudo apt purge telecontrol-scada-server удаляет и всю папку
data/Certificates вместе с удостоверяющим центром — так удаляйте
программу, только если компьютер навсегда выводится из объекта. При
установке из архива сначала выполните sudo /opt/telecontrol-scada/bin/scada-setup
remove, затем удалите папку /opt/telecontrol-scada; на центральном
компьютере, если программа будет установлена снова, сначала сохраните
подпапку data/Certificates/ca и верните ее до apply (смотрите
Новый удостоверяющий центр).
Учетная запись scada при удалении остается, в том числе после apt purge;
если она больше не нужна, удалите ее командой sudo userdel scada.
Ни apt remove, ни apt purge не удаляют папку данных /var/lib/scada
— в ней остаются конфигурация, архивы и лицензия. apt purge удаляет из нее
только папку secrets с файлом service-secrets.env, где пароли svc и
root хранятся в незашифрованном виде, — и в папке, заданной при установке
параметром --data-root, тоже: scada-setup запоминает ее в файле
/etc/scada/data-root. После apt remove файл с паролями остается. Папку
secrets удалите вручную (<папка данных>/secrets), если программа была
установлена из архива (scada-setup remove и удаление папки установки), а
также если папка данных отличается от /var/lib/scada и службы процессов
были удалены еще до apt purge — тогда записи о папке нет.
Если данные больше не нужны, удалите папку командой
sudo rm -rf /var/lib/scada, а также удалите правила брандмауэра, созданные
в разделе Настройка сети.