Page History

1. Добавьте образы новых приложений в docker. Для этого находясь в папке /images/ дистрибутива ExeMES 2.2 выполните следующие команды:

   Code Block
   docker load -i ./exemesmiddleware2.2.tar docker load -i ./exemesclient2.2.tar docker load -i ./exeruntimeclient2.2.tar docker load -i ./exesched2.2.tar

2. Укажите новый образ для ExeMES Server (Middleware): 

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

3. Укажите новый образ для ExeMES Client:

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

4. Укажите новый образ для ExeMES RuntimeClient:

   Code Block
   image: "git.exeplant.ru:5050/mes-develop/exeruntimeclient:2.2"

5. Укажите новый образ для ExeSched:

   Code Block
   image: "git.exeplant.ru:5050/mes-develop/exesched:2.2"

Если вы обновляетесь с версии младше 2.1 перед началом обновления модифицируйте существующий realm Keycloak, как это указано в инструкции для обновления на версию 2.1

Для возможности работы с новым функционалом ExeSched необходимо модицифировать существующий реалм Keycloak. Для этого выполните следующие шаги:

1. Добавьте новые роли для Midlleware:
   1. Зайдите в приложение Keycloak под администратором реалма и выберите в выпадающем списке реалм «exemes»Image AddedВыбор реалма
   2. В левом боковом меню выберите пункт «Clients»Image AddedПункт Clients
   3. В центральной части экрана выберите клиент «mesmiddleware»Image AddedВыбор клиента mesmiddleware
   4. Перейдите на вкладку Roles и нажмите кнопку «Create Role»Image AddedСоздание роли
   5. Заполните поля в открывшемся окне:
      • Role name = EPO, Description = May Edit Purchase Orders.
   6. Нажмите кнопку «Save»Image AddedСохранение роли
   7. Создайте еще одну роль по аналогии:
      • Role name = VPO, Description = May View Purchase Orders.
2. Добавьте новую роль для ExeShed:
   1. Вернитесь к списку клиентов и выберите «exesched»Image AddedВыбор клиента
   2. Перейдите на вкладку Roles и нажмите кнопку «Create Role»Image AddedСоздание роли
   3. Заполните поля в открывшемся окне:
      • Role name = Admin, Description = Администратор приложения ExeSched.
   4. Нажмите кнопку «Save»Image AddedСохранение роли
3. Назначьте новые роли соответствующим группам пользователей, в зависимости от Вашей конфигурации. Подробно об Управлении доступом к ExeMES

1. Добавьте образы новых приложений в docker. Для этого находясь в папке /images/ дистрибутива ExeMES 2.1 выполните следующие команды:

   Code Block
   docker load -i ./exemesmiddleware2.1.tar docker load -i ./exemesclient2.1.tar docker load -i ./exeruntimeclient2.1.tar docker load -i ./exesched2.1.tar

2. Укажите новый образ для ExeMES Server (Middleware): 

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

Для возможности работы с новыми приложениями ExeMES RuntimeClient и ExeSched необходимо импортировать конфигурацию новых клиентов в существующий реалм Keycloak. Для этого выполните следующие шаги:

1. Зайдите в приложение Keycloak под администратором реалма и выберите в выпадающем списке реалм «exemes»Image AddedВыбор реалма
2. В левом боковом меню выберите пункт «Clients»Image AddedПункт Clients
3. В центральной части экрана нажмите на кнопку «Import Client»Image AddedИмпорт клиента
4. Ниже в центральной части экрана нажмите «Browse...»Image AddedВыбор файла для импорта
5. Выберите файл exemesruntime-client.json из папки upd, которая находится в составе дистрибутива exemes 2.0 и нажмите кнопку «Открыть»Image AddedВыбор файла exemesruntime-client.json
6. После завершения загрузки файла, переместитесь в конец страницы и нажмите кнопку «Save»Image AddedСохранение конфигурации
7. Аналогичные действия необходимо произвести со вторым файлом в папке upd: exesched.json
8. После завершения импорта конфигурации убедитесь что новая конфигурация появилась в списке клиентов

Image AddedПроверка списка импортированных клиентов

Для корректной работы новых приложений ExeMES RuntimeClient и ExeSched необходимо создать и настроить роли в импортированных клиентах:

1. Выберите в списке клиентов «exemesruntime-client».
   1. В центральной части экрана перейдите на вкладку «Roles» и нажмите на кнопку «Create role»Image AddedСоздание роли для exemesruntime-client
   2. Ниже заполните поля Role name и Description, в завершении нажмите кнопку «Save»Image AddedСохранение роли для exemesruntime-client
   3. Таким образом, создайте 4 роли с описаниями:
      • Role name = Inventory, Description = Доступ к экрану управления складскими остатками;
      • Role name = Operator, Description = Доступ к панели оператора;
      • Role name = Quality, Description = Доступ к экрану управления качеством;
      • Role name = Utilization, Description = Доступ к экрану управления событиями оборудования.
2. Вернитесь к списку клиентов и выберите «exesched»
   1. Для exesched создайте 1 роль:
      • Role name = Scheduler, Description = Планировщик.
