Page History

...

Expand

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

Для обновления на версию ExeMES 2.0 необходимо выполнить последовательно следующие шаги:

Expand

title	Обновить версию БД MESDB

Warning

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

Перед обновлением выполните процедуру резервного копирования БД MESDB.

Проверка актуальности версии БД MESDB и обновление версии производится из интерфейса ExeMES Client. Для проверки и обновления БД MESDB выполните следующие шаги:

Пройдите стандартную процедуру авторизации в ExeMES Client.
Проверьте актуальность версии БД MESDB:В правом верхнем углу экрана ExeMES Client нужно воспользуйтесь
1. Воспользуйтесь
1. всплывающим меню, которое вызывается по нажатию на иконку пользователя в статусной строке ExeMES Client
.
Image Removed
1. Image Added
2. Во всплывающем меню выберите пункт «Версия
1.3.0»
1. №», после чего откроется страница проверки и обновления версии базы данных MES.
Image RemovedНажмите на кнопку Проверить актуальность БД
1. Для проверки актуальности версии БД нажмите на кнопку «Проверить актуальность БД». Результаты проверки отобразятся на странице ниже
.
1. Image Added
2. В случае актуальной версии БД MESDB сообщение будет следующим:Image Modified
3. В случае необходимости обновления
в окне появится кнопка Обновить версию БД и детальная информация о вносимых изменениях. Для обновления нажмите на кнопку Обновить версию БД
1. версии БД MESDB появится сообщение о необходимости обновления и информация об изменениях, которые будут внесены в БД MESDBImage Modified
Обновите версию БД MESDB если она неактуальна:
1. Для обновления БД MESDB нажмите на кнопку «Обновить версию БД» на странице с результатами проверки актуальности БД, после чего подтвердите действие во всплывающем окнеImage Added
Подтвердите обновление БД во всплывающем окнеImage Removed
2. После завершения обновления БД появится
соответствущее
1. сообщение об успешном обновлении и лог процесса обновления
.
1. Image Modified

Обновление версии БД MESDB успешно завершено.

1. Если в процессе обновления БД возникнет ошибка, обратитесь в службу ТП ExeMESImage Added

Expand

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

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

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

Image Added

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

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

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

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

Image RemovedImage Added

Модификация реалма завершена.

Expand

title	Обновить версии приложений ExeMES Server (Middleware) и MesClientExeMES Client

Добавьте образы новых приложений в 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
Укажите новый образ для ExeMES Server (Middleware):
Code Block
image: "git.exeplant.ru:5050/mes-develop/exemesmiddleware:2.0"

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

Code Block
EntityAccessProtection: "Enabled"

Info

Переменная EntityAccessProtection активирует функционал разделения прав доступа по объектам.

Если Вы не планируете использовать этот функционал, можете не указывать эту переменную, либо сконфигурируйте её, указав:

Code Block
EntityAccessProtection: "Disabled"

Подробнее о настройке переменных окружения.

Укажите новый образ для MESClient ExeMES Client:
Code Block
image: "git.exeplant.ru:5050/mes-develop/exemesclient:2.0"

Expand

title	Добавить конфигурацию запуска приложений EXERuntimeClient ExeMES RuntimeClient и EXESchedExeSched

Скопируйте папки data/exeruntimeclient и data/exesched в папку с установленным ПО ExeMES (по умолчанию root/dev/);

Добавьте в файл docker-compose (по умолчанию root/dev/) конфигурацию приложения ExeRuntimeClient 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:
      - type: bind
        source: /root/dev/data/exesched/keycloak.json
        target: /App/keycloak.json
      - type: bind
        source: /root/dev/data/exesched/appsettings.json
        target: /App/appsettings.json
      - type: bind
        source: /root/dev/crt/EXESched.pfx
        target: /root/.aspnet/https/EXESched.pfx
      - type: bind
        source: /root/dev/crt/wildcard.mycompany.local.crt
        target: /etc/ssl/certs/wildcard.mycompany.local.pem 
    extra_hosts:
      - "mes-runtime.mycompany.local client.mycompany.local middleware.mycompany.local exesched.mycompany.local keycloak.mycompany.local:[host_ip]"

Code Block

title	Приложение

ExeRuntimeClient

ExeMES RuntimeClient

  exeruntimeclient:
    container_name: exeruntimeclient
    image: "git.exeplant.ru:5050/mes-develop/exeruntimeclient:1.0"
    restart: always
    environment:
      MiddlewareApiRootUri: "http://exemesmiddleware/api"    
      TZ: "Europe/Moscow"
      ASPNETCORE_URLS: "https://+;http://+"
      ASPNETCORE_HTTPS_PORT: "8143"
      ASPNETCORE_Kestrel__Certificates__Default__Password: "1"
      ASPNETCORE_Kestrel__Certificates__Default__Path: "/root/.aspnet/https/EXEMESClient.pfx"
      GCCSettings:BroadcastRemoteLicenses: "0"
      GCCSettings:UseRemoteHosts: "1"
      GCCSettings:Remotehosts: "[license_server_ip]"
    ports:     
      - "8143:443"
    volumes:
      - type: bind
        source: /root/dev/data/exeruntimeclient/keycloak.json
        target: /app/keycloak.json
      - type: bind
        source: /root/dev/data/exeruntimeclient/appsettings.json
        target: /App/appsettings.json
      - type: bind
        source: /root/dev/crt/wildcard.mycompany.local.pfx
        target: /root/.aspnet/https/EXEMESClient.pfx
      - type: bind
        source: /root/dev/crt/wildcard.mycompany.local.crt
        target: /etc/ssl/certs/wildcard.mycompany.local.pem
    extra_hosts:
      - "mes-runtime.mycompany.local client.mycompany.local middleware.mycompany.local keycloak.mycompany.local:[host_ip]"

