Для обновления существующих проектов до текущей версии «КАСКАД Цифра» нажмите на кнопку «Обновить проект» на панели управления проектами более ранних версий. Обновление касается всех программных компонентов «КАСКАД Цифра», таких как панели, базы данных, интерфейс пользователя и т. д. Обновление базы данных, однако, ограничено импортом новых точек данных или типов точек данных. Как правило, это выполняется с помощью инструмента PVSStoolConvertDb, при этом сообщения об ошибках и состоянии записываются в файл «convertDb.log» в каталоге «<путь_проекта>/log/». Более подробно о кодах ошибок и их значениях см. в разделе «WCCOAascii».

 ТРЕБОВАНИЯ

• Проект должен быть зарегистрирован, в противном случае он не будет обновлен.
• Перед обновлением проекта стандартные библиотеки (в особенности, «pt.ctl») необходимо синхронизировать с текущими библиотеками или временно удалить.
• Если в проекте содержатся пользовательские расширения CTRL, не скомпилированные до обновления, записи о них в файле «config» необходимо перевести в комментарии.
• Обратите внимание, что при обновлении проекта в нем должны содержаться файлы панелей.
• Имя пользователя в Windows должно содержать не более 15 символов и не должно содержать специальных знаков (например, «-»). Точки, двоеточия, точки с запятой, пробелы и символы ASCII до символа 32 преобразуются в знак подчеркивания «_».
• Некорректные расширения CTRL, предназначенные для загрузки в UI (интерфейс пользователя) или в менеджер сценариев (CTRL менеджер) и хранящиеся вне каталога «/bin» «КАСКАД Цифра», могут привести к сбою в работе соответствующего менеджера. Информация о подобных расширениях CTRL отображается в средстве просмотра журналов «КАСКАД Цифра». Некорректные расширения должны быть соответствующим образом исправлены. Используя новый параметр командной строки «–noUserCtrlExt», для каждого менеджера можно заблокировать загрузку расширения CTRL, хранящегося вне каталога «/bin». Этот параметр также используется для WCCOAtoolConvertDb.

Рисунок. Обновление проекта

Подлежащий обновлению проект отображается в неактивном текстовом поле, выделенном серым цветом. Путь к текущей версии «КАСКАД Цифра» отображается в текстовом поле ниже. При обновлении проекта также можно указать количество драйверов, которые должны быть запущены. Для этого необходимо ввести наибольший номер драйвера проекта в одноименном поле. Данный параметр необходим для корректной установки периферийных адресов элементов точек данных в проекте при импорте базы данных. Если установлен флажок «Сохранить проект перед обновлением», перед обновлением создается резервная копия проекта. Резервная копия сохраняется в каталоге проекта под именем «<имя_проекта>.bak». При создании нескольких резервных копий к именам файлов «bak» добавляются номера по возрастанию (bak, .bak1, .bak2). С помощью данной панели также поддерживается изменение порта Pmon обновленного проекта (номер порта можно ввести с клавиатуры). Если номер порта не изменяется и если проект был создан в версии старше 3.0, используется стандартный порт Pmon (4999). Для начала обновления нажмите «OK». При запуске обновления автоматически открывается средство просмотра журналов и отображается файл «convertDb.log». Это позволяет следить за процессом обновления. В случае ошибок выводятся соответствующие сообщения.

ПРИМЕЧАНИЕ

Если стандартные типы точек данных были изменены (например, если был удален тип точек данных «ANALOG1»), во время обновления проекта могут возникать ошибки. В этой связи перед обновлением рекомендуется выполнить экспорт ASCII, а после обновления импортировать данные.

ПРИМЕЧАНИЕ

Сообщения об ошибках с положительными кодами ошибок свидетельствуют о том, что, несмотря на ошибку на определенном этапе, это не повлияло на успешное завершение процесса обновления в целом. Отрицательные коды ошибок (например, -27) свидетельствуют об ошибках, которые привели к сбою в процессе обновления. Положительные коды ошибок описаны в главе «WCCOAascii».

ПРИМЕР

Обновление существующего проекта:

1. Выберите проект на панели управления проектами более ранних версий.
2. Выделите проект и нажмите на кнопку «Обновить проект».
3. Укажите количество драйверов, которые необходимо запускать, а также номер порта Pmon в проекте, подлежащем обновлению.
4. Нажмите OK для применения настроек и запуска обновления.

