Подготовка к установке

1. Подготовка среды для развертывания приложения (среда на выбор):
2. 1. Установка Docker

      Expand
      title Инструкция по установке
      Include Page Установка Docker Установка Docker

   2. Развертывание кластера Kubernetes

      Info
      Инструкция в разработке

3. Если вы разворачиваете приложение в Docker для хоста, на котором установлен Docker обязательно должен быть сконфигурирован ip адрес отличный от "127.0.0.1". Данный ip адрес должен быть использован в качестве [host_ip] при выполнении дальнейших пунктов инструкции.

4. Подготовка сертификатов 

   Expand
   title Инструкция
   Include Page Подготовка сертификатов Подготовка сертификатов

   Tip
   В инсталляционном пакете в папке crt поставляются самоподписанные сертификаты для домена mycompany.local. Если вы разворачиваете ПО ExeMES в демонстрационных, тестовых или обучающих целях (не на продуктивной среде) и не планируете использовать другой домен для работы приложения, то вы можете пропустить данный шаг инструкции и воспользоваться готовыми сертификатами.

5. Настройка DNS

   Expand
   title Инструкция
   Include Page Настройка DNS Настройка DNS

6. Установка Guardant Control Center и Guardant SLK

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

Установка ExeMES

• Установка ExeMES в Docker

  Excerpt

  Expand title Инструкция по установке для ОС семейства Linux Для установки и запуска ExeMES необходимо распаковать архив, содержащий ПО ExeMES (инсталляционный пакет) и предоставленный Вендором используя команду: Code Block gunzip -c exemes.tar.gz | tar -xvf – В результате у вас появится новый каталог exemes с необходимыми для запуска файлами. После чего необходимо отредактировать файл docker-compose.yaml, расположенный в корневой папке каталога: заменить по тексту файла параметр [host_ip] на ip адрес хоста, на котором инсталлирован Docker; заменить по тексту файла параметр [license_server_ip] на ip адрес хоста, на котором установлен сервер лицензирования Guardant Control Center. Затем необходимо скопировать в каталог /exemes/crt сгенерированные ранее сертификаты и отредактировать файл docker-compose.yaml: заменить по тексту файла "mycompany.local" на имя домена, для которого сгенерированы сертификаты. Tip Если вы разворачиваете ПО ExeMES в демонстрационных, тестовых или обучающих целях (не на продуктивной среде) и не планируете использовать другой домен для работы приложения, то вы можете пропустить данный шаг инструкции Далее необходимо открыть терминал ОС с root доступом, перейти в каталог, появившийся после распаковки архива, и выполнить команду: Code Block bash install-exemes.sh при этом произойдет загрузка образов, копирование данных и запуск сервисов. Tip Также при выполнении указанного выше скрипта производится установка Portainer - средства для  мониторинга работы контейниризированных приложений. Если вам не требуется установка Portainer удалите из файла install_exemes.sh следующий код: Code Block docker volume create portainer_data docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:2.20.2 systemctl restart docker Note Если файл не запускается, измените права на этот файл командой: Code Block chmod g+x install_exemes.sh После завершения выполнения скрипта будут запущены контейнеры приложений ExeMES, что будет подтверждено соответствующим сообщением в терминале: После завершения инсталляции необходимо открыть web-консоль администрирования Keycloak в браузере по адресу https://keycloak.[домен]:5787. Для доступа в Keycloak необходимо воспользоваться логином и паролем административной учетной записи, который указан в параметрах KEYCLOAK_ADMIN_USER и KEYCLOAK_ADMIN_PASSWORD настроек контейнера keycloak в docker-compose.yaml. В Keycloak необходимо перейти в настройки realm exemes, создать пользователя и добавить его в группу EXEMES_Admins. Инструкция по созданию и добавлению пользователя в группу.

• Установка ExeMES в Kubernetes

  Info
  Инструкция в разработке

Настройка переменных окружения

Пакет инсталляции ExeMES уже содержит настроенные переменные окружения и если вы не планируете менять настройки по умолчанию, то можете пропустить данный шаг.

Доступные настройки:

docker run [путь для скачивания образа приложения] -e MESDBContext='Server=localhost; User Id=middleware; Database=mesdb; Port=5432; Password=password; SSLMode=Prefer' -e MESDBContextRO='Server=localhost; User Id=middleware_ro; Database=mesdb; Port=5432; Password=password; SSLMode=Prefer'

-e MESDBOwnerContext='Server=localhost; User Id=postgres; Database=mesdb; Port=5432; Password=password; SSLMode=Prefer'

-e DBStrategyOnStartUp='CreateIfNotExists'

-e CORS='https://elma365.exeplant.local,https://keycloak.exeplant.local'

-e EntityAccessProtection='enabled'

docker run [путь для скачивания образа приложения] -e MiddlewareApiRootUri='https://mesmiddleware.myweb.local/api'

docker run [путь для скачивания образа приложения] -e DBConnection='Host=localhost;Port=5432;Database=exesched;Username=user;Password=pass'

Проверка работоспособности ExeMES после установки

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

• ExeMES Client  - https://client.[домен]:8142/
• ExeMES RuntimeClient - https://mes-runtime.[домен]:8143/
• ExeSched - https://exesched.[домен]:8135/