Требования

• Операционная система: Windows x64.
• Свободное место на диске для апдейта Oracle Database до версии 12 Release 1 (в случае, если текущая версия БД Oracle ниже 12 версии)
• Наличие тестовой среды для проверки миграции с текущей копией БД Oracle.

Список необходимого ПО

• Последняя версия платформы, собранная под задачу миграции: IQChannels-4.1.5-6.
• Версия Oracle Database: 12c Enterprise Edition Release 12.1.0.X.0 (где X - любая версия)
• Oracle Instant client basic windows 12.1.0.2 версии
• Postgresql 12 версии (на момент написания инструкции актуальная версия 12.20 для ОС Windows Server 2012 R2)
• Многопоточный конвертер баз данных - data-pump (на момент написания инструкции актуальная версия 0.11.0), которую необходимо запросить в коммерческой дирекции iSimpleLab.
• Для запуска data-pump также понадобится Java(openjdk) версии не ниже 1.8 (jdk-8u202).

Подготовка окружения и процесс миграции

1) Для начала необходимо провести апдейт Oracle Database до версии 12 Release 1 в том случае, если текущая версия БД Oracle ниже 12.

2) Также предварительно необходимо запросить в коммерческой дирекции iSimpleLab многопоточный конвертер баз данных - data-pump последней версии (на 21.08.2024 актуальная версия 0.11.0).

3)  Настроим Oracle Instant Client (Если ранее не было настроено на текущей ОС, иначе пропускаем данный пункт).

Необходимо скачать версию basic 12.1.0.2. Далее распаковать папку instantclient_12_1 из архива, и положить на диск С. Сразу же необходимо копировать в буфер обмена абсолютный путь до папки (например C:/instantclient_12_1), и внести записи в переменные среды:

• Открываем Панель управления → Система и безопасность → Система → Дополнительные параметры системы → Переменные среды...
• В окне внизу есть системные переменные, необходимо добавить полный путь до instantclient_12_1 в переменную Path. От других записей отделяем точкой с запятой <;>
• Также создаем новую системную переменную, в Значение также пишем полный путь до instantclient_12_1 (если ранее не была добавлена):
  • Имя переменной OCI_LIB64
• Перезагрузить ОС для того, чтобы изменения вступили в силу.

4) Далее загружаем IQChannels-4.1.5-6 с доработками для проведения миграции.

• Распаковываем архив, папку iqchannels-windows переименуйте в iqchannels.
• Далее если в корне диска c:/ уже имеется ранее установленная платформа (папка iqchannels), то из неё необходимо взять свой конфиг по пути c:/iqchannels/config/config.yaml, копировать в другое место, а папку по пути C:/iqchannels можно удалить
• После переносим на C:/ распакованных архив, а также помещаем ранее копированный конфиг config.yaml в папку по пути c:/iqchannels/config/

5) Следующий этап - установка и подготовка PostgreSQL. Необходимо скачать установщик с официального сайта (https://www.postgresql.org/), версии 12 (актуальная 12.20 на 21.08.2024) для ОС Windows Server 2012 R2. После скачивания, установить, следуя подсказкам в установщике (особенности установки см. в ПРИМЕЧАНИИ).

ПРИМЕЧАНИЕ:   Важно, когда увидите список компонентов для установки, отмеченный галочками, рекомендуем не ставить pgAdmin из данного установщика, поэтому галочку с него необходимо снять, т.к. в данном установщике pgAdmin часто не запускается в системе корректно. Для решения данного вопроса, после установки рекомендуем скачать pgAdmin отдельно и установить, если необходим графический интерфейс при подключении и настройке БД Postgre (например, pgAdmin 4.26).

После установки делаем подготовку БД Postgre:

• Открываем pgAdmin, подключаемся к БД (пароль тот же, который был указан в процессе установки)
• Далее создаем пользователя iqchannels, предоставляем ему все необходимые права.
• После создаем новую БД, называем iqchannels, указываем для неё пользователя iqchannels.

Чистая БД Postgre готова.

6) Далее нам необходимо проделать следующие действия с ранее подготовленной платформой iqchannels на C:/iqchannels:

1. Переходим в проводнике в папку C:/iqchannels/config, делаем копию файла. У нас получится два файла config.yaml (назвать их необходимо так, чтобы в скрипте миграции платформы был задействован определенный конфиг, далее в шагах будет подробно описано об этом). В одном необходимо указать подключение к БД Oracle, в другом подключение к БД PostgreSQL (ниже примеры параметров):
   Для Oracle:

   db: type: oracle connect: iqchannels/secret@localhost:1521/xe max_idle: 4 # Max idle connections in a connection pool. max_open: 12 # Max open connections in a connection pool.

   
   

   Для PostgreSQL:

   • Документация по параметрам подключения

   db: type: postgres connect: host=localhost port=5432 dbname=iqchannels user=iqchannels password=secret sslmode=disable max_idle: 4 # Max idle connections in a connection pool. max_open: 12 # Max open connections in a connection pool.

