Omega Production Wiki

h1. Обновления

{{>toc}}

h2. Установщик обновлений

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

h3. Первый запуск и настройка

При первом запуске установщик выдаст сообщение “Укажите в настройках путь к tnsnames.ora". 

Нужно зайти в пункт “Настройка” и указать путь к tnsnames.ora, в котором есть алиасы к используемым базам.

При последующих запусках может появиться сообщение “Не обнаружен tnsnames.ora”. 

Нужно зайти в пункт “Настройка” и скорректировать путь к tnsnames.ora, в котором есть алиасы к используемым базам.

После задания\изменения пути к tnsnames.ora требуется перезапуск установщика.

Путь выглядит примерно так: C:\app\product\12.2.0\client_1\network\admin\

h3. Описание установщика

Внешний вид установщика:

!clipboard-202408211920-rj3vg.png!

h4. Закладка Обновление

h5. Раздел Экземпляр

* Расположение приложения Omega Production для обновления – можно задать выбрать и удалить расположение исполняемых файлов Омеги. Папка, в которой находятся папки App32, App64 или AppC64

* Версия приложения – отображает версию приложения из соответствующей папки. Если в расположении отсутствует папка, для которой есть обновление в патче, то будет написано “Отсутствует. Будет обновлено”

* Базы данных – отображает список баз из файла omp_db.ini приложения. Нужно отметить базы, подлежащие обновлению и указать пароль администратора в поле “Пароль”. Тогда в поле “Версия скриптов” отобразится версия скриптов из базы.

h5. Раздел Обновление

* Название – название обновления.

* Версия приложения – указывает на какую версию приложения произойдёт обновление.

* Версия скриптов – указывает с какой на какую версию скриптов произойдёт обновление.

Если версия скриптов, с какой должно производиться обновление, не совпадает с версиями скриптов выбранных баз, то кнопка “Обновить” будет недоступна.

h5. Раздел опций

* Делать резервную копию приложения – существующие исполняемые файлы будут скопированы в папку Backups в выбранном расположении.

* Устанавливать блокировку баз – в базе выставляется признак обновления (блокировка под администратором), при этом новые пользователи (кроме администратора) не могут зайти в приложение.

* Проверять блокировку баз – выполняется проверка, что в базе выставлен признак обновления (база заблокирована под администратором)

h4. Закладка Изменения

* Отображает список изменений, находящихся в обновлении.

h4. Закладка Лог

* Отображает лог процесса обновления

h3. Установка обновления

Необходимо указать расположение исполняемых файлов, выбрать базы для обновления, указать для них пароль, выбрать необходимые опции. Если всё указано правильно и обновление подходит для выбранных баз, то становится доступной кнопка “Обновить”.

Процесс обновления запускается нажатием на кнопку “Обновить”. При этом в зависимости от выбранных опций выполняются следующие действия:

* Устанавливаются блокировки баз

* Выполняется проверка на блокировку баз

* Выполняется проверка на отсутствие подключений к базам

* Выполняется проверка на отсутствие невалидных объектов в базах

* Выполняется резервное копирование исполняемых файлов

* Выполняется копирование новых исполняемых файлов

* Выполняется проверка версий исполняемых файлов

* Выполняется запуск скриптов по базам. Повторный запуск обновления (если он был прерван по ошибке) не приводит к повторному запуску скриптов. Уже пущенные скрипты будут пропускаться.

* Выполняется снятие блокировки с баз

Если на каком-то этапе произошла ошибка, то процесс обновления прерывается и выдаётся сообщение с указанием ошибки. Так же эта информация заносится в лог.

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

Некоторые факторы, приводящие к ошибке обновления:

    • База не заблокирована под админом. Нужно выполнить блокировку.

    • Не вышли все пользователи. Нужно выждать 15 минут после блокировки базы, тогда произойдёт автоматическое закрытие приложения у пользователей. Так же можно отключить сессии пользователей в toad или аналогичном средстве.

    • Обнаружены невалидные объекты. Нужно устранить невалидные объекты в базе (скомпилировать их).

    • Ошибка при создании резервной копии. Нужно устранить причины, мешающие копированию файлов

    • Ошибка при копировании новых файлов. Исполняемые файлы могут быть открыты по сети и это не даёт их перезаписать. В этом случае в логе появляется сообщение “… - не удалось скопировать за первый проход”.  Установщик пытается произвести закрытие сетевых подключений для таких файлов, и повторно скопировать. Иногда это не удаётся, тогда процесс копирование прерывается с ошибкой.

    • Ошибка при проверке версий новых файлов. Нужно проверить, что всё скопировалось правильно и связаться с разработчиками, возможно ошибка в самом обновлении.

    • Ошибка при запуске скриптов. Подробную информацию можно найти в логе. Обычные ошибки ora- не приводят к прерыванию процесса обновления, а заносятся в лог запуска скриптов. Но если в процессе обновления в базе появляются невалидные объекты, то обновление прерывается. Нужно разбираться какие объекты стали невалидными и что к этому привело. Устранять причину, устранять невалидные объекты (компилировать их) и снова запускать обновление.