Клиентские утилиты¶
Клиентские утилиты – набор вспомогательных скриптов, предназначенных для работы с кластером с удалённого сервера. Список доступных скриптов:
wait_config_ready.sh – ждет завершения загрузки конфигурации;
wait_etcd_ready.sh – дожидается готовности узла etcd-кластера;
wait_instance_ready.sh – дожидается готовности узла кластера Tarantool DB;
download_java_tarantool.sh – загружает Java-коннектор с сайта tarantool.io;
get_tdb2_config.lua – создает конфигурацию для кластера Tarantool DB 2.x на основе конфигурации Tarantool DB 1.x.
Ожидание окончания загрузки конфигурации¶
Утилита wait_config_ready.sh
ждет, пока завершится загрузка конфигурации.
Если заданное время ожидания в секундах истекло, а конфигурация осталась недоступна, скрипт генерирует ошибку.
./wait_config_ready.sh <максимальное_время_ожидания_сек> <адрес_конфигурации>
Пример
tools/client/wait_config_ready.sh 25 http://client:secret@tarantool-config-storage-1:3301/tdb
Ожидание готовности узла etcd-кластера¶
Утилита wait_etcd_ready.sh
дожидается готовности узла etcd-кластера.
Если заданное время ожидания в секундах истекло, но узел etcd-кластера не поднялся, скрипт генерирует ошибку.
./wait_etcd_ready.sh <максимальное_время_ожидания_сек> <строка_подключения>
Пример
tools/client/wait_etcd_ready.sh 15 http://192.168.0.20:2379
Ожидание готовности узла кластера¶
Утилита wait_instance_ready.sh
дожидается готовности узла кластера Tarantool DB.
Если заданное время ожидания в секундах истекло, но узел не поднялся, скрипт генерирует ошибку.
./wait_instance_ready.sh <максимальное_время_ожидания_сек> <строка_подключения>
Пример
tools/client/wait_instance_ready.sh 15 ./var/run/config-storage-1/tarantool.control
Загрузка Java-коннектора¶
Утилита download_java_tarantool.sh
загружает Java-коннектор с сайта tarantool.io.
Инструкция по установке tarantool-java-ee
приведена в разделе Установка клиента tarantool-java-ee.
Скрипт утилиты лежит в файле ./tools/client/download_java_tarantool.sh
.
Переменные окружения:
username
– имя пользователя учётной записи на сайте tarantool.io;password
– пароль учётной записи на сайте tarantool.io;version
– версия Java-коннектораtarantool-java-ee
.
Пример
$ ./download_java_tarantool.sh username password version
Создание конфигурации для кластера Tarantool DB 2.x¶
Утилита get_3_1_config.lua
конвертирует конфигурацию кластера Tarantool DB 1.x в конфигурацию для Tarantool DB 2.x.
Утилита доступна в составе архивов Tarantool DB версии 1.x, начиная с версии 1.2.1.
Выполняйте скрипт с машины, у которой есть доступ к экземпляру Tarantool.
Пример
./tarantool tools/client/get_3_1_config.lua admin:secret-cluster-cookie@instance_uri:3301 > result_config.yml
Здесь:
result_config.yml
– файл, в который записывается созданная конфигурация Tarantool 3.x.