2. В данном шаге подготавливаются БД Oracle и PostgreSQL к работе с многопоточным конвертером баз данных - data-pump. Необходимо сделать следующее:
   
   

   1. В папке C:/iqchannels/config/ выбираем конфиг с указанной в параметрах БД Oracle (проверяем, что этот файл называется config.yaml). Второй конфиг с PostgreSQL переименовываем в _config.yaml (или любой другой, чтобы не был задействован в скрипте миграции ниже).

   2. Открываем командную строку от имени Администратора.

   3. Переходим в папку C:/iqchannels

      cd C:/iqchannels

   4. Далее запускаем скрипты миграции базы данных (Oracle) в командной строке (после данного шага командную строку закрывать не нужно, еще понадобится): 

      .\bin\iqchanneld.bat migrate 2017/11/15 15:46:45 WARN migrations Migrating... 2017/11/15 15:46:45 WARN migrations Reading migrations from "migrations/oracle" ... 2017/11/15 15:46:45 WARN migrations Applied 0 migration(s) in 64ms

   5. Не запускаем платформу на данном этапе, теперь сразу же делаем следующие действия:
      Также, как и в шаге a. данного пункта, переименовываем конфиги (но теперь наоборот):
      В папке C:/iqchannels/config/ выбираем конфиг с указанной в параметрах БД PostgreSQL (проверяем, что этот файл называется config.yaml). Второй конфиг с Oracle переименовываем в _config.yaml (или любой другой, чтобы не был задействован в скрипте миграции ниже).

   6. Снова переходим в командную строку, в папке C:/iqchannels снова запускаем скрипты миграции базы данных (PostgreSQL):
      

      .\bin\iqchanneld.bat migrate 2017/11/15 15:46:45 WARN migrations Migrating... 2017/11/15 15:46:45 WARN migrations Reading migrations from "migrations/postgres" ... 2017/11/15 15:46:45 WARN migrations Applied 0 migration(s) in 64ms

      Платформу также после данного шага запускать/проверять не нужно.

7) Следующим шагом самый главный этап - миграция данных через многопоточный конвертер баз данных - data-pump (ранее её необходимо было запросить в шаге 2) инструкции). Для подготовки к её использованию необходимо:

• Для запуска data-pump понадобится Java(openjdk) версии не ниже 1.8 (jdk-8u202).
  Скачиваем установщик, устанавливаем. В процессе установки особенностей нет, все стандартно.
• После необходимо создать в корне диска C:/ папку (например C:/datapump), в которую необходимо поместить необходимые файлы, а именно (ниже пример для версии data-pump 0.11.0):
  • data-pump-0.11.0.jar
  • start.bat
• Далее необходимо прописать настройки подключения к БД Oracle и PostgreSQL. Сделать это можно двумя способами:
  • Отредактировать файл start.bat в текстовом редакторе
  • Редактировать параметры после запуска веб-интерфейса

• Рассмотрим второй способ, чтобы было более наглядно. Открываем командную строку от имени Администратора, и переходим в папку, в которую поместили файлы data-pump (ниже пример для пути C:/datapump):

  cd C:/datapump

  и далее запускаем start.bat

  start.bat

• Открываем браузер, переходим в веб-интерфейс по адресу localhost:8080 (данный адрес и порт можно изменить в файле start.bat):
• Ниже на примере скришота выделены поля, в которых указывается подключение к БД, а также логин и пароль (указывать такие же, как и в файле C:/iqchannels/config/config.yaml).
  Важное замечание, что в поле JDBC URL для БД Оракл и БД PostgreSQL записи отличаются, менять знаки, которые разделяют localhost, порт и имя базы не нужно.

• Далее необходимо настроить число одновременных потоков и таблиц, а также максимальное число и размер (более подробно о расчете в документации по работе с многопоточным конвертером баз данных - data-pump).
• После настройки, прокручиваем веб-страницу вниз, нажимаем кнопку Начать проверку. Пойдет процесс подготовки и проверки, после окончания будет выведена подробная информация об ошибках/несоответствиях. Если ошибки критичные, дальнейший этап будет недоступен. Пример на скриншоте ниже:
  
  
  
• Если все в порядке, нажимаем кнопку Начать копирование. По итогу будет выведена информация и статус (пример ниже):
  

8) Все готово, теперь необходимо проверить данные, для этого запустим платформу IQChannels:

• Открываем командную строку от имени Администратора, и переходим в папку C:/iqchannels

  cd C:/iqchannels

• Далее запускаем демон приложения:

  .\bin\iqchanneld.bat run

• На данном этапе необходимо проверить корректность и наличие данных в разных настройках (вкладках).

9) Если в предыдущем пункте результаты проверки успешные, то миграция завершена, далее можно обновлять платформу на более свежие версии с PostgreSQL.