Управление Avanpost DS из терминала. Утилиты CLI и DSCLI

Навигатор по разделу:

1. Общая информация

Утилита "cli" используется для управления контроллерами Avanpost DS и их конфигурацией, в том числе для управления сайтами репликации и для добавления контроллеров в репликацию. Запускается в терминале на контроллерах домена Avanpost DS.

Примечание:

О настройке репликации и сайтов репликации см. статью "6.10. Управление репликацией" руководства по администрированию.

Утилита "dscli" используется для управления рабочими станциями и серверами в домене Avanpost DS, в том числе для введения хостов в домен и для управления групповыми политиками. Запускается в терминале на серверах и рабочих станциях в домене.

Примечание:

О введении рабочих станций и серверов в домен Avanpost DS с помощью утилиты "dscli" см. статью "6.7. Введение в домен рабочих станций" руководства по администрированию.

Утилита "dscli" — это исполняемый бинарный файл для запуска приложения и обновления версии его базы данных через параметры командной строки.

2. Параметры и ключи утилиты "dscli"

ПараметрНазначениеКлючи
dscli versionВывод версии Avanpost DSНет
dscli renewkeyОбновление ключей Kerberos для рабочих станцийНет
dscli scheduleВывод состояния групповых политик (статус обновления и применения)Нет
dscli gpoВывод списка политик, которые применены на рабочей станцииНет
dscli joinВвод хоста в домен Avanpost DS
КлючЗначение
-dsIP или FQDN адрес контроллера домена (Опциональный ключ, при использовании выполняется привязка к одному КД)
-ds-portПорт Avanpost DS для клиентского взаимодействия по протоколу grpc (Опциональный ключ, по умолчанию "7890")
-domainFQDN домена
-hostnameДоменное имя, с которым рабочая станция будет введена в домен (Опциональный ключ, по умолчанию берет значение из hostname)
-loginЛогин учетной записи с правами Администратора для аутентификации в домене (Опциональный ключ, значение по умолчанию "Administrator")
-password

Пароль учетной записи с правами Администратора для аутентификации в домене. (Опциональный ключ. Если его не использовать утилита запросит ввод пароля.)

-passfileПуть к файлу, содержащему пароль для входа
-trustenabledПринимает значения "true" или "false". Отвечает за включение/выключение доверительных отношений. Значение по умолчанию "false"
-ouOU в домене, в которое требуется добавить данную рабочую станцию. (Пример: ou=MSK,dc=avanpost,dc=local)
dscli repair

Параметр актуален только до версии Avanpost DS 1.6.2. включительно.

Восстановление настроек согласно state.json клиента

3. Параметры и ключи утилиты "cli"

ПараметрНазначениеКлючЗначение
cli add-instanceДобавление нового вторичного КД Avanpost DS в репликацию и загрузка данных из первичного КД-siteСайт, куда будет добавлен вторичный КД (Значение по умолчанию сайт "default")
-hostIP адрес добавляемого КД
-nameFQDN добавляемого КД
-userПользователь с правами добавления контроллеров, от имени которого добавляется КД
-passwordПароль пользователя, от имени которого добавляется КД
-mkey_pathПуть для сохранения kerberos keytab 
cli change-site Перенос контроллера домена из одного сайта в другой-new-siteСайт, куда будет перенесен КД
cli change-rid-master

Назначить КД хозяином относительных идентификаторов (RID master)

Примечание:

КД являющийся RID master - выдает остальным кд и рабочим станциям в домене значения "uidnumber", "gidnumber" и "sid".
О назначении хозяина относительных идентификаторов см. статью "7.8. Назначение хозяина относительных идентификаторов" руководства по настройке и отладке.

-hostnameFQDN контроллера домена, который станет новым RID master
-lastridПоследний выданный RID в домене
cli delete-siteУдаление сайта и перенос всех хостов из него в сайт "default"-siteИмя удаляемого сайта
cli get-configВывод конфигурации клиента-userЛогин учетной записи с правами Администратора Avanpost DS
-passwordПароль учетной записи с правами Администратора Avanpost DS
-outputПуть, по которому будет сохранена копия конфурации клиента
cli utdhwmtablesВывод списка целевых контроллеров домена-dcsАдрес целевого контроллера домена (значение по умолчанию "nil")
cli replicateОтправление принудительного запроса на репликацию-sourcesАдрес контроллера домена, который является источником репликации
-dcsАдреса контроллеров домена, которые являются получателями репликации
-asyncПринимает значения "true" или "false". Отвечает за ожидание процесса репликации. Значение по умолчанию "false". При значении "false" будут возвращаться ошибки в ходе выполнения.
cli entry-replmetaПолучение данных записи real с требуемого контроллера домена-dcsАдрес целевого контроллера домена
-objectdn или uuid объекта
cli replsummaryВывод состояния репликации-dcsАдрес целевого контроллера домена. Ключ можно указывать несколько раз. Например, для отправки запроса двум хостам необходимо указать ключи: --dcs="172.18.0.14"  --dcs="172.18.0.22"
cli replqueueВывод ожидающих запросов на репликацию-dcsАдрес целевого контроллера домена
cli set-link-costУстановка стоимости связей сайтов -costСтоимость связи
-site1Имя первого сайта
-site2Имя второго сайта

cli set-link-schedule


Настройка расписания репликации между сайтами-linkНазвание связи между сайтами
-intervalИнтервал репликации

3.1. Примеры работы с утилитой "cli"

3.1.1. UptdHwmTables

Вывод usn, upToDateness, highWaterMark таблицы:

cli utdhwmtables --dcs="*" --endpoint 172.18.0.11:48910

3.1.2. ReplQueue

Вывод количества партнеров репликации, находящихся в очереди, для выбранного хоста и время последнего цикла репликации:

cli replqueue --dcs="*" --endpoint 172.18.0.11:48910

3.1.3. EntryMeta

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

cli entry-replmeta --dcs="*" --object="[dn или uuid объекта]" --endpoint 172.18.0.11:48910

3.1.4. ImmediateReplication 

Запуск репликации между хостами:

cli replicate --dcs="*" --sources="*" --async=false --endpoint 172.18.0.11:48910 

3.1.5. ReplSummary

Вывод количества ожидаемых партнеров репликации и фактического количества партнеров репликации, а также ошибок для отсутствующих партнеров:

cli replsummary --dcs="*" --endpoint 172.18.0.11:48910

4. Параметры и ключи утилиты "ads"

ПараметрНазначение

ads migrator db-version

Показывает текущую версию БД

ads migrator history

Показывает список приименных миграций

ads migrator upgrade

Применяет все новые миграции, актуальные для данной версии приложения

ads migrator downgrade

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

Обсуждение