Page History

...

Expand

title	Обновление на версию 1.3

Warning
Процесс обновления БД MESDB до версии 1.3 возможен только с версии 1.2. Для обновления до версии 1.2 см. пункт Обновление на версию 1.2

Для обновления ПО ExeMES 1.3 используется встроенный в Middleware функционал. Для корректной работы функционала обновления необходимо предварительно выполнить следующие действия:

Expand

title	Модифицировать существующий реалм Keycloak

Необходимо добавить в существующий реалм Keycloak новые роли и назначить эти роли требуемой группе пользователей, для этого:

Зайдите в приложение Keycloak под администратором реалма и выберите в выпадающем списке реалм «exemes»
Выберите в левом боковом меню пункт «Clients»
В центральной части экрана выберите клиент «mesmiddleware»
Перейдите на вкладку Roles и нажмите кнопку «Create Role»
Заполните поля в открывшемся окне:
- Role name =EAdm, Description = Edit (manage) Admin Tools.
Нажмите кнопку «Save»
Добавьте еще одну роль по аналогии:
- Role name =VAdm, Description = View Admin Tools.

Для корректной работы функционала обновления БД новые роли необходимо добавить группам пользователей в зависимости от Вашей конфигурации.

Выберите нужную Вам группу и перейдите на вкладку «Role mapping» в центральной части экрана и нажмите на кнопку «Assign role»
Во всплывающем окне выберите фильтр «Filter by clients», правее фильтра в строке поиске укажите имя роли VAdm и нажмите стрелку для поиска. Поставьте галку напротив группы VAdm и нажмите кнопку «Assign»
Аналогично, для разрешения обновления версии БД MESDB группе пользователей добавьте роль EAdm.

Expand

title	Подготовить БД MESDB версии 1.2 к обновлению

Для корректной работы механизма обновления БД MESDB необходимо подключиться к БД MESDB любым клиентом СУБД, поддерживающим работу с Postgre версии 15.4 и выполнить следующий скрипт:

Code Block

CREATE TABLE public."__EFMigrationsHistory" (
"MigrationId" varchar(150) NOT NULL,
"ProductVersion" varchar(32) NOT NULL,
CONSTRAINT "PK___EFMigrationsHistory" PRIMARY KEY ("MigrationId")
);

INSERT INTO public."__EFMigrationsHistory"
("MigrationId", "ProductVersion")
values
('20240312123332_MESDB_V0', '8.0.8'),
('20240708154420_MESDB_V1.2.0', '8.0.8');

Expand

title	Обновить версии приложений Middleware и MESClient

Для обновления версий необходимо скорректировать файл docker-compose, указав

для Middleware

Code Block
image: "git.exeplant.ru:5050/mes-develop/exemesmiddleware:1.3.0"

для MESClient

Code Block
image: "git.exeplant.ru:5050/mes-develop/exemesclient:1.3.0"

Note

Указанные образы обновляемых приложений должны быть предварительно добавлены в docker. Образы приложений располагаются в дистрибутиве в папке images. Для добавления образов в docker используйте команду docker load -i [путь к файлу образа]

Далее для обновления необходимо использовать функционал автоматического обновления БД MESDB.

Expand

title	Опциональное обновление

Кроме обязательных действий по обновлению БД MESDB мы предлагаем обновить описания статусов производственных заданий. Это обновление носит рекомендательный характер и никак не влияет на функционал ExeMES.

Для обновления необходимо выполнить следующий скрипт в любом клиенте СУБД подключенном к MESDB

Code Block
update job_state set state_desc = 'НОВОЕ' where state_cd = 1;


update job_state set state_desc = 'В РАБОТУ' where state_cd = 2;


update job_state set state_desc = 'ВЫПОЛНЯЕТСЯ' where state_cd = 3;


update job_state set state_desc = 'ЗАВЕРШЕНО' where state_cd = 4;


update job_state set state_desc = 'ПРИОСТАНОВЛЕНО' where state_cd = 5;


update job_state set state_desc = 'ЗАМОРОЖЕНО' where state_cd = 6;


update job_state set state_desc = 'ОТМЕНЕНО' where state_cd = 7;


update job_state set state_desc = 'ПРОПУЩЕНО' where state_cd = 8;


update job_state set state_desc = 'ЗАМЕНЕНО' where state_cd = 9;

Expand

title	Обновление на версию 1.2

Для обновления ПО ExeMES до версии 1.2 необходимо:

Установить ПО Guardant (при обновлении с версии 1.0)
Expand
title Инструкция
Include Page
Установка Guardant Control Center и Guardant SLK
Установка Guardant Control Center и Guardant SLK

Обновить БД MESDB;

Warning

Перед обновлением БД MESDB необходимо создать резервную копию БД. При обновлении версии БД MESDB существующая конфигурация производственной модели и накопленные производственные данные будут сохранены. Обновление БД MESDB затрагивает только схему public, в том числе будут обновлены функции и хранимые процедуры.

Для обновления версии БД MESDB потребуется любой клиент СУБД, поддерживающий подключение к СУБД Postgres. В клиенте СУБД необходимо выполнить подключение к БД MESDB, параметры подключения можно получить из docker-compose файла, который использовался при запуске существующей версии ExeMES. Далее необходимо выполнить скрипты sql, который располагаются в папке db_updates в дистрибутиве ExeMES 1.2:

Для обновления с версии 1.0:
1. 1. 1. UPD_from_V1.0.0_to_V1.0.1.sql
    2. UPD_from_V1.0.1_to_V1.0.2.sql
    3. UPD_from_V1.0.2_to_V1.0.3.sql
    4. UPD_from_V1.0.3_to_V1.0.4.sql
    5. UPD_from_V1.0.4_to_V1.0.5.sql
    6. UPD_from_V1.0.5_to_V1.1.0.sql
Для обновления с версии 1.1
1. 1. 1. V1.1.0_to_V1.2.0.sql

Скорректировать путь для доступа контейнеров к существующему хранилищу СУБД Postgre;
- По умолчанию при установке ExeMES для хранилища СУБД Postgre используется директория /root/dev/db/. Если при установке ExeMES было задано альтернативное размещение хранилища СУБД Postgre, то необходимо изменить путь подключения к нему.
  Для этого перед развертыванием новых контейнеров ExeMES в Docker необходимо скорректировать файл docker-compose в части конфигурации контейнера Postgres, а именно добавить:
  Code Block
  volumes: - [путь к папке с существующим хранилищем БД Postgre]:/var/lib/postgresql/data/
Удалить старые и запустить новые контейнеры ExeMES.
- Для запуска контейнеров ExeMES версии 1.1, необходимо предварительно остановить и удалить существующие контейнеры ExeMES:

Postgres;
Keycloak;
Exemiddleware;

Exemesclient.

Tip
Т.к. Keycloak хранит конфигурацию в БД, при удалении контейнера конфигурация не будет потеряна, внесенные настройки сохранены в БД и будут использованы новой версией контейнера

Tip
Если вы планируете изменить сертификаты безопасности не забудьте их сгенерировать и указать для использования приложениям как указано в инструкции

Затем необходимо установить новую версию ExeMES согласно инструкции ниже

Excerpt Include

	Инструкция по установке ExeMES
	Инструкция по установке ExeMES

...

Page tree

Versions Compared

Old Version 37

New Version 38

Key