Установка#

Состав дистрибутива#

Единый дистрибутив Grid Center содержит все перечисленные в таблице ниже компоненты дистрибутива для запуска установки/обновления.

Элемент дистрибутива

Описание

bin

Консольные утилиты администрирования

config

Конфигурационные файлы

documentation

Документация на продукт Grid Center

libs

Библиотеки Grid Center

grid-center-plugin

Библиотеки плагина Grid Center для Platform V DataGrid и Apache Ignite

Дополнительно в дистрибутиве Grid Center поставляется тег-файл regid.YYYY-MM.ru.sbertech_gce-X.X.X.swidtag для идентификации программного обеспечения.

Порядок установки#

В текущей версии Grid Center предусмотрена только ручная установка приложения.

Для установки Grid Center вручную выполните следующие этапы:

  1. Подготовка дистрибутива Grid Center (обязательный шаг);

  2. Ручная установка Grid Center (обязательный шаг);

  3. Запуск Grid Center (опциональный шаг);

  4. Установка плагина grid-center-plugin (опциональный шаг).

Подготовка дистрибутива Grid Center (обязательный шаг)#

Grid Center поставляется в виде ZIP-архива, который разделен на:

  • ZIP-архив *-owned*.zip — архивы с конфигурациями и бинарными артефактами компонентов;

  • ZIP-архив *-party*.zip — основная часть open-source библиотеки;

  • ZIP-архив *-doc*.zip — документация и метаинформация.

Также в архив включен скрипт restore-distrib.sh для подготовки дистрибутива Grid Center.

Чтобы получить самодостаточный дистрибутив, готовый к инсталляции и дальнейшему использованию на стороне потребителя, воспользуйтесь скриптом восстановления: bash restore-distrib.sh <PARAMS>.

Пример запуска:

bash restore-distrib.sh -d GCE-X.X.X-X-distrib.zip

где -d, --distrib <path_to_distrib> — путь к архиву с дистрибутивом.

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

Ручная установка Grid Center (обязательный шаг)#

