В этом документе описаны шаги по быстрому развертыванию YMatrix на одном узле.
Примечание!
Для развертывания кластера с несколькими узлами обратитесь к разделу Стандартное развертывание кластера.
Примечание!
Быстрая установка поддерживается только на операционных системах, таких как CentOS 7 и RedHat 7. Инструкции по развертыванию на Ubuntu 20.04 доступны здесь. Инструкции по развертыванию на CentOS 8 или RedHat 8 доступны здесь.
Примечание!
Видеоинструкции доступны по ссылке Установка и развертывание YMatrix. Если хост не имеет доступа к Интернету, обратитесь к разделу Развертывание оффлайн-кластера.
Перед установкой, пожалуйста, скачайте установщик YMatrix.
Установка сервера состоит из двух этапов: подготовки и развертывания базы данных. Также рассматриваются дополнительные настройки после установки и базовые команды управления базой данных.
Скопируйте RPM-пакет с локального компьютера на удалённый сервер:
~ scp <local path> <username>@<server IP address>:<server path>
Примечание!
Начиная с этого шага, все операции должны выполняться от имени пользователя root или с правами sudo.
YMatrix требует Python 3.6. Установите его и задайте в качестве версии по умолчанию с помощью следующих команд:
$ sudo yum install centos-release-scl $ sudo yum install rh-python36 $ sudo scl enable rh-python36 bash
Отключите брандмауэр:
$ sudo systemctl stop firewalld.service $ sudo systemctl disable firewalld.service
Отключите SELinux. Отредактируйте файл /etc/selinux/config и установите значение параметра SELINUX равным disabled:
$ sudo sed s/^SELINUX=.*$/SELINUX=disabled/ -i /etc/selinux/config $ sudo setenforce 0
Убедитесь, что узел установки имеет постоянное имя хоста. Если нет — задайте его с помощью команды ниже (в примере имя хоста установлено как mdw):
$ sudo hostnamectl set-hostname mdw
Отредактируйте файл /etc/hosts. Если вы используете vim впервые, установите его с помощью команды sudo yum install vim:
$ sudo vim /etc/hosts
Свяжите имя хоста с адресом сетевого интерфейса. После редактирования нажмите Esc, затем введите ：wq, чтобы сохранить изменения и выйти:
192.168.100.10 mdw
Примечание!
Не дублируйте запись<IP address> <hostname>в файле/etc/hosts. Это может привести к ошибке "host network connectivity test failed" при инициализации графического интерфейса.
Установите RPM-пакет базы данных с помощью команды yum от имени root или с правами sudo. Зависимости системы будут установлены автоматически. По умолчанию YMatrix устанавливается в каталог /opt/ymatrix/matrixdb5:
$ sudo yum install matrixdb5-5.0.0+enterprise_5.0.0-1.el7.x86_64.rpm
Примечание!
На практике замените имя файла на актуальное имя скачанного RPM-пакета.
После успешной установки автоматически запускаются процессы supervisord и MXUI. Эти фоновые службы обеспечивают работу графического интерфейса и управление процессами.
Если необходимо настроить порты, измените файл /etc/matrixdb5/defaults.conf после установки RPM-пакета. Эта настройка требуется только на мастер-узле.
$ vim /etc/matrixdb5/defaults.conf
YMatrix предоставляет простой способ развертывания через графический интерфейс или командную строку. Рекомендуется использовать графический метод. Для удалённого доступа к GUI необходимо открыть порты 8240 и 4617. Веб-интерфейс обеспечивается процессом MXUI.
Откройте мастер установки в браузере, используя IP-адрес мастер-сервера:
http://<IP>:8240/
На первой странице введите пароль суперпользователя. Его можно просмотреть с помощью команды sudo more /etc/matrixdb5/auth.conf:
На второй странице автоматически выбирается опция "Single Node Deployment". Нажмите Далее.
Выполните следующие три шага для развертывания на одном узле.
Шаг 1: Укажите количество экземпляров, путь к хранилищу и пароль администратора. Нажмите "Deploy Now".
Шаг 2: Начинается развертывание. Ход выполнения отображается в реальном времени.
Шаг 3: Завершение. После успешного развертывания нажмите "Finish".
YMatrix также поддерживает однократное развертывание через командную строку. Выполните следующие команды. После завершения база данных запустится автоматически:
source /opt/ymatrix/matrixdb5/greenplum_path.sh sudo env "PATH=$PATH" mxsetup
После развертывания автоматически запускается процесс Cylinder. Он активирует запланированные задачи с заданными интервалами.
Подключитесь по SSH к серверу и переключитесь на пользователя-администратора YMatrix mxadmin:
$ sudo su - mxadmin
По умолчанию YMatrix разрешает удалённые подключения. Если во время установки не была выбрана опция "Allow remote connection to database", вручную добавьте строку вида ниже в файл $MASTER_DATA_DIRECTORY/pg_hba.conf, чтобы разрешить любому IP-адресу подключаться с аутентификацией по паролю ко всем базам данных. При необходимости скорректируйте диапазон IP-адресов или имена баз данных, чтобы снизить риски безопасности:
$ host all all 0.0.0.0/0 md5
Для удобства удалённого доступа и проверки корректной инициализации задайте пароль пользователю mxadmin (замените mxpass на желаемый пароль):
$ psql -c "alter role mxadmin with password 'mxpass'" -h localhost -p 5432 mxdb
После внесения изменений перезагрузите конфигурацию, выполнив:
pg_hba.conf
$ mxstop -u
``
Подключитесь по SSH к серверу и переключитесь на пользователя mxadmin:
$ sudo su - mxadmin
Используйте следующие команды для управления базой данных:
$ mxstart -a $ mxstop -af $ mxstop -arf $ mxstate -s
| Команда | Назначение |
|---|---|
| mxstop -a | Остановка кластера. (Будет зависать, если есть активные сессии.) |
| mxstop -af | Принудительная остановка кластера. |
| mxstop -ar | Перезапуск кластера. Ожидает завершения выполняемых SQL-запросов. (Будет зависать, если есть активные сессии.) |
| mxstate -s | Проверка состояния кластера. |
YMatrix можно установить на оборудование с низкими характеристиками. Минимальные требования:
| Минимальные требования |
|---|
| Двухъядерный CPU 1 ГГц |
| 2 ГБ ОЗУ |
| 2 ГБ места на диске |
| RAID 1 (зеркалирование) |
Если установка выполняется на устройство с объёмом ОЗУ менее 2 ГБ, перед установкой создайте swap-пространство размером не менее 2 ГБ.
Создайте и активируйте swap-файл размером 2 ГБ: `` sudo dd if=/dev/zero of=/opt/swapfile count=2048 bs=1MiB sudo chmod 600 /opt/swapfile
sudo mkswap /opt/swapfile sudo swapon /opt/swapfile
swapon -s free -m ``
Добавьте следующую строку в файл , чтобы сделать swap-пространство постоянным: `/etc/fstab` /opt/swapfile swap swap sw 0 0
YMatrix совместим с протоколом PostgreSQL 12. Многие коммерческие и открытые клиентские инструменты PostgreSQL 12 (например, DBeaver, pgAdmin) могут подключаться к YMatrix. Вы можете легко получать доступ к YMatrix удалённо с ноутбуков или персональных компьютеров. Подробности см. в разделе Подключение клиента.
Командную утилиту YMatrix psql также можно использовать удалённо на Windows или Mac. Пользователи Mac могут установить её через brew:
$ brew install libpq $ brew link --force libpq ail
Пользователи Windows могут скачать установщик здесь.
После установки psql используйте параметр для указания хоста и `-h` для указания порта при подключении к серверу YMatrix. Распространённые параметры `psql` включают: `-p` $ psql -h [hostname or IP] -p [port] -U [username] -W -d [database name]
Пример:
$ psql -h 127.0.0.1 -p 5432 -U mxadmin -W -d mxdb
Приятного использования!
