Обновление и удаление

Переход с версии 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, в командной строке с правами администратора:

  1. Получите лицензию версии 2.6 (файл license.json) в ООО «Телеконтроль» и положите ее в %ProgramData%\Telecontrol\SCADA Server\license.json. Аппаратный ключ HASP или Guardant версией 2.6 не используется: ООО «Телеконтроль» обменивает его на лицензию — смотрите Обмен аппаратного ключа.
  2. Сделайте резервную копию всей папки %ProgramData%\Telecontrol\SCADA Server.
  3. Распакуйте пакет Сервера версии 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
    
  4. Посмотрите план перехода распакованной программой, указав полный путь, который вывела команда 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 (Панель управления — Службы), повторите проверку и затем снова запустите службу.

  5. Остановите службу 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 остаются на месте, служба остается зарегистрированной — ее удалит следующий шаг.

  6. Выполните переход с теми же --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.

  7. Только после шага 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.

  8. Установите Клиент версии 2.6 на каждом рабочем месте: Клиент 2.6 отображает мнемосхемы своим модулем отображения (смотрите Отображение мнемосхем). Работа Клиента версии 2.5 с Сервером 2.6 не проверялась.
  9. Подключитесь Клиентом (порт 2000, как и раньше) под учетной записью пользователя и проверьте объекты, архивы и мнемосхемы.

Если migrate --execute завершилась ошибкой:

  • после того, как скопировала все данные (в выводе есть строка Copied для каждой строки плана) — не повторяйте migrate: она откажется, потому что папки назначения уже существуют. Устраните причину ошибки и завершите переход командой apply с теми же --tiers и паролями;
  • на середине копирования — удалите созданные ею папки config, proxy, historian и filestore в %ProgramData%\Telecontrol\SCADA Server (папки версии 2.5 Configuration, 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. На том же компьютере, в командной строке с правами администратора:

  1. Удалите оба пакета версии 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. Установите выпуск 2.5.7 (telecontrol-scada-2.5.7.msi со страницы выпусков) так же, как устанавливали версию 2.5, и подключите аппаратный ключ HASP или Guardant.
  3. На каждом рабочем месте, куда при переходе был установлен пакет версии 2.6 (шаг 8 выше), удалите программу ОИК Телеконтроль в Панели управления — Программы и компоненты и установите Клиент выпуска 2.5.7 так же, как он был установлен раньше. Установщик 2.5.7 и на рабочем месте отказывается устанавливаться поверх версии 2.6.
  4. Проверьте, что служба 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), а восстановление резервной копии на том же компьютере лишь возвращает данные под ту версию, которая установлена сейчас. Поэтому перед каждым обновлением делайте резервную копию каждого компьютера Сервера: без нее пути назад нет.

Чтобы вернуться к прежней версии, на каждом компьютере Сервера, который успели обновить, в командной строке с правами администратора:

  1. Остановите процессы: "C:\Program Files\Telecontrol SCADA\bin\scada-setup.exe" stop.
  2. Удалите новую версию пакета Сервера: программу ОИК Телеконтроль — Сервер (издатель — ООО Телеконтроль) в Панели управления — Программы и компоненты. Пакет Сервера удаляет при этом службы и сертификат Сервера из папки C:\Program Files\Telecontrol SCADA\data\Certificates (смотрите Удаление Сервера); данные в папке данных и удостоверяющий центр объекта остаются. Службы снова создаст apply на шаге 5, сертификат вернется из резервной копии на шаге 4.
  3. Установите пакет Сервера прежней версии:

    msiexec /i scada-server-<прежняя версия>.msi /qn /norestart /l*v install.log
    
  4. Верните из резервной копии, сделанной перед обновлением, папку данных (%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-клиентам, которые доверяли прежнему, нужно будет доверять новому. Не оставляйте данные, с которыми работала новая версия: не проверено, изменяет ли новая версия базы при первом запуске, поэтому заведомо подходит прежней версии только копия, сделанная перед обновлением.

  5. Выполните scada-setup apply с параметрами компьютера и теми же паролями svc и root.
  6. Проверьте результат: 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 завершается ошибкой, удаление отменяется и программа остается установленной: службы никогда не остаются без своих программ.

На каждом компьютере Сервера:

  1. Сделайте резервную копию, если данные или сертификат могут понадобиться. Чтобы после повторной установки OPC UA-клиенты продолжали доверять Серверу, сохраните папку data\Certificates и верните ее до apply, или удалите программу командой с параметром SCADA_KEEP_CERTIFICATES=1 (шаг 2) — тогда пакет Сервера не удаляет из папки ничего.

    Если компьютер навсегда выводится из объекта, удалите программу с параметром SCADA_PURGE_CERTIFICATES=1: тогда удаляется вся папка data\Certificates, на центральном компьютере — вместе с удостоверяющим центром объекта (подпапка ca с ключом ca_key.pem). На центральном компьютере делайте так, только если объект больше не нужен: после повторной установки apply создаст новый удостоверяющий центр, и все остальные компьютеры объекта придется подключать заново (смотрите Новый удостоверяющий центр).

  2. Удалите пакет Сервера: в Панели управления — Программы и компоненты — программу ОИК Телеконтроль — Сервер (издатель — ООО Телеконтроль) или в командной строке с правами администратора:

    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.

  3. Если данные больше не нужны, удалите папку %ProgramData%\Telecontrol\SCADA Server — данные процессов, файл лицензии и, если переход с версии 2.5 выполнялся, папки версии 2.5. Папка C:\Program Files\Telecontrol SCADA после удаления программы остается: в ней папка data\Certificates с удостоверяющим центром объекта (на центральном компьютере) и сертификатами, которым доверяют процессы. Удаляйте ее целиком, только если компьютер навсегда выводится из объекта (или удаляйте программу с SCADA_PURGE_CERTIFICATES=1).
  4. Удалите правила брандмауэра, созданные в разделе Настройка сети (для правила, которого на компьютере нет, 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, а также удалите правила брандмауэра, созданные в разделе Настройка сети.