Быстрый старт
Развертывание
Моделирование данных
Подключение
Запись данных
Миграция
Запросы
Операции и обслуживание
Расширение кластера
Настройка производительности
Устранение неполадок
Справочник
Руководство по инструментам
Типы данных
Хранилище данных
Выполняющая система
Конфигурация
Справочник по SQL
Часто задаваемые вопросы
В этом документе описывается инструмент добавления зеркальных узлов (Mirror) mxaddmirrors.
mxaddmirrors можно добавить зеркальные узлы в систему YMatrix, развернутую изначально без них, и запустить процесс онлайн-репликации между основными сегментами (Primary) и соответствующими им зеркальными сегментами.Примечание!
Во время процесса добавления зеркал база данных должна быть простаивающей. Не должно выполняться никаких рабочих нагрузок и других запросов.
Ниже приведено подробное описание аргументов командной строки:
| Подкоманда | Параметр | Описание | Опционально |
|---|---|---|---|
| config | Создает пользовательский конфигурационный файл | ||
| --db-cluster-id | Идентификатор кластера базы данных. Используется для идентификации уникального кластера базы данных | Опционально | |
| --filename | Сохраняет созданный конфигурационный файл по указанному пути. Если файл не существует, он будет создан автоматически. Также можно использовать перенаправление вывода | Опционально | |
| init | Преобразует собранные данные в базовый план | ||
| --db-cluster-id | Идентификатор кластера базы данных. Хранится в файле /etc/matrixdb5/cluster.conf. При наличии одного кластера используйте последний ClusterID; при нескольких кластерах выберите подходящий --db-cluster-id |
Обязательно | |
| --mirror-port-base | Начальный порт, с которого начинается поиск свободного порта для прослушивания зеркалом. По умолчанию поиск начинается с порта 7000 |
Опционально | |
| plan | Генерирует план развертывания | ||
| --init-file | Абсолютный путь к файлу, полученному путем перенаправления вывода команды init |
Обязательно | |
| --custom-config | Абсолютный путь к файлу, созданному командой config |
Опционально | |
| setup | Выполняет развертывание | ||
| --plan-file | Абсолютный путь к файлу, полученному путем перенаправления вывода команды plan |
Обязательно |
Примечание!
Если поведение по умолчанию вас устраивает, необходимо указывать только обязательные параметры.
Инструмент mxaddmirrors должен выполняться пользователем с правами sudo на хосте мастера (кроме пользователя mxadmin, используйте абсолютный путь /opt/ymatrix/matrixdb5/bin/mxaddmirrors). Если команда mxaddmirrors init была случайно запущена от имени пользователя без прав sudo, файл mxaddmirrors.init будет создан в контексте этого пользователя и станет доступен только для чтения другим пользователям. В этом случае вы должны удалить этот файл и повторно выполнить команду под пользователем с правами sudo, чтобы пересоздать его.
Приведены два примера использования: один с поведением по умолчанию, другой — с пользовательской конфигурацией. Подробности ниже:
Примечание!
Выберите либо 3.1, либо 3.2. Поведение по умолчанию использует политику распределения зеркал по кольцу Ring mirror distribution policy от YMatrix. При использовании пользовательской конфигурации вы можете изменить стратегию размещения зеркал. Независимо от выбора, необходимо следовать полному процессу добавления зеркал.
Сбор информации об узлах и частичных данных о текущем развертывании существующей базы данных.
$ mxaddmirrors init > /tmp/mxaddmirrors.initГенерация плана развертывания на основе собранной информации — этот план содержит точные шаги развертывания.
$ mxaddmirrors plan --init-file /tmp/mxaddmirrors.init > /tmp/mxaddmirrors.planВыполнение развертывания.
$ mxaddmirrors setup --plan-file /tmp/mxaddmirrors.plan --mode cliСохранение сгенерированной конфигурации в файл config. Если файл не существует, он будет создан автоматически.
$ mxaddmirrors config --filename /tmp/configРедактирование файла config.
$ edit configСбор информации об узлах и частичных данных о текущем развертывании существующей базы данных.
$ mxaddmirrors init > /tmp/mxaddmirrors.initГенерация плана развертывания на основе собранных данных и пользовательской конфигурации.
$ mxaddmirrors plan --init-file /tmp/mxaddmirrors.init --custom-config /tmp/config > /tmp/mxaddmirrors.planВыполнение развертывания.
$ mxaddmirrors setup --plan-file /tmp/mxaddmirrors.plan --mode cliСгенерированный конфигурационный файл имеет формат CSV:
0||7000|
1||7000|content_id, hostname, port и rootdir of datadir (используются для создания каталогов и файлов различных баз данных).content_id не должно быть пустым и должно быть уникальным. Все измененные параметры применяются немедленно — результат соответствует тому, что вы видите.Примечание!
YMatrix 5 представляет новую архитектуру базы данных. Для добавления зеркал представлен инструментmxaddmirrors, который несовместим сgpaddmirrors. В более ранних версиях использовалась утилитаgpaddmirrors.