Ручная установка#

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

Порядок ручной установки Corax из дистрибутива:

Внимание

Перед началом ручной установки необходимо собрать дистрибутив (zip-архив) по инструкции «Подготовка дистрибутива Corax к установке», если он не был собран ранее.

  1. Извлеките дистрибутив из zip-архива командой:

    unzip KFK-10.340.0-16-distrib.zip -d ~/corax

    где KFK-10.340.0-16-distrib.zip — имя дистрибутива.

    Примечание

    В примере использовано имя дистрибутива Corax версии 10.340.0. Архив будет извлечен в каталог corax.

    В результате распаковки в каталоге corax должны появится файлы:

    Файл

    Описание

    Архивы

    kfka-doc-10.340.0-16-distrib.zip

    Архив с документацией

    kfka-deploy-10.340.0-SNAPSHOT-distrib.zip

    Архив с ansible-ролями

    kafka-sbt-config.zip

    Архив с конфигурациями для профилей установки

    kafka-dist.zip

    Дистрибутив Corax

    Скрипты для установки с определенными конфигурациями

    deploy-ssl__zk_mtls_with_auth__kafka_ssl_with_auth__secman.sh

    SSL с авторизацией через Secret Management System

    deploy-ssl__zk_mtls_with_auth__kafka_ssl_with_auth__audit__secman.sh

    SSL с авторизацией через Secret Management System + аудит

    deploy-ssl__zk_mtls_with_auth__kafka_ssl_with_auth__audit.sh

    SSL с авторизацией + аудит

    deploy-ssl__zk_mtls_with_auth__kafka_ssl_with_auth.sh

    SSL с авторизацией

    deploy-plaintext__zk_plain_no_auth__kafka_plaintext_no_auth.sh

    Без SSL и без авторизации

  2. Перейдите в каталог corax командой:

    cd ~/corax

  3. Запустите скрипт с необходимым профилем, например:

    ./deploy-plaintext__zk_plain_no_auth__kafka_plaintext_no_auth.sh

    Скрипт распакует дистрибутив, переложит файлы properties для выбранного профиля в каталог ./config. В результате в текущем каталоге должны появится каталоги:

    Каталог

    Описание

    bin

    Каталог с исполняемыми файлами

    config

    Каталог с конфигурационными файлами

    data

    Каталог для данных

    etc

    Каталог для символической ссылки kafka

    libs

    Каталог для библиотек kafka

    logs

    Каталог для логов kafka

    optional

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

    util

    Каталог, в который перекладывается Corax после применения скрипта профиля

Настройка CORAX_HOME и PATH#

Чтобы упростить использование Corax CLI и всех инструментов командной строки, поставляемых вместе с Corax , настройте переменную CORAX_HOME и добавьте каталог bin в PATH. При этом станет возможным использование инструментов CLI без перехода в каталог CORAX_HOME.

Порядок настройки:

  1. Установите переменную среды для домашнего каталога Corax (каталога, где установлен Corax). Например:

    export CORAX_HOME=~/corax

  2. Добавьте каталог bin в PATH:

    export PATH=$PATH:$CORAX_HOME/bin

  3. Проверьте правильность установки переменной CORAX_HOME командой:

    kafka-configs.sh --version

    В выводе должны быть показаны Дата сборки, Версия Corax и базовая версия Corax, например:

    Core version: Х.Х.Х, Corax version: ХХ.ХХХ.Х-ХХ (Commit:<хеш значение>), build: DD/MM/YYYY

Запуск Corax#

Брокер Kafka и ZooKeeper#

Для запуска Corax отредактируйте файл ${CORAX_HOME}/config/server.properties:

zookeeper.connect=:2181
listeners=PLAINTEXT://:9092

Если предварительно была настроена переменная CORAX_HOME, то для запуска Corax выполните команды:

  1. Для запуска ZooKeeper: zookeeper-server-start -daemon ./config/zookeeper.properties;

  2. Для запуска брокера Kafka: kafka-server-start -daemon ./config/server.properties.

Если переменная CORAX_HOME не настроена, используйте для запуска Corax команды:

cd ~/corax;
bin/zookeeper-server-start.sh -daemon config/zookeeper.properties
bin/kafka-server-start -daemon config/server.properties

Schema Registry#

  1. Перед запуском Schema Registry отредактируйте файл ${CORAX_HOME}/config/schemaregistry/schema-registry.properties:

    spring.kafka.bootstrap-servers=:9092

    где 9092 — порт, на котором работает брокер Kafka.

  2. Для запуска Schema Registry используйте команду:

    crx-schema-registry-start.sh -daemon config/schemaregistry/schema-registry.properties

Corax UI#

  1. Перед запуском Corax UI отредактируйте файл ${CORAX_HOME}/config/kafka-ui.properties:

kafka.clusters[0].bootstrapServers=:9092
kafka.clusters[0].zookeeper=:2181

где `[0]` — порядковый номер брокера (Corax UI может управлять несколькими брокерами или несколькими кластерами Kafka).

  1. Для запуска выполните команду:

    crx-ui-start -daemon ./config/kafka-ui.properties