| Операционная система | Поддерживаемая архитектура CPU |
|---|---|
| Ubuntu 20.04 | amd64 |
Примечание!
Данный учебник ограничен 64-битными пакетами установки. Если вам нужны 32-битные пакеты, подготовьте их самостоятельно.
Процесс установки сервера включает 5 шагов: просмотр базовой информации о сервере, подготовку к установке, установку DEB-пакета базы данных, развертывание базы данных и настройку после установки.
Перед выполнением установки сначала проверьте основную информацию о сервере. Это хорошая практика, которая поможет вам лучше спланировать и развернуть кластер.
| Шаг | Команда | Назначение |
|---|---|---|
| 1 | free -h | Просмотр информации об оперативной памяти ОС |
| 2 | df -h | Просмотр места на диске |
| 3 | lscpu | Просмотр количества ядер CPU |
| 4 | lsb_release -a | Просмотр информации о версии операционной системы |
| 5 | uname -a | Вывод всей информации о ядре в следующем порядке (если определение -p и -i невозможно, результаты пропускаются): имя ядра; имя хоста в сетевом узле; номер выпуска ядра; версия ядра; имя архитектуры аппаратного обеспечения; тип процессора (непереносимо); аппаратная платформа (непереносимо); имя операционной системы |
| 6 | tail -11 /proc/cpuinfo | Просмотр информации о CPU |
Примечание!
Команды из разделов 2 «Подготовка к установке» и 3 «Установка DEB-пакета базы данных» должны выполняться на всех узлах.
Сначала загрузите сжатый пакет автономного репозитория с официального сайта: matrixdb_local_repo_ubuntu20.tar.
Скопируйте сжатый пакет локально на все узлы.
~ scp <local file path> <username>@<server IP address>:<server file path>Распакуйте установочный пакет от имени пользователя root или с правами root.
# tar xf matrixdb_local_repo_ubuntu20.tarПосле завершения выполнения вы увидите matrixdb_local_repo в текущей директории, который содержит необходимые нам DEB-пакеты.
Выполните следующую команду от имени пользователя root или с правами root:
# sudo su
# rm -rf /usr/local/matrixdb_local_repo
# mv matrixdb_local_repo /usr/local
# mv /etc/apt/sources.list /etc/apt/sources.list.bak
# echo "deb [arch=amd64 trusted=yes] file:/usr/local/matrixdb_local_repo ./" > /etc/apt/sources.list
# apt update
# apt upgrade -yAPT (Advanced Package Tool) — это расширенный инструмент управления пакетами. Его основные функции связаны с получением и установкой пакетов программного обеспечения. Он позволяет загружать пакеты, устанавливать пакеты, анализировать зависимости между пакетами, обновлять списки программного обеспечения и т.д.
Настройте региональные параметры от имени пользователя root или с правами root.
# sudo apt install -y locales && sudo locale-gen "en_US.UTF-8" && sudo update-locale LC_ALL="en_US.UTF-8"Убедитесь, что на всех узлах заданы постоянные имена хостов. Если они отсутствуют, используйте следующую команду для установки имени хоста. Например, на мастер-узле можно задать так:
# hostnamectl set-hostname mdwДва дочерних узла также должны иметь соответствующие имена хостов:
# hostnamectl set-hostname sdw1# hostnamectl set-hostname sdw2Убедитесь, что все узлы кластера могут взаимно обращаться по имени хоста и IP-адресу. Добавьте запись в файл /etc/hosts, сопоставив имя хоста с адресом локального сетевого интерфейса. Например, файл /etc/hosts на трёх узлах может содержать примерно следующее:
192.168.100.10 mdw
192.168.100.11 sdw1
192.168.100.12 sdw2Установите DEB-пакет YMatrix от имени пользователя root или с правами root.
# sudo apt install -y /path/to/matrixdb5_5.0.0+enterprise-1_amd64.debПримечание!
Во время фактической установки замените имя файла на актуальное имя скачанного DEB-пакета. Ссылку на скачивание DEB-пакета можно получить из официального письма. Замените/path/to/на корректный путь, а если используется текущий путь, замените./.
После успешной установки автоматически запустятся процессы supervisor и MXUI. Эти фоновые процессы обеспечивают графический интерфейс и сервисы управления процессами.
Если требуется настроить порты, измените файл /etc/matrixdb5/defaults.conf после установки DEB-пакета. Эта операция выполняется только на мастер-узле.
# vim /etc/matrixdb5/defaults.confЗдесь по-прежнему используется графическое развертывание от YMatrix. Для удалённого графического развертывания необходимо, чтобы порты 8240 и 4617 сервера были доступны. После установки эти порты будут открыты по умолчанию на всех узлах. Графический интерфейс UI предоставляется процессом MXUI.
Примечание!
Если вы не можете развернуть YMatrix через графический интерфейс, обратитесь к разделу Развертывание через командную строку.
Откройте в браузере URL мастера установки, указав IP-адрес сервера mdw:
http://<IP>:8240/На первой странице мастера установки необходимо ввести пароль суперпользователя, который можно посмотреть с помощью команды sudo more /etc/matrixdb5/auth.conf.
На второй странице выберите «Развертывание на нескольких узлах» и нажмите «Далее».
Далее начнётся четырёхэтапное развертывание на нескольких машинах.
Первый шаг — добавление узлов. Нажмите кнопку «Добавить узел».
Введите IP-адреса, имена хостов или полные доменные имена sdw1 и sdw2 в текстовое поле, нажмите «ОК», затем «Далее».
Второй шаг — настройка параметров кластера. Параметр «Зеркалирование данных» определяет, будут ли узлы данных кластера содержать резервные копии. Рекомендуется включить его в производственной среде для обеспечения высокой доступности кластера. Система автоматически предлагает максимальное пространство дисков и количество сегментов, соответствующих ресурсам системы, которые можно скорректировать в зависимости от конкретного сценария использования. Структуру кластера можно просмотреть на схеме. Подтвердив настройки, нажмите «Далее».
Третий шаг — настройка путей хранения.
Четвёртый шаг — выполнение развертывания. На этом этапе будут перечислены параметры конфигурации из предыдущих действий. После проверки корректности нажмите «Выполнить развертывание».
Система автоматически развернёт кластер и покажет подробные шаги и ход выполнения. После успешного завершения всех шагов развертывание будет завершено.
Развертывание завершено.
На всех узлах измените файл sysstat, заменив ENABLED="false" на ENABLED="true", затем нажмите esc, введите :wq, сохраните и выйдите.
# sudo vi /etc/default/sysstatПерезапустите службу.
# sudo service sysstat restartПо умолчанию установка YMatrix поддерживает удалённые подключения. Если во время установки не был установлен флажок «Разрешить удалённое подключение к базе данных», вручную измените файл $MASTER_DATA_DIRECTORY/pg_hba.conf, добавив строку следующего вида, разрешающую пользователям с любого IP-адреса подключаться ко всем базам данных с аутентификацией по паролю. Диапазон IP-адресов или имена баз данных можно ограничить в соответствии с реальными потребностями, чтобы снизить риски безопасности:
# host all all 0.0.0.0/0 md5После внесения этих изменений выполните следующую команду для перезагрузки конфигурационного файла pg_hba.conf:
# mxstop -uЗапуск, остановка, перезапуск и просмотр состояния YMatrix могут быть выполнены с помощью следующих команд:
| Команда | Назначение |
|---|---|
| mxstop -a | Остановить кластер. (В этом режиме, если есть активные сессии, закрытие базы данных может зависнуть) |
| mxstop -af | Быстрая остановка кластера |
| mxstop -arf | Перезапуск кластера. Ожидание завершения текущего SQL-запроса (в этом режиме, если есть активные сессии, закрытие базы данных может зависнуть) |
| mxstate -s | Просмотр состояния кластера |