Деинсталляция и повторная установка кластера

В этом документе описаны шаги по удалению и повторной установке YMatrix 5 в кластере. В качестве примера используется три узла: основной узел — mdw, два узла данных — sdw1 и sdw2 соответственно.

Перед выполнением операций внимательно прочитайте следующие указания:

  • Если вы считаете, что больше не нуждаетесь в программном обеспечении YMatrix и во всех данных существующего кластера, и хотите полностью удалить исходный кластер и программное обеспечение YMatrix, необходимо выполнить раздел «1 Удаление YMatrix»;
  • Если вы просто хотите повторно установить программное обеспечение YMatrix, но не хотите терять исходные данные, необходимо выполнить раздел «2 Повторная установка YMatrix»;

Примечание!
Разделы 1 и 2 являются независимыми друг от друга. Выберите один из них в соответствии с приведёнными выше инструкциями. Не выполняйте оба!

1 Удаление YMatrix

1.1 Удаление кластера

Сначала необходимо подготовиться к удалению или переустановке. Этот шаг является обязательным, иначе он может помешать процессу удаления. Завершите терминал, открытый через psql, с помощью метакоманды \q.

postgres=# \q

Выполните команду mxdeletesystem на мастер-узле для удаления экземпляра базы данных и данных.

$ mxdeletesystem -a

1.2 Удаление программного обеспечения YMatrix

Примечание!
Команды, приведённые в этой статье, рассчитаны на операционную систему CentOS 7. Если вы используете CentOS 8, замените команду yum на dnf; если вы используете систему Ubuntu, замените команду yum на apt.

Сначала необходимо определить имя установленной программы кластера с помощью следующей команды:

[<username>@mdw ~]$ yum list installed | grep matrixdb
matrixdb5.x86_64                   5.0.0+enterprise~beta.5-1.el7 installed

Примечание!
В Ubuntu 20.04 после установки кластера для получения имени программы требуется использовать sudo apt list --installed | grep matrixdb.

Затем удалите программу. Данный шаг полностью удалит программное обеспечение YMatrix. Команда должна выполняться с правами sudo или от имени пользователя root на всех узлах.

[<username>@mdw ~]$ sudo yum remove -y matrixdb5.x86_64

#or

[<username>@mdw ~]$ sudo yum erase -y matrixdb5.x86_64

2 Повторная установка YMatrix

Если вы используете этот раздел, можете быть уверены, что при удалении и повторной установке более новой версии или той же версии в рамках основной версии YMatrix 5 ваши данные кластера не будут потеряны. Например, обновление с YMatrix 5.5 до YMatrix 5.6; удаление YMatrix 5.5 и повторная установка YMatrix 5.5.

2.1 Остановка кластера

Сначала необходимо остановить кластер, чтобы подготовиться к удалению или переустановке. Этот шаг является обязательным, иначе он может помешать процессу удаления.

Завершите терминал, открытый через psql, с помощью метакоманды \q.

postgres=# \q

В примере можно использовать режим fast для остановки процесса кластера. При необходимости также можно выбрать режим smart или immediate. В таблице ниже описаны различия между ними.

[mxadmin@mdw ~]$ mxstop -a -M fast
режим mxstop параметры запрет новых подключений ожидание завершения процессов Является ли режимом по умолчанию
smart -M smart Да Да
fast -M fast Да Нет, прерываются соединения, откат транзакций Нет
immediate -M immediate Да Нет, процессы завершаются принудительно Нет

2.2 Удаление YMatrix

Необходимо выполнить действия из раздела «1.2 Удаление программного обеспечения YMatrix» выше. Этот шаг полностью удалит предыдущую версию программного обеспечения YMatrix.

2.3 Повторная установка YMatrix

Примечание!
Если вы используете операционную систему CentOS 8, замените yum на dnf; если вы используете систему Ubuntu, замените команду yum на apt.

Повторно установите необходимый RPM-пакет. Эта операция выполняется от имени обычного пользователя.

[<username>@mdw ~]$ sudo yum install -y matrixdb-5.0.0+community-1.el7.x86_64.rpm

2.4 Запуск кластера

После инициализации кластера вернитесь в командную строку и подключитесь под пользователем mxadmin с использованием прав sudo.

[<username>@mdw ~]$ sudo su - mxadmin

Затем используйте утилиту mxstart для запуска кластера.

[mxadmin@mdw ~]$ mxstart -a

После успешного запуска кластера графический интерфейс также будет работать в штатном режиме.