3. Назначьте новые роли соответствующим группам пользователей, в зависимости от Вашей конфигурации. Подробно об Управлении доступом к ExeMES.

Для корректной работы механизма разграничения прав доступа по объектам выполните следующие шаги:

1. Добавьте новые роли соответствующим группам пользователей, в зависимости от Вашей конфигурации.
   1. Выберите в левом меню вкладку «Clients» далее выберите пункт «mesmiddleware»Image AddedВыбор клиента mesmiddleware
   2. В центральной части экрана выберите вкладку «Roles» и нажмите кнопку «Create Role»Image AddedСоздание роли для mesmiddleware
   3. В новом окне заполните поля Role name и Description. Таким образом для клиента mesmiddleware должно быть создано 2 роли:
      • Role name = VAccess, Description = View Access Management;
      • Role name = EAccess, Description = Edit Access Management.
   4.  Назначьте новые роли группам пользователей, в зависимости от конфигурации Вашей системы. Подробно об Управлении доступом к ExeMES.
2. Добавьте существующие роли реалма группам пользователей, отвечающим за настройку доступа к объектам.
   1. Добавьте роль view-users (существующая); Image AddedДобавление роли view-users
   2. Добавьте роль manage-authorization (существующая).Image AddedДобавление роли manage-authorization
3. Добавьте роль realm-management/view-clients для сервисного аккаунта клиента mesmiddleware.
   1. Перейдите в левом меню на вкладку «Clients»;
   2. Выберите пункт «mesmiddleware»;
   3. В центральной части экрана перейдите на вкладку «Service Account Roles» и нажмите на кнопку «Assign role»;Image AddedДобавление роли для сервисного аккаунта клиента mesmiddleware
   4. В появившемся окне выберите фильтр «Filter by clients»;
   5. Введите в поле фильтра «view-clients»;
   6. Выберите роль «view-clients» и нажмите кнопку «Assign».

Image AddedДобавление роли для сервисного аккаунта клиента mesmiddleware

1. Добавьте образы новых приложений в docker. Для этого находясь в папке /images/ дистрибутива ExeMES 2.0 выполните следующие команды:

   Code Block
   docker load -i ./exemesmiddleware2.0.tar docker load -i ./exemesclient2.0.tar docker load -i ./exeruntimeclient1.0.tar docker load -i ./exesched1.0.tar

2. Укажите новый образ для ExeMES Server (Middleware): 

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

3. Сконфигурируйте новую переменную окружения для ExeMES Server (Middleware):

   Code Block
   EntityAccessProtection: "Enabled"

   Info
   Переменная EntityAccessProtection активирует функционал разделения прав доступа по объектам. Если Вы не планируете использовать этот функционал, можете не указывать эту переменную, либо сконфигурируйте её, указав: Code Block EntityAccessProtection: "Disabled" Подробнее о настройке переменных окружения.

4. Укажите новый образ для ExeMES Client:

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

1. Скопируйте папки data/exeruntimeclient и data/exesched в папку с установленным ПО ExeMES (по умолчанию root/dev/);
2. Добавьте в файл docker-compose (по умолчанию root/dev/) конфигурацию приложения ExeMES RuntimeClient и ExeSched;

   Code Block
   title Приложение ExeSched
   exesched:     container_name: exesched     image: "git.exeplant.ru:5050/mes-develop/exesched:1.0"     restart: always     environment:       MiddlewareApiRootUri: "https://middleware.mycompany.local:7142/api"           TZ: "Europe/Moscow"       ASPNETCORE_URLS: "https://+;http://+"       ASPNETCORE_HTTPS_PORT: "8135"       ASPNETCORE_Kestrel__Certificates__Default__Password: "1"       ASPNETCORE_Kestrel__Certificates__Default__Path: "/root/.aspnet/https/EXESched.pfx"       GCCSettings:BroadcastRemoteLicenses: "0"       GCCSettings:UseRemoteHosts: "1"       GCCSettings:Remotehosts: "[license_server_ip]"     DBConnection: "Server=some-postgres; User Id=postgres; Database=exesched; Port=5432; Password=postgres; SSLMode=Prefer"     ports:            - "8135:443"     volumes:       -

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

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

1. Зайдите в приложение Keycloak под администратором реалма и выберите в выпадающем списке реалм «exemes»Image AddedВыбор реалма
2. Выберите в левом боковом меню пункт «Clients»Image AddedПункт Clients
3. В центральной части экрана выберите клиент «mesmiddleware»Image AddedВыбор клиента mesmiddleware
4. Перейдите на вкладку Roles и нажмите кнопку «Create Role»Image AddedСоздание роли
5. Заполните поля в открывшемся окне:
   •  Role name = EAdm, Description = Edit (manage) Admin Tools.
6. Нажмите кнопку «Save»Image AddedСохранение роли
7. Создайте еще одну роль по аналогии:
   • Role name = VAdm, Description = View Admin Tools.

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

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

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

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');

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

• для ExeMES Server (Middleware)

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

• для ExeMES Client

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

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

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

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

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;