Обзор команд pxf cluster

Антон Монаков

Команды pxf cluster используются для централизованного управления сервисами PXF на мастер-хосте, резервном мастер-хосте и всех сегмент-хостах Greengage DB.

ПРИМЕЧАНИЕ

Для управления сервисами PXF отдельно на каждом хосте используйте команду pxf.

Синтаксис команды в общем виде выглядит следующим образом:

$ pxf cluster <command> [<option>]

где <command> — одна из следующих команд.

Команда Описание

Команда	Описание
help	Выводит справочную информацию о команде `pxf cluster`
init	(Устаревшая команда) Эквивалентна команде `register` и будет удалена в будущих релизах PXF
migrate	Производит миграцию конфигурации PXF 5 из каталога $PXF_CONF в каталог $PXF_BASE на каждом хосте Greengage DB. При запуске команды требуется указать каталог конфигурации PXF 5 с помощью переменной окружения `PXF_CONF`. PXF мигрирует конфигурацию версии 5 в каталог $PXF_BASE, копируя и объединяя каталоги и файлы по необходимости. Обратите внимание, что все измененные настройки из файла pxf-log4j.properties необходимо вручную перенести в файл pxf-log4j2.xml
prepare	Копирует шаблоны файлов конфигурации в каталог $PXF_BASE на каждом хосте Greengage DB. Каталог должен быть указан с помощью переменной окружения `PXF_BASE`
register	Копирует управляющий файл расширения PXF из каталога установки PXF в каталог установки Greengage DB на каждом хосте. Чтобы выполнить команду, требуется, чтобы была установлена переменная окружения `GPHOME`. Команда запускается один раз после установки PXF или обновления Greengage DB
reset	(Устаревшая команда) Не производит никаких действий и будет удалена в будущих релизах PXF
restart	Перезапускает сервис PXF на мастер-хосте, резервном мастер-хосте и всех сегмент-хостах
reload	Перезагружает измененный профиль PXF или конфигурацию сервера, чтобы применить изменения и очистить соответствующие пулы подключений. Команду можно запустить со следующими опциями: `-p`, `--profile` — имя профиля для перезагрузки и, соответственно, прерывания всех активных запросов, использующих данный профиль. Профиль перезагружается либо на сервере, указанном в `--server`, либо, если опция `--server` не указана, на всех серверах. `-s`, `--server` — имя конфигурации сервера, на котором следует перезагрузить профиль. Указание профиля обязательно, если указано значение `--server`. `-a`, `--auto` — если опция указана, действие перезагрузки выполняется без подтверждения со стороны пользователем. `-h`, `--help` — выводит справочную информацию о `pxf cluster reload`. ПРИМЕЧАНИЕ Если ни `--profile`, ни `--server` не указаны, все профили PXF перезагружаются на всех серверах.
start	Запускает сервис PXF на мастер-хосте, резервном мастер-хосте и всех сегмент-хостах
status	Отображает статус сервиса PXF на мастер-хосте, резервном мастер-хосте и всех сегмент-хостах
stop	Останавливает сервис PXF на мастер-хосте, резервном мастер-хосте и всех сегмент-хостах
sync	Синхронизирует конфигурацию PXF ($PXF_BASE) между мастер-хостом, резервным мастер-хостом и сегмент-хостами Greengage DB. По умолчанию при выполнении команды копируются и обновляются файлы на целевом хосте. Чтобы PXF также удалял файлы во время синхронизации, используйте опцию `-d` (`--delete`). Если опция указана, все файлы на резервном мастер-хосте и сегмент-хостах, отсутствующие при этом на мастер-хосте, будут удалены. При обновлении пользовательской конфигурации PXF или добавлении новых JAR- или нативных зависимостей требуется перезапустить PXF после синхронизации конфигурации

help

Выводит справочную информацию о команде pxf cluster

init

(Устаревшая команда) Эквивалентна команде register и будет удалена в будущих релизах PXF

migrate

Производит миграцию конфигурации PXF 5 из каталога $PXF_CONF в каталог $PXF_BASE на каждом хосте Greengage DB. При запуске команды требуется указать каталог конфигурации PXF 5 с помощью переменной окружения PXF_CONF. PXF мигрирует конфигурацию версии 5 в каталог $PXF_BASE, копируя и объединяя каталоги и файлы по необходимости. Обратите внимание, что все измененные настройки из файла pxf-log4j.properties необходимо вручную перенести в файл pxf-log4j2.xml

prepare

Копирует шаблоны файлов конфигурации в каталог $PXF_BASE на каждом хосте Greengage DB. Каталог должен быть указан с помощью переменной окружения PXF_BASE

Копирует управляющий файл расширения PXF из каталога установки PXF в каталог установки Greengage DB на каждом хосте. Чтобы выполнить команду, требуется, чтобы была установлена переменная окружения GPHOME. Команда запускается один раз после установки PXF или обновления Greengage DB

reset

(Устаревшая команда) Не производит никаких действий и будет удалена в будущих релизах PXF

restart

Перезапускает сервис PXF на мастер-хосте, резервном мастер-хосте и всех сегмент-хостах

reload

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

Команду можно запустить со следующими опциями:

-p, --profile — имя профиля для перезагрузки и, соответственно, прерывания всех активных запросов, использующих данный профиль. Профиль перезагружается либо на сервере, указанном в --server, либо, если опция --server не указана, на всех серверах.
-s, --server — имя конфигурации сервера, на котором следует перезагрузить профиль. Указание профиля обязательно, если указано значение --server.
-a, --auto — если опция указана, действие перезагрузки выполняется без подтверждения со стороны пользователем.
-h, --help — выводит справочную информацию о pxf cluster reload.

ПРИМЕЧАНИЕ

Если ни --profile, ни --server не указаны, все профили PXF перезагружаются на всех серверах.

start

Запускает сервис PXF на мастер-хосте, резервном мастер-хосте и всех сегмент-хостах

status

Отображает статус сервиса PXF на мастер-хосте, резервном мастер-хосте и всех сегмент-хостах

stop

Останавливает сервис PXF на мастер-хосте, резервном мастер-хосте и всех сегмент-хостах

sync

Синхронизирует конфигурацию PXF ($PXF_BASE) между мастер-хостом, резервным мастер-хостом и сегмент-хостами Greengage DB.

По умолчанию при выполнении команды копируются и обновляются файлы на целевом хосте. Чтобы PXF также удалял файлы во время синхронизации, используйте опцию -d (--delete). Если опция указана, все файлы на резервном мастер-хосте и сегмент-хостах, отсутствующие при этом на мастер-хосте, будут удалены.

При обновлении пользовательской конфигурации PXF или добавлении новых JAR- или нативных зависимостей требуется перезапустить PXF после синхронизации конфигурации

pxf