Tip

Обратите внимание, что новые приложения используют уже существующие сертификаты, проверьте правильность указания пути к файлам сертификатов (используйте аналогию с ExeMES Server (Middleware)).

Code Block

title	Конфигурация использования сертификатов

      - type: bind
        source: /root/dev/crt/EXESched.pfx
        target: /root/.aspnet/https/EXESched.pfx
      - type: bind
        source: /root/dev/crt/wildcard.mycompany.local.crt
        target: /etc/ssl/certs/wildcard.mycompany.local.pem

Tip
Параметры [license_server_ip] и [host_ip] должны быть скорректированы под Вашу конфигурацию (используйте аналогию с конфигурацией Вашего приложения ExeMES Server (Middleware)).

Tip
Параметры подключения к контейнеру БД Postgre указаны в конфигурации приложений по умолчанию. Для альтернативной БД сконфигурируйте соответствующие переменные окружения.

Подробнее о настройке переменных окружения.

После завершения редактирования файла docker compose выполните перезапуск измененных и запуск добавленных контейнеров, выполнив команду:
Code Block
docker compose up -d

Expand

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

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

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

Expand

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

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

Нужно зайти

Зайдите в приложение Keycloak под администратором реалма и

выбрать

выберите в выпадающем списке реалм

exemes

«exemes»Image Modified

Далее

Выберите в левом боковом меню

выбрать

пункт

Clients

«Clients»Image Modified
В центральной части экрана

выбрать клиент Middleware

Image Removed

выберите клиент «mesmiddleware»Image Added

Далее необходимо перейти

Перейдите на вкладку Roles и

нажать кнопку Create Role

нажмите кнопку «Create Role»Image Modified

В открывшемся окне в поле Role Name необходимо ввести название новой роли EAdm в поле Description нужно ввести

Заполните поля в открывшемся окне:
- Role name = EAdm, Description = Edit (manage) Admin Tools.
Нажмите кнопку «Save»Image Modified

После заполнения полей необходимо нажать кнопку Save.

Аналогично роли EAdm необходимо добавить

Создайте еще одну роль

с именем VAdm и описанием

по аналогии:
- Role name = VAdm, Description = View Admin Tools.

После заполнения полей необходимо нажать кнопку Save.

Для назначения новых ролей определенной группе пользователей необходимо переключиться в левом меню на пункт Groups, затем необходимо выбрать группу пользователей, которой будут доступна роль разрешающая просмотр информации о версии БД MESDB (VAdm) и роль разрешающая производить обновление версии БД MESDB (EAdm). В примере ниже роль VAdm будет добавлена группе EXEMES_Admins. После выбора группы пользователей необходимо перейти на вкладку Role mapping

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

Выберите нужную Вам группу и перейдите на вкладку «Role mapping» в центральной части экрана и

нажать

нажмите на кнопку

Assign role

«Assign role»Image Modified
Во всплывающем окне

необходимо выбрать

выберите фильтр

Filter

«Filter by

clients

clients», правее фильтра в строке поиске

указать

укажите имя роли VAdm и

нажать

нажмите стрелку для поиска.

После необходимо поставить

Поставьте галку напротив группы VAdm и

нажать кнопку Assign

Image Removed

Теперь все пользователи группы EXEMES_Admins будут иметь возможность проверять актуальность версии БД MESDB.

Аналогично

нажмите кнопку «Assign»Image Added
Аналогично, для разрешения обновления версии БД MESDB группе пользователей

необходимо назначить

добавьте роль EAdm.

Expand

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

Для того чтобы приложение Middleware корректно обновила корректной работы механизма обновления БД 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	Обновить версии приложений ExeMES Server (Middleware) и MESClientExeMES Client

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

для ExeMES Server (Middleware)

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

для

MESClient

ExeMES Client

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 необходимо:

установить удалить старые и запустить новые контейнеры ExeMES.

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

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

скорректировать путь для доступа контейнеров к существующему хранилищу СУБД Postgre;

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

Warning

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

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

Для обновления с версии 1.0 до версии 1.1:
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.2:
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.

2

- 1, необходимо предварительно остановить и удалить существующие контейнеры ExeMES:

Postgres;
Keycloak;
Exemiddleware;

Exemesclient.

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

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

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

Excerpt Include

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

Expand

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

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

установить

Установить ПО Guardant;
Expand
title Инструкция
Include Page
Установка Guardant Control Center и Guardant SLK
Установка Guardant Control Center и Guardant SLK

обновить

Обновить БД MESDB

;скорректировать путь для доступа контейнеров к существующему хранилищу СУБД Postgre

;

удалить старые и запустить новые контейнеры ExeMES.

Warning

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

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

1. 1. UPD_from_V1.0.0_to_V1.0.

1.sql

1. 1. 1. 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

Скорректировать путь для доступа контейнеров к существующему хранилищу СУБД 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 24

New Version Current

Key