Обновление LexemaRPA Orchestrator

Когда это нужно и зачем?

Если Вам необходимо обновиться с предыдущей минорной версии Lexema-RPA (Lexema-RPA Studio 5.14.x.x), следйте руководству данного пункта.

Дело в том, что основные версии Lexema-RPA работают с разными версиями оркестратора:
- Lexema-RPA Studio 5.14.x.x и раньше работают с версией Lexema-RPA Orchestrator 1.2.x. - Но после крупного обновления Lexema-RPA Studio 5.15.x.x, необходимо также обновить Lexema-RPA Orchestrator до 1.3.x.

В отличие от установки Lexema-RPA Studio с нуля, при обновлении необходимо выполнить несколько дополнительных шагов.

Будет необходимо проделать те же действия, что и при установке, а также создать резервную копию БД, затем использовать эту копию БД для новой версии оркестратора.

Обновление и миграции

Проделайте все шаги раздела «Установка» не доходя до пункта «Конфигурирование оркестратора».

Резервная копия

Для того чтобы безопасно обновлить Lexema-RPA Orchestrator, необходимо "склонировать" БД, на которой работал предыдущий оркестратор.

Создание резервной копии

В данном пункте руководства будет показано как производить создание резервной копии через графический интерфейс pgAdmin, либо если его нет на вашей машине, через командную строку.

Создание резервной копии через pgAdmin

Откройте pgAdmin.

Раскройте дерево элементов (Обзреватель или Browser).

Выберите БД старого оркестратора >> клик правой кнопкой мыши >> резервная копия (backup).

Откроется окно создания резервной копии.

В поле "имя файла" нужно ввести полное имя и путь. Для этого кликните на иконку файла в этом поле, затем выберите нужное место для хранения и укажите название файла. Примечание: резервная копия должна иметь расширение .sql.

Нажмите "Сохранить".

Нажмите "Резервная копия" ("Backup").

В правом нижнем углу появится уведомления о том что процесс резервного копирования начат.

Необходимо дождаться окончанияя резервного копирования. Появится уведомление "Завершено успешно" или "Completed successfully".

Создание резервной копии через командную строку

Это альтернатиынй способ без графического интерфейса

Через командную строку необходимо открыть папку C:\Programm Files\PostgreSQL\*версия postgres*\bin.

Далее выполнить следующую команду:

pg_dump --file "*полный_путь/имя_файла.sql*" --host "localhost" --port "5432" --username "*пользователь postgres*" --verbose --format=c --blobs "*название копируемой БД*"

Примечание: * полный_путь/имя_файла.sql - файл в который будет сохранена резервная копия

Создание клона БД из резервной копии

В данном пункте руководства будет показано как производить создание копии БД через графический интерфейс pgAdmin, либо если его нет на вашей машине, через командную строку.

Создание клона БД из резервной копии через pgAdmin

Откройте pgAdmin.

Раскройте дерево элементов (Обзреватель или Browser).

Нажмите ПКМ на "Базы данных" ("Database").

Создать >> База данных.

Откроется окно создания БД. Введите название новой БД. Нажмите "Сохранить".

Затем кликните ПКМ по созданной БД >> "Восстановить" ("Restore").

Откроется окшечко восстановления. В поле "Имя файла" ("File") выберите файл резервной копии, который был создан ранее. Нажмите "Сохранить" ("Save").

Дождитесь восстановления БД. Появится уведомление "Завершено успешно" или "Completed successfully".

Таким образом сделана резервная копия БД.

Создание клона БД из резервной копии командную строку

Это альтернатиынй способ без графического интерфейса

Через командную строку необходимо открыть папку C:\Programm Files\PostgreSQL\*версия postgres*\bin.

Далее выполнить следующую команду:

createdb -U "*пользователь postgres*" "*название_новой_БД*"

Затем:

pg_restore --host "localhost" --port "5432" --username "*пользователь_postgres*" --dbname "*название_восстанавливаемой_БД*" --verbose "*полный_путь/имя_файла_резервной_копии.sql*"

Примечание: * название_восстанавливаемой_БД - название БД, которая чуть ранее была создана командой createdb

Таким образом сделана резервная копия БД.

Конфигурирование оркестратора

Выполните конфигурирование оркестратора согласно этому руководству.
В качестве БД укажите копию старой БД, которую Вы недавно создали.

Перед запуском

Перед запуском оркестратора перейдите в распакованную папку Orchestrator-server-new и выполните:

npx sequelize-cli db:migrate

Запуск оркестратора

Для запуска оркестратора необходимо запустить файл main.js в папке dist.

Orchestrator-server-new/
├── dist/
│   └── main.js       # <-- исполняемый файл
├── client
├── files
├── node_modules
└── .env

Перейдите в распакованную папку Orchestrator-server-new, затем в dist, и выполните:

node main.js