Установка OpenSearch Dashboards (Debian)

Установка OpenSearch Dashboards с использованием менеджера пакетов Advanced Packaging Tool (APT)

Установка OpenSearch Dashboards с использованием менеджера пакетов Advanced Packaging Tool (APT) значительно упрощает процесс по сравнению с методом Tarball. Например, менеджер пакетов обрабатывает несколько технических аспектов, таких как путь установки, расположение конфигурационных файлов и создание службы, управляемой systemd.

Перед установкой OpenSearch Dashboards необходимо настроить кластер OpenSearch. Обратитесь к руководству по установке OpenSearch для Debian для получения инструкций.

Данное руководство предполагает, что вы уверенно работаете с интерфейсом командной строки (CLI) Linux. Вы должны понимать, как вводить команды, перемещаться между директориями и редактировать текстовые файлы. Некоторые примеры команд ссылаются на текстовый редактор vi, но вы можете использовать любой доступный текстовый редактор.

Установка OpenSearch Dashboards из пакета

  1. Скачайте пакет Debian для нужной версии непосредственно с страницы загрузок OpenSearch. Пакет Debian доступен для архитектур x64 и arm64.

  2. Установите пакет с помощью dpkg из командной строки:

    • Для x64:

      sudo dpkg -i opensearch-dashboards-3.1.0-linux-x64.deb

    • Для arm64:

      sudo dpkg -i opensearch-dashboards-3.1.0-linux-arm64.deb

  3. После завершения установки перезагрузите конфигурацию менеджера systemd:

    sudo systemctl daemon-reload

  4. Включите OpenSearch как службу:

    sudo systemctl enable opensearch-dashboards

  5. Запустите службу OpenSearch:

    sudo systemctl start opensearch-dashboards

  6. Проверьте, что OpenSearch запустился корректно:

    sudo systemctl status opensearch-dashboards

Проверка подписи

Пакет Debian не подписан. Если вы хотите проверить подпись, проект OpenSearch предоставляет файл .sig, а также .deb пакет для использования с GNU Privacy Guard (GPG).

  1. Скачайте нужный пакет Debian:

    curl -SLO https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/3.1.0/opensearch-dashboards-3.1.0-linux-x64.deb

  2. Скачайте соответствующий файл подписи:

    curl -SLO https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/3.1.0/opensearch-dashboards-3.1.0-linux-x64.deb.sig

  3. Скачайте и импортируйте GPG-ключ:

    curl -o- https://artifacts.opensearch.org/publickeys/opensearch-release.pgp | gpg --import -

  4. Проверьте подпись:

    gpg --verify opensearch-dashboards-3.1.0-linux-x64.deb.sig opensearch-dashboards-3.1.0-linux-x64.deb

Установка OpenSearch Dashboards из репозитория APT

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

  1. Установите необходимые пакеты:

    sudo apt-get update && sudo apt-get -y install lsb-release ca-certificates curl gnupg2

  2. Импортируйте публичный GPG-ключ. Этот ключ используется для проверки подписи репозитория APT:

    curl -o- https://artifacts.opensearch.org/publickeys/opensearch-release.pgp | sudo gpg --dearmor --batch --yes -o /usr/share/keyrings/opensearch-release-keyring

  3. Создайте репозиторий APT для OpenSearch:

    echo "deb [signed-by=/usr/share/keyrings/opensearch-release-keyring] https://artifacts.opensearch.org/releases/bundle/opensearch-dashboards/3.x/apt stable main" | sudo tee /etc/apt/sources.list.d/opensearch-dashboards-3.x.list

  4. Проверьте, что репозиторий был успешно создан:

    sudo apt-get update

  5. С добавленной информацией о репозитории, перечислите все доступные версии OpenSearch:

    sudo apt list -a opensearch-dashboards

  6. Выберите версию OpenSearch, которую хотите установить:

    • Если не указано иное, будет установлена последняя доступная версия OpenSearch:

      sudo apt-get install opensearch-dashboards

    • Чтобы установить конкретную версию OpenSearch Dashboards, укажите номер версии после имени пакета:

      # Укажите версию вручную с помощью opensearch=<version>
sudo apt-get install opensearch-dashboards=3.1.0

  7. После завершения установки включите OpenSearch:

    sudo systemctl enable opensearch-dashboards

  8. Запустите OpenSearch:

    sudo systemctl start opensearch-dashboards

  9. Проверьте, что OpenSearch запустился корректно:

    sudo systemctl status opensearch-dashboards

Изучение OpenSearch Dashboards

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

  1. Откройте файл opensearch_dashboards.yml:

    sudo vi /etc/opensearch-dashboards/opensearch_dashboards.yml

  2. Укажите сетевой интерфейс, к которому должен связываться OpenSearch Dashboards:

    # Используйте 0.0.0.0, чтобы связаться с любым доступным интерфейсом.
server.host: 0.0.0.0

  3. Сохраните изменения и выйдите из редактора.

  4. Перезапустите OpenSearch Dashboards, чтобы применить изменения конфигурации:

    sudo systemctl restart opensearch-dashboards

  5. В веб-браузере перейдите к OpenSearch Dashboards. Порт по умолчанию — 5601.

  6. Войдите с использованием имени пользователя admin и пароля admin. (Для OpenSearch 2.12 и новее пароль должен быть пользовательским паролем администратора.)

  7. Посетите раздел “Начало работы с OpenSearch Dashboards”, чтобы узнать больше.

Обновление до новой версии

Экземпляры OpenSearch Dashboards, установленные с помощью dpkg или apt-get, можно легко обновить до новой версии.

Ручное обновление с помощью DPKG

  1. Скачайте пакет Debian для желаемой версии обновления непосредственно со страницы загрузок проекта OpenSearch.

  2. Перейдите в директорию, содержащую дистрибутив, и выполните следующую команду:

    sudo dpkg -i opensearch-dashboards-3.1.0-linux-x64.deb

Обновление с помощью APT-GET

Чтобы обновить до последней версии OpenSearch Dashboards с помощью apt-get, выполните следующую команду:

sudo apt-get upgrade opensearch-dashboards

Вы также можете обновить до конкретной версии OpenSearch Dashboards, указав номер версии:

sudo apt-get upgrade opensearch-dashboards=<version>

Автоматический перезапуск службы после обновления пакета (2.13.0+)

Чтобы автоматически перезапустить OpenSearch Dashboards после обновления пакета, включите службу opensearch-dashboards.service через systemd:

sudo systemctl enable opensearch-dashboards.service