Управление кластером

Документ представляет основные операции и обслуживание кластеров MatrixDB, которые в основном включают два аспекта:

  • Управление через командную строку: базовые операции управления кластером
  • Графическое управление и обслуживание: интуитивный мониторинг состояния кластера

1. Управление через командную строку

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

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

Команда gpstart -a запускает кластер MatrixDB.

[mxadmin@mdw ~]$ gpstart -a
20210723:16:00:36:002624 gpstart:sdw2:mxadmin-[INFO]:-Starting gpstart with args: -a
20210723:16:00:36:002624 gpstart:sdw2:mxadmin-[INFO]:-Gathering information and validating the environment...
20210723:16:00:36:002624 gpstart:sdw2:mxadmin-[INFO]:-Greenplum Binary Version: 'postgres (MatrixDB) 4.1.0-community (Greenplum Database) 7.0.0+dev.16905.gc6dbf4f14d build commit:c6dbf4f14d4452a414198fd45d507819803fffb2'

......

20210723:16:00:38:002624 gpstart:sdw2:mxadmin-[INFO]:-Database successfully started

Примечание!
Подробные способы использования gpstart см. в Документации.

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

Команда gpstop -a используется для остановки работающего кластера.

[mxadmin@mdw ~]$ gpstop -a
20210723:16:08:41:002827 gpstop:sdw2:mxadmin-[INFO]:-Starting gpstop with args: -a
20210723:16:08:41:002827 gpstop:sdw2:mxadmin-[INFO]:-Gathering information and validating the environment...

......

20210723:16:08:43:002827 gpstop:sdw2:mxadmin-[INFO]:-Successfully shutdown 1 of 1 segment instances
20210723:16:08:43:002827 gpstop:sdw2:mxadmin-[INFO]:-Database successfully shutdown with no errors reported

Предварительным условием для остановки кластера с помощью gpstop -a является отсутствие активных подключений; в противном случае операция будет приостановлена до завершения всех других подключений.
Если необходимо принудительно завершить пользовательские подключения и остановить кластер, используйте gpstop -a -M fast.

1.2.1 Перезапуск кластера

gpstop -ar позволяет перезапустить кластер.

1.2.2 Перезагрузка конфигурации авторизации

После изменения конфигурации авторизации в файле pg_hba.conf необходимо выполнить gpstop -u для перезагрузки конфигурации авторизации.

Примечание!
Подробные способы использования gpstop см. в Документации.

1.3 Проверка состояния кластера

gpstate позволяет просмотреть состояние работы кластера, включая:

  • Конфигурацию главного узла и узлов данных
  • Конфигурацию зеркальных копий и т.д.
    
    [mxadmin@mdw ~]$ gpstate
    20210723:17:00:15:004109 gpstate:sdw2:mxadmin-[INFO]:-Starting gpstate with args:

......

20210723:17:00:15:004109 gpstate:sdw2:mxadmin-[INFO]:-Obtaining Segment details from master... 20210723:17:00:15:004109 gpstate:sdw2:mxadmin-[INFO]:-Gathering data from segments... 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:-Greenplum instance status summary 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:----------------------------------------------------- 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Master instance = Active 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Master standby = No master standby configured 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total segment instance count from metadata = 1 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:----------------------------------------------------- 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Primary Segment Status 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:----------------------------------------------------- 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total primary segments = 1 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total primary segment valid (at master) = 1 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total primary segment failures (at master) = 0 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total number of postmaster.pid files missing = 0 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total number of postmaster.pid files found = 1 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total number of postmaster.pid PIDs missing = 0 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total number of postmaster.pid PIDs found = 1 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total number of /tmp lock files missing = 0 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total number of /tmp lock files found = 1 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total number postmaster processes missing = 0 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Total number postmaster processes found = 1 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:----------------------------------------------------- 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Mirror Segment Status 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:----------------------------------------------------- 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:- Mirrors not configured on this array 20210723:17:00:16:004109 gpstate:sdw2:mxadmin-[INFO]:-----------------------------------------------------


### 1.4 Изменение конфигурации кластера

`gpconfig` используется для просмотра или изменения параметров конфигурации в файле `postgresql.conf`.

#### 1.4.1 Просмотр конфигурации

Конфигурацию можно просмотреть, указав имя параметра:

[mxadmin@mdw ~]$ gpconfig -s shared_buffers Values on all segments are consistent GUC : shared_buffers Master value: 1078464kB Segment value: 1078464kB


#### 1.4.2 Изменение конфигурации

Изменение конфигурации выполняется через `gpconfig -c <config name> -v <value>`:

[mxadmin@mdw ~]$ gpconfig -c shared_buffers -v 128MB 20210723:17:13:35:004318 gpconfig:sdw2:mxadmin-[INFO]:-completed successfully with parameters '-c shared_buffers -v 128MB'


После изменения конфигурации необходимо перезапустить кластер, чтобы изменения вступили в силу:

[mxadmin@mdw ~]$ gpstop -ar


После перезапуска проверьте конфигурацию:

[mxadmin@mdw ~]$ gpconfig -s shared_buffers Values on all segments are consistent GUC : shared_buffers Master value: 128MB Segment value: 128MB


>***Примечание!***  
Подробные способы использования `gpconfig` см. в [Документации](/ru/doc/4.8/tools/gpconfig).

## 2. Графическое управление и обслуживание

Понимание операций и обслуживания кластера позволяет не только выполнять базовые операции управления, но и четко отслеживать состояние работы базы данных — например, насколько высока нагрузка на узлы, стабильно ли работает каждый экземпляр и т.д.  
Для обеспечения лучшего пользовательского опыта YMatrix предоставляет мониторинг ключевых показателей и визуализацию топологии базы данных, периодически собирая такие показатели, как загрузка CPU, использование памяти и состояние экземпляров, и отображая их в реальном времени, что позволяет наглядно наблюдать за работой базы данных.

### 2.1 Подготовка

Сначала необходимо войти в графический интерфейс. Введите IP-адрес машины, где запущен процесс MXUI (по умолчанию — IP главного узла), и номер порта:

http://:8240



### 2.2 Управление кластером

#### 2.2.1 Просмотр показателей

После успешного входа перейдите на страницу «Управление кластером» — по умолчанию отображается «Просмотр метрик», включающий две части:
1. Информация о кластере: статус кластера, объем данных, количество узлов и версия базы данных.
2. Информация о метриках: использование ресурсов подключений к базе данных, ключевые показатели каждого узла. YMatrix автоматически собирает и отображает эти метрики каждые 5 секунд, включая загрузку CPU, использование памяти, дисковый и сетевой ввод-вывод, количество подключений и т.д.

![](https://image.ymatrix.cn/jsdelivr-web/web/doc-images/maintain/management_09_en.png)

#### 2.2.2 Просмотр экземпляров

Переключитесь на «Просмотр экземпляров» — информация о каждом узле отображается в виде статуса и распределения экземпляров.

![](https://image.ymatrix.cn/jsdelivr-web/web/doc-images/maintain/management_10_en.png)

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

![](https://image.ymatrix.cn/jsdelivr-web/web/doc-images/maintain/management_11_en.png)

#### 2.2.3 Списковый просмотр

Переключитесь на «Списковый просмотр» — информация о каждом узле отображается в виде списка, включая статус экземпляра, DBID, порт, путь хранения и другие параметры.

![](https://image.ymatrix.cn/jsdelivr-web/web/doc-images/maintain/management_12_en.png)