После успешного обновления проекта он отображается в списке проектов, созданных в текущей версии «КАСКАД Цифра» (текущая версия указывается справа от имени проекта).

ПРИМЕЧАНИЯ

1. Обновление проектов, созданных в непосредственно предшествующей версии программы (например, обновление проекта с версии 2.12 до версии 3.0), выполняется без необходимости установки поддержки предыдущих версий. Если проект был создан в более ранней версии (например, обновление проекта с версии 2.11.1 до версии 3.0), при установке «КАСКАД Цифра» следует установить поддержку предыдущих версий (см. также раздел «Установка»). При обновлении система проверяет, существуют ли необходимые файлы «dbd» в каталоге «<путь_КАСКАД>/dbdfiles/».
2. При обновлении проекта ни один другой проект (использующий стандартные порты) не должен быть запущен!
3. Процесс обновления отменяется, если в проекте активирован мониторинг жесткого диска, содержащего недействительную запись, например, о несуществующем каталоге.
   В этом случае необходимо либо исправить путь проекта в существующем проекте, либо перед обновление проекта отключить мониторинг жесткого диска, присвоив параметру «checkDiskSpace» в файле «config» (раздел [data]) значение «0».

Режим совместимости с Windows Native Vision NV

Начиная с версии «КАСКАД Цифра» 3.6, все существовавшие интерфейсы пользователя (Linux Motif Ui, Windows Native Vision NV, Windows Native Gedi NG) на всех поддерживаемых платформах заменены одним общим интерфейсом пользователя, созданным на основе графического инструментария QT.

Для обеспечения определенной совместимости со старыми проектами, с помощью параметров «compat*» в разделе [ui] файла «config» можно активировать использование старой функциональности Windows Native Vision NV в текущей версии интерфейса QT-UI «КАСКАД Цифра». Описание соответствующих параметров файла «config» приводится в файле «CFG_DOKU_en.xsl» в каталоге «/config» в директории установки «КАСКАД Цифра».

Обновление «КАСКАД Цифра» в резервированной системе

Обновление версии

Если сервер 1 и сервер 2, включая все UI- клиенты (= удаленные UI) и удаленные системы «КАСКАД Цифра» (например, удаленные драйверы) работают в составе резервированной системы «КАСКАД Цифра» более ранней версии, и требуется выполнить обновление до текущей версии «КАСКАД Цифра», необходимо выполнить следующие действия:

1. Остановить проект «КАСКАД Цифра» на сервере 1, после чего активной останется система на сервере 2.
2. Выполнить обновление до текущей версии «КАСКАД Цифра» на сервере 1 (включая обновление Oracle до текущей версии, если используется РБД).
3. Изменить номера портов менеджера данных, менеджера событий и REDU-менеджера (= менеджера резервирования) в проекте «КАСКАД Цифра».
4. Запустить проект «КАСКАД Цифра» на сервере 1. По завершении запуска оба компьютера будут активны, однако система на сервере 1 не будет подключена к UI- клиентам или удаленным системам.
5. Выполнить обновление до текущей версии «КАСКАД Цифра» на UI- клиентах и удаленных системах (установка текущей версии программы, настройка файла «config/progs»).
6. Настроить номера портов менеджера данных, менеджера событий и REDU-менеджера в проектах UI- клиентов  и удаленных систем в соответствии с конфигурацией сервера 1.
7. Остановить проект «КАСКАД Цифра» на сервере 2.
8. Выполнить обновление до текущей версии «КАСКАД Цифра» на сервере 2.
9. Настроить номера портов менеджера данных, менеджера событий и REDU-менеджера в файле «config» проекта «КАСКАД Цифра» в соответствии с конфигурацией сервера 1.
10. Запустить проект «КАСКАД Цифра» на сервере 2, после чего сервер 2 выполняет восстановление и запуск проекта.

ПРИМЕЧАНИЕ

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

В процессе обновления программы «КАСКАД Цифра» могут потребоваться определенные изменения в проекте, например:

— компилирование процессов API и расширений CTRL в новой версии программы
— незначительные изменения в сценариях CTRL и панелях
— изменения проекта, связанные с изменением стандартных функций «КАСКАД Цифра», например, панели алармов и событий, иерархии панелей и т. п.