Быстрый старт
Развертывание
Моделирование данных
Подключение
Запись данных
Миграция
Запросы
Операции и обслуживание
Типовое обслуживание
Секционирование
Резервное копирование и восстановление
Масштабирование
Мониторинг
Настройка производительности
Устранение неполадок
Справочник
Руководство по инструментам
Типы данных
Хранилище данных
Выполняющая система
Потоковая передача
Восстановление после сбоев
Конфигурация
Индексы
Расширения
Справочник по SQL
Часто задаваемые вопросы
В этом документе описывается инструмент добавления зеркальных узлов (Mirror) mxaddmirrors.
mxaddmirrors можно добавить зеркальные узлы в систему YMatrix, развернутую изначально без них, и запустить процесс онлайн-репликации между основными сегментами (Primary) и соответствующими им зеркалами.Примечание!
Процесс добавления зеркал требует значительных системных ресурсов: пропускной способности сети, операций ввода-вывода и вычислительной мощности ЦП. Если система находится под высокой нагрузкой, это может повлиять на текущие бизнес-операции.
Рекомендуется выполнять процесс добавления зеркал при простое базы данных, минимизируя активные запросы и общую нагрузку на систему.
Ниже приведено подробное описание аргументов командной строки:
| Подкоманда | Параметр | Описание | Необязательный |
|---|---|---|---|
| config | Создает пользовательский конфигурационный файл | ||
| --db-cluster-id | Идентификатор кластера базы данных. Используется для идентификации уникального кластера | Необязательный | |
| --filename | Сохраняет созданный конфигурационный файл по указанному пути. Если файл не существует, он будет создан автоматически. Также можно использовать перенаправление вывода | Необязательный | |
| init | Собирает информацию о системе и формирует базовый план | ||
| --db-cluster-id | Идентификатор кластера базы данных. Хранится в файле /etc/matrixdb6/cluster.conf. При наличии одного кластера используйте последнее значение ClusterID; при нескольких кластерах выберите подходящее значение --db-cluster-id для целевого кластера |
Обязательный | |
| --mirror-port-base | Начальный порт, с которого начинается поиск свободного порта для процессов Mirror. По умолчанию поиск начинается с порта 7000 |
Необязательный | |
| plan | Формирует план развертывания | ||
| --init-file | Абсолютный путь к файлу, полученному в результате перенаправления вывода команды init |
Обязательный | |
| --custom-config | Абсолютный путь к файлу, созданному командой config |
Необязательный | |
| setup | Выполняет план развертывания | ||
| --plan-file | Абсолютный путь к файлу, полученному в результате перенаправления вывода команды plan |
Обязательный |
Примечание!
Если допустимо использование значений по умолчанию, необходимо указывать только обязательные параметры.
Команда mxaddmirrors должна выполняться пользователем с правами sudo на хосте мастера (за исключением mxadmin, используйте абсолютный путь /opt/ymatrix/matrixdb6/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/configconfig:$ 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. В версиях до YMatrix 5 используйте инструментgpaddmirrors.