Обновление с предыдущих версий ExeReport

Актуальная версия ExeReport - 1.4 (релиз от марта 2025 г.)

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

установить ПО Guardant (при обновлении с версии 1.0)
Для корректной работы программных продуктов ExePlant требуется установить Guardant Control Center на один из компьютеров в сети, который будет выполнять функцию сервера лицензирования.
Допускается использовать в качестве сервера лицензирования хост, на котором установлен Docker
Дистрибутивы Guardant Control Center для различных ОС поставляются совместно с ПО ExePlant и находятся в инсталляционном пакете в папке gcc:
Выберите любой подходящий для вашей ОС файл установщик и произведите установку ПО любым удобным способом доступным в вашей ОС.
Примеры установки Guardant Control Center в ОС Ubuntu:
Для установки Guardant Control Center в графическом режиме в ОС Ubuntu удобно использовать установочный файл grdcontrol*.deb (конкретный файл необходимо выбрать в зависимости от разрядности ОС). Файл необходимо открыть через Центр приложений и нажать на кнопку "Установить", после чего дождаться завершения установки.
Для установки Guardant Control Center в консольном режиме в ОС Ubuntu удобно использовать установочный файл grdcontrol*.deb (конкретный файл необходимо выбрать в зависимости от разрядности ОС). В консоли необходимо перейти в каталог расположения установочного файла и выполнить команду:

sudo apt install ./[имя_файла].deb
После установки ПО Guardant Control Center необходимо активировать лицензию. Активация лицензий производится с использованием ПО Мастер лицензий Guardant (входит в состав Guardant SLK и не требует установки).
Активация лицензии может производиться в двух режимах:
Для запуска ПО Мастер лицензий Guardant в визуальном режиме необходимо запустить файл license_wizard из архива grdcontrol-3.29.tar.gz (соответствующий файл находится в папке x86 или x86_64 в зависимости от разрядности вашей ОС).
Для активации лицензии необходимо нажать на кнопку "+ Активация лицензии", после чего ввести в форму Программный ключ лицензии и завершить процесс активации следуя инструкциям в Мастере лицензий Guardant.
Программный ключ лицензии представляет собой текстовый шифр и предоставляется Вендором после покупки лицензии.
После успешной активации лицензии в Мастере лицензий Guardant отобразится информация об активированной лицензии.
Для активации лицензии необходимо перейти в папку с файлом license_wizard из архива grdcontrol-3.29.tar.gz в режиме консоли (соответствующий файл находится в папке x86 или x86_64 в зависимости от разрядности вашей ОС).
Далее необходимо предоставить права на файл Мастера лицензий Guardant, выполнив команду:

chmod +x license_wizard

Для активации лицензии необходимо выполнить команду:

./license_wizard --console --activate [Программный ключ лицензии] --host https://getlicense.guardant.ru

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

./license_wizard --console --list

В случае успешной активации в консоль будет выведена информация об активированной лицензии.
Детальная информация по работе с Мастером лицензий Guardant представлена на сайте производителя.
удалить старые и запустить новые контейнеры ExeMES.

Для запуска контейнеров ExeReport версии 1.1, необходимо предварительно остановить и удалить существующие контейнеры ExeReport

Postgres;
Keycloak;
Exereport.

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

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

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

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

Для установки и запуска ExeReport необходимо распаковать архив, содержащий ПО (инсталляционный пакет) и предоставленный Вендором.

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

Затем необходимо отредактировать файл docker-compose.yaml, расположенный в корневой папке каталога:

заменить по тексту файла параметр [host_ip] на ip адрес хоста, на котором инсталлирован Docker;
заменить по тексту файла параметр [license_server_ip] на ip адрес хоста, на котором установлен сервер лицензирования Guardant Control Center;
настроить необходимые переменные окружения.

После необходимо скопировать в каталог /exereport/crt сгенерированные ранее сертификаты и отредактировать файл docker-compose.yaml: заменить по тексту файла "mycompany.local" на имя домена, для которого сгенерированы сертификаты.

Если вы разворачиваете ПО ExeReport в демонстрационных, тестовых или обучающих целях (не на продуктивной среде) и не планируете использовать другой домен для работы приложения, то вы можете пропустить данный шаг инструкции

Далее необходимо открыть терминал ОС с root доступом, перейти в каталог, появившийся после распаковки архива, и выполнить команду:

bash install-exereport.sh

при этом произойдет загрузка образов, копирование данных и запуск сервисов.

При выполнении указанного выше скрипта производится установка Portainer - средства для мониторинга работы контейнеризированных приложений. Если вам не требуется установка Portainer удалите из файла

install-exereport.sh следующий код:

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

Если файл не запускается, измените права на этот файл командой:

chmod +x install-exereport.sh

После завершения выполнения скрипта будут запущены контейнеры приложений ExeReport, что будет подтверждено соответствующим сообщением в терминале.

Для обновления ПО ExeReport до версии 1.4 необходимо предварительно остановить и удалить существующий контейнер ExeReport.