Установка производится только в ручном режиме.

  1. Для установки приложения разархивируйте ZIP-архив, содержащий Grid Center.

    Пример выполнения команды:

    unzip gridcenter-X.X.X-distrib.zip -d /opt/gridcenter

    где:

    • unzip — программа для работы с ZIP-архивами;

    • gridcenter-X.X.X-distrib.zip — имя архива, содержащего продукт Grid Center;

    • /opt/gridcenter — целевой путь установки Grid Center.

    Примечание

    Grid Center поддерживает возможность обновления или отката до последней рабочей версии. Подробнее читайте в разделах «Обновление» и «Откат».

  2. После распаковки архива сделайте исполняемыми файлы:

    • в директории bin:

      • startGridCenter.sh — файл запуска Grid Center;

      • stopGridCenter.sh — файл остановки Grid Center ;

    • в директории bin/include:

      • jvmdefaults.sh — служебный файл для проверки наличия и совместимости версии JVM;

      • setEnv.sh — служебный файл для подготовки окружения.

    Для этого выполните команды:

    • для файлов запуска и остановки в директории bin: chmod +x /opt/gridcenter/Grid-Center-X.X.X/bin/*

    • для служебных файлов в директории bin/include: chmod +x /opt/gridcenter/Grid-Center-X.X.X/bin/include/*,

    где:

    • Grid-Center-X.X.X — номер версии Grid Center, которую планируете установить;

    • /opt/gridcenter/ — путь для установки Grid Center.

    Примечание

    Начиная с версии 2.0.0, перечисленные выше файлы являются исполняемыми по умолчанию.

Проверка результата#

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

  • В директории bin присутствуют файлы:

    • startGridCenter.sh;

    • stopGridCenter.sh.

  • В директории bin/include присутствуют файлы:

    • jvmdefaults.sh;

    • setEnv.sh.

  • В директории libs присутствует файл grid-center-{VERSION}.jar, где {VERSION} — номер версии Grid Center.

Запуск Grid Center (опциональный шаг)#

Для запуска Grid Center выполните запуск скрипта startGridCenter.sh. Этот скрипт расположен в директории bin в дистрибутиве Grid Center.

При запуске используются файлы для настройки приложения из директории config:

  • jvm.opts — для настройки параметров JVM;

  • grid-center.properties — для настройки параметров приложения.

Примечание

В случае, если для подключения к кластеру требуются пользовательские сертификаты, перед запуском поместите сертификаты для авторизации пользователей в специальный каталог на сервере Grid Center. Путь к каталогу с сертификатами укажите в файле настроек grid-center.properties, атрибут grid-center.user-security-path.

Пример базовых настроек из файла grid-center.properties:

server.port=8990
grid-center.user-security-path=/opt/gridcenter/

где:

  • server.port — сетевой порт для сервера;

  • grid-center.user-security-path — каталог в файловой системе технологического сервера, где расположены пользовательские JKS, для подключения к кластеру.

Для поддержки HTTPS-подключения используйте опциональные настройки:

server.ssl.key-store-type=JKS
server.ssl.key-store=/path/to/webAppKeyStore.jks
server.ssl.key-store-password=123456
server.ssl.trust-store=/path/to/truststore.jks
server.ssl.trust-store-password=123456
server.ssl.client-auth=none
grid-center.ssl-disabled=true
grid-center.client-certificate-validation=false

где:

  • server.ssl.key-store-type — тип хранилища ключей (keystore);

  • server.ssl.key-store - JKS, содержащий ключ и сертификат для установления соединений с клиентами (браузерами);

  • server.ssl.key-store-password — пароль от хранилища ключей (keystore);

  • server.ssl.trust-store — путь к доверенному хранилищу (truststore);

  • server.ssl.trust-store-password — пароль от доверенного хранилища (truststore);

  • server.ssl.client-auth — флаг обязательной проверки сертификата пользователя в браузере; доступные значения: need, none, want;

  • grid-center.ssl-disabled — флаг отключения SSL для установления соединений с клиентами (браузерами); доступные значения: true, false;

  • grid-center.client-certificate-validation — флаг отключения проверки сертификата пользователя в браузере; доступные значения: true, false.

Проверка результата#

Укажите в браузере URL-адрес для подключения к Grid Center, например: https://127.0.0.1:1234, где 127.0.0.1 — имя хоста, 1234 — имя порта. Отображение экрана с окном авторизации подвтерждает успешный запуск Grid Center.

Установка плагина grid-center-plugin (опциональный шаг)#

Чтобы расширить функциональность Grid Center для работы с кластером DataGrid и Apache Ignite (например, включить возможность работы с idle_verify на кешах, создавать снепшоты по расписанию или ускорить процесс работы с метриками и системными представлениями), вручную установите плагин grid-center-plugin в целевой кластер. Плагин необходимо установить на каждый узел кластера DataGrid или Apache Ignite.

Важно

Для того, чтобы установить корректную версию плагина, ознакомьтесь с таблицей Матрица совместимости плагинов расширения Grid Center для версии продукта Platform V DataGrid в разделе Совместимость с выпущенными клиентами документа «Описание».

Чтобы установить плагин grid-center-plugin, скопируйте директорию с плагином grid-center-plugin в директорию libs с уже установленным продуктом DataGrid или Apache Ignite.

Пример выполнения команды:

cp -r ./grid-center-plugin/grid-center-plugin_16.1.1 /opt/server/libs/

где:

  • cp — команда для копирования файлов и директорий;

  • ./grid-center-plugin/grid-center-plugin_16.1.1 — путь к директории с плагином grid-center-plugin из дистрибутива Grid Center.

Проверка результата#

Укажите в браузере URL-адрес для подключения к Grid Center, например: https://127.0.0.1:1234. После подключения к кластеру через Grid Center перейдите в раздел Кеши (Caches). Отображение на экране кнопки Idle verify подтверждает успешную установку плагина.