domain-diag/domain-diag.1.man

'\" 
.TH "DOMAIN_DIAG" "1" "February 2023" "domain-diag @VERSION@" "Manual DOMAIN_DIAG"
.
.SH NAME
.B domain-diag 
\- это инструмент для диагностики состояния машины в домене.
.
.SH SYNOPSYS
domain-diag [options] [<check/test-function-name>]
.
.SH DESCRIPTION
.B domain-diag
имеет модульную структуру. Модули можно вызывать как все вместе,
так и отдельно. Есть опция записи результата в лог-файл.
Проверки отрабатывают по-разному, в зависимости от того, находится ли машина в домене или нет.
Для выполнения некоторых проверок требуется выполнение от рута. Также для корректной работы
для этого вам нужно будет получить тикет от сервера.

.B
Варианты запуска

Машина в домене

Машина введена в домен от пользователя с тикетом (доменным пользователем успешно выполнен kinit)

Машина введена в домен от root с тикетом (будет доработано и не будет необходимо в дальнейшем, хватит только root доступа)

Машина не в домене

- Часть проверок отработает и без тикета, но можно сделать kinit пользователем из домена.

- domain-diag считает, что машина введена в домен, если control system-auth имеет значение sss.

DONE - в случае успешного выполнения модуля.

SKIP - при выполнении программы не из-под рута некоторые проверки могут быть пропущены. 

WARNING - предупреждение, при не критических тестах в модуле.

FAIL - в случае существенного несоответствия, которое приводит к неработоспособности машины в домене.

.
.SS OPTIONS
.TP
\fB-h, --help\fR
Вызов справочной информации.
.TP
\fB-V, --version\fR
Отображение версии программы.
.TP
\fB-v, --verbose\fR
Подробный вывод выполнения скриптов.
.TP
\fB-w, --logfile[=FILE]\fR
Подробный вывод логирования записываются в фаил по указанному пути.
.TP
\fB-f, --force\fR
Логи перезаписываются в фаил.
.TP	
\fB-l, --list\fR
Список проверок.
.
.SH LIST OF CHECKS
.TP
.B check_hostnamectl
Отображает полную информацию о хосте и соответствующие настройки,
такие как - имя, значок, система, версия ядра, архитектура, 
если есть то инфо о виртуализации.
.TP
.B test_hostname
Проверка соответствия имени хоста, до первой точки в FQDN.
.TP
.B check_system_auth
Используемый по умолчанию набор pam модулей для аутентификации машины. Проверка применяемого варанта(например если sss - то машина введена в домен),
проверка куда ведёт линк для system-auth, а также вывод содержимого файла. 
.TP
.B test_domain_system_auth
Включена ли аутентификация(отличная от - local).
.TP
.B check_system_policy
Какой инструмент применяется для работы групповых политик, его расположение в системе и настройки.
.TP
.B test_gpupdate_system_policy
Проверка что настроено применения групповых политик через - gpupdate.
.TP
.B check_krb5_conf_exists
Проверка наличия krb5.conf, прав доступа к файлу, а так же вывод его контекста(содержимого).
.TP
.B check_krb5_conf_ccache
Вариант кеширования учётных записей(keyring, file, dir).
.TP
.B test_keyring_krb5_conf_ccache
Проверка установки способа кеширования в - keyring.
.TP
.B check_krb5_conf_kdc_lookup
Проверка включен/выключен ли поиск kerberos-имени домена через DNS, или вовсе отсутствует.
.TP
.B check_krb5_keytab_exists
Проверка наличия файла krb5.keytab с kerberos-парами принципал/ключ, и прав достура к нему.
.TP
.B check_keytab_credential_list
Вывод прав доступа и даты последного изменения файла кеша Керберос, 
а котором хранятся принципалы и хеши пароля доменной учётной записи пользователя, 
с которым ассоциирована та или иная служба в Linux(требуется запуск от root, иначе SKIP).
.TP
.B check_resolv_conf
Проверка указания домена(ов) для поиска, вывод содержимого resolv.conf.
.TP
.B compare_resolv_conf_with_default_realm
Сопоставление домена для поиска и домена указанного для Кербероса.
.TP
.B check_smb_conf
Проверка файла настроек конфигурации Самба.
.TP
.B compare_smb_realm_with_krb5_default_realm
Запрос домена указанного для Самбы и домена по умолчанию указанного для Кербероса.
.TP
.B test_smb_realm
Проверка соответствия домена указанного для Самбы и домена по умолчанию указанного для Кербероса.
.TP
.B test_domainname
Проверка вывода имени домена включенного в FQDN имя хоста.
.TP
.B check_time_synchronization
Проверка часового пояса, настройки синхронизации времени с сервером.
.TP
.B test_time_synchronization
Тест включена ли синхронизации времени.
.TP
.B check_nameservers
Проверка доступности всех контроллеров домена по имени 
и ip-адресу(работает ли resolv.conf).
.TP
.B check_domain_controllers
Проверка наличия srv-записи, ip-адреса и верного указания FQDN для контроллера домена,
а так же ldap-запрос (зачем требуется?).
.TP			
.B check_kerberos_and_ldap_srv_records
Проверка наличия srv-записи Керберос и LDAP для домена,
а так же ldap-запрос зачем требуется?).
.TP
.B compare_netbios_name
Сравнение префиксов имени машин в Самбе и указанного в /etc/hostname.
.TP
.B check_common_packages
Проверка наличия установленных основных пакетов и их версий
(alterator-auth, libnss-role, libkrb5 и libsmbclient).
.TP
.B check_group_policy_packages
Проверка наличия установленных основных пакетов и их версий
для управления групповыми политиками (local-policy и gpupdate).
.TP
.B check_sssd_ad_packages
Проверка наличия установленного пакета 
и его версии для аутентификации (task-auth-ad-sssd).
.TP
.B check_sssd_winbind_packages
Что это? пакет для аутентификации в АД через что(sss?).
.TP
.
.SH REPORTING BUGS
.
.SH SEE ALSO
.