Развертывание кластера под операционной системой Ubuntu 20.04

  • Требования к операционной системе и платформе
Операционная система Поддерживаемая архитектура CPU
Ubuntu 20.04 amd64

Установка сервера

Процесс установки сервера включает 5 шагов: просмотр базовой информации о сервере, подготовку к установке, установку DEB-пакета базы данных, развертывание базы данных и настройку после установки.

1 Просмотр основной информации о сервере

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

Шаг Команды Назначение
1 free -h Просмотр информации об оперативной памяти операционной системы
2 df -h Просмотр дискового пространства
3 lscpu Просмотр количества ядер процессора
4 lsb_release -a Просмотр версии операционной системы
5 uname -a Вывод всей информации о ядре в следующем порядке (если определение -p и -i невозможно, результаты пропускаются): имя ядра; имя хоста в сетевом узле; номер выпуска ядра; версия ядра; имя архитектуры аппаратного обеспечения; тип процессора (непереносимо); аппаратная платформа (непереносимо); имя операционной системы
6 tail -11 /proc/cpuinfo Просмотр информации о процессоре

2 Подготовка к установке

Примечание!
Команды из разделов 2 «Подготовка к установке» и 3 «Установка DEB-пакета базы данных» должны выполняться на всех узлах.

2.1 Обновление списка программного обеспечения

По умолчанию вы уже завершили настройку списка программного обеспечения в файле конфигурации /etc/apt/sources.list. Далее необходимо обновить список программного обеспечения от имени пользователя root или с правами root.

# sudo apt update

APT (Advanced Package Tool) — это расширенный инструмент управления пакетами. Его основные функции связаны с получением и установкой пакетов программного обеспечения. Вы можете загружать пакеты, устанавливать их, анализировать зависимости, обновлять списки программного обеспечения и т.д.

2.2 Настройка региональных параметров (Locale)

Настройте региональные параметры под пользователем root или с использованием прав root.

# sudo apt install -y locales && sudo locale-gen "en_US.UTF-8" && sudo update-locale LC_ALL="en_US.UTF-8"

2.3 Изменение конфигурации машины

Убедитесь, что на всех узлах заданы постоянные имена хостов. Если они отсутствуют, используйте следующую команду для установки имени хоста. Например, на мастер-узле можно задать так:

# hostnamectl set-hostname mdw

Два дочерних узла также должны иметь соответствующие имена хостов:

# hostnamectl set-hostname sdw1
# hostnamectl set-hostname sdw2

Убедитесь, что все узлы кластера могут взаимно обращаться друг к другу по имени хоста и IP-адресу. Сначала установите инструмент vim.

# sudo apt install vim

Добавьте запись в файл /etc/hosts, сопоставив имя хоста с локальным сетевым адресом. Например, файл /etc/hosts на трех узлах может содержать примерно следующее:

# sudo vim /etc/hosts
192.168.100.10 mdw
192.168.100.11 sdw1
192.168.100.12 sdw2

После ввода нажмите esc для выхода, затем введите :wq, чтобы сохранить изменения.

2.4 Копирование DEB-пакетов с локального компьютера на сервер

Примечание!
Ссылку для скачивания DEB-пакета можно получить из официального электронного письма.

Скопируйте предстоящие к установке DEB-пакеты со своего локального компьютера на все узлы.

~ scp <local path> <username>@<Server IP address>: <server path>

3 Установка DEB-пакета YMatrix

Установите DEB-пакет YMatrix от имени пользователя root или с правами root.

# sudo apt install -y /path/to/matrixdb5_5.0.0+enterprise-1_amd64.deb

Примечание!
Во время фактической установки замените имя файла на актуальное имя последнего загруженного DEB-пакета, /path/to/ — на корректный путь, а если используется текущий путь, укажите ./.

После успешной установки автоматически запустятся процессы supervisor и MXUI. Эти фоновые процессы предоставляют графический интерфейс и службы управления процессами. Если требуется настроить порты, измените файл /etc/matrixdb5/defaults.conf после установки DEB-пакета. Эта операция выполняется только на мастер-узле.

# vim /etc/matrixdb5/defaults.conf

4 Установка зависимостей Python и настройка версии Python по умолчанию

На всех узлах выполните следующую команду от имени пользователя root или с помощью прав sudo для установки пакетов Python, от которых зависит YMatrix. Обратите внимание, что необходимо выполнить source greenplum_path.sh, чтобы была установлена правильная версия зависимых пакетов.

# sudo apt install -y \
   gcc \
   python3-dev \
   python3-pip \
   python3-psutil \
   python3-pygresql \
   python3-testresources
# sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 50

5 Развертывание базы данных

Здесь по-прежнему используется графическое развертывание, предоставляемое YMatrix. Для удаленного графического развертывания должны быть доступны порты 8240 и 4617. После установки эти порты будут открыты по умолчанию на всех узлах. Служба графического интерфейса предоставляется процессом MXUI.

Примечание!
Если вы не можете развернуть YMatrix с помощью графического интерфейса, обратитесь к разделу Развертывание из командной строки.

Откройте в браузере URL-адрес мастера установки, указав IP-адрес сервера mdw:

http://<IP>:8240/

На первой странице мастера установки необходимо ввести пароль суперпользователя, который можно посмотреть с помощью команды sudo more /etc/matrixdb5/auth.conf.

На второй странице выберите «Развертывание на нескольких узлах» и нажмите «Далее».


Далее начнется четырехэтапный процесс развертывания на нескольких машинах.

Первый шаг — добавление узлов. Нажмите кнопку «Добавить».

Введите IP-адреса, имена хостов или полные доменные имена sdw1 и sdw2 в текстовое поле, нажмите «Подтвердить», затем «Далее».


Второй шаг — настройка параметров кластера. «Зеркалирование данных» определяет, будут ли узлы данных кластера содержать резервные копии. Рекомендуется включить эту опцию в производственной среде для обеспечения высокой доступности кластера. Система автоматически предлагает использовать диски с наибольшим объемом памяти и количество сегментов, соответствующее ресурсам системы, которые можно скорректировать в зависимости от конкретного сценария использования. Структуру кластера можно просмотреть на схеме. После подтверждения нажмите «Далее».


Третий шаг — настройка путей хранения данных и пути etcd. Для каждого сервера необходимо выбрать путь хранения etcd. Кластер etcd будет случайным образом создан на нечетных серверах, чтобы гарантировать уникальность результатов выборов и избежать ничьих.

Если вы установите флажок в правом верхнем углу для развертывания etcd на диске данных, вам следует ознакомиться с известными рисками.


Шаг 4: Выполнение развертывания. На этом этапе будут перечислены параметры конфигурации из предыдущих действий. После проверки правильности нажмите «Развернуть».

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

Развертывание завершено.

6 Настройка после установки

6.1 Настройка sysstat

На всех узлах измените файл sysstat, заменив ENABLED="false" на ENABLED="true", затем нажмите esc, введите esc, затем :wq, чтобы сохранить и выйти.

# sudo vi /etc/default/sysstat

Перезапустите службу.

# sudo service sysstat restart

6.2 Удаленное подключение к базе данных

По умолчанию установленная версия YMatrix поддерживает удаленные подключения. Если во время установки не был установлен флажок «Разрешить удаленное подключение к базе данных», вручную измените файл $MASTER_DATA_DIRECTORY/pg_hba.conf, добавив строку следующего вида, разрешающую пользователям с любого IP-адреса подключаться ко всем базам данных с аутентификацией по паролю. Диапазон IP-адресов или имена баз данных можно ограничить в соответствии с реальными потребностями, чтобы снизить риски безопасности:

# host all all 0.0.0.0/0 md5

После внесения этих изменений выполните следующую команду для перезагрузки конфигурационного файла pg_hba.conf:

# mxstop -u

5.3 Использование инструментов управления базой данных

Запуск, остановка, перезапуск и просмотр состояния YMatrix можно выполнить с помощью следующих команд:

Команда Назначение
mxstop -a Остановить кластер. (В этом режиме, если есть активное сеансовое соединение, закрытие базы данных может зависнуть)
mxstop -af Быстрая остановка кластера
mxstop -arf Перезапуск кластера. Ожидание завершения текущего SQL-запроса (в этом режиме, если есть активное сеансовое соединение, закрытие базы данных может зависнуть)
mxstate -s Просмотр состояния кластера