Bug 56051

Created attachment 19585 [details]
Лицензионное соглашение

Версия:
======= 
docs-alt-domain-11.0-alt1

Шаги:
=====
1). Начало документации отличается от шаблона, по которому сделаны другие документации:
Реальный результат:
Альт Домен 11.0
Руководство администратора
Редакция август, 2025

Ожидаемый результат:
Альт Домен 11.0
Документация
Руководство администратора
Редакция август, 2025
логотип компании BaseAlt
Автор документации  (Елена Мишина  ООО «Базальт СПО» lepata@basealt.ru)
А также добавить в аннотацию следующее:
Данный документ распространяется на условиях свободной лицензии FDL (Free Documentation License) версии 1.3.
Данный документ не содержит текста, помещаемого на первой или последней странице обложки. Данный документ не содержит неизменяемого текста.

2). В документации: п. 4.1. В операционной системе Windows
Для создания загрузочного flash-диска под операционной системой MS Windows используйте специальные программы: ALT Media Writer, Win32 Disk Imager, HDD Raw Copy Tool и другие.
Реальный результат:
Отсутствуют ссылки на приведенные программы. А также отсутствуют инструкции записи образа с помощью  Win32 Disk Imager и HDD Raw Copy Tool

Ожидаемый результат:
Для каждой приведенной программы прикреплена гиперссылка на источник:
ALT Media Writer - https://github.com/altlinux/ALTMediaWriter
Win32 Disk Imager - https://sourceforge.net/projects/win32diskimager/
HDD Raw Copy Tool - https://hddguru.com/software/HDD-Raw-Copy-Tool/
А также есть инструкции записи образа с помощью  Win32 Disk Imager и HDD Raw Copy Tool, как сделано в других документациях, например, Альт Образование 11.0

3). ⁠В документации: п. 4.2. В операционной системе Linux
Ожидаемый результат:
Добавлены скриншоты с примерами записи образа через программы Impression и SUSE Studio Imagewriter, как сделано в других документациях, например, Альт Образование 11.0

4). Должна ли быть глава - "Сохранение данных и меры предосторожности", как в других документациях?

5). ⁠В документации: п. ⁠5.5. Лицензионное соглашение
⁠Необходимо поменять скриншот в документации, т. к. в тексте лицензионного соглашения используется слово "соглашение", а на скриншоте документации - "договор" (См. скриншот Лицензионное соглашение)

6). ⁠В документации: п. 5.8. Установка системы
Реальный результат:
1. Программа установки предлагает выбрать дополнительные пакеты программ, которые будут включены в состав ОС Альт Домен установлены вместе с ней на диск.
2. Выбрав необходимые дополнительные пакеты следует нажать кнопк следует нажать кнопку Далее, после чего начнётся установка пакетов.

Ожидаемый результат:
1. Необходимо добавить пропущенный союз "и": Программа установки предлагает выбрать дополнительные пакеты программ, которые будут включены в состав ОС Альт Домен и установлены вместе с ней на диск.
2. Необходимо добавить запятую после "пакеты", а также убрать дублирование "следует нажать кнопк":
Выбрав необходимые дополнительные пакеты, следует нажать кнопку Далее, после чего начнётся установка пакетов.

7). ⁠В документации: п. 5.10. Установка загрузчика
1. "⁠При установке на EFI модуль установки загрузчика предложит вариант установить загрузчик в специальный раздел EFI (рекомендуется выбрать автоматическое разбиение на этапе разметки диска для создания необходимых разделов для загрузки с EFI):"
Уточните, пожалуйста, что имеется в виду под "⁠При установке на EFI". Означает ли это установку в UEFI режиме? Если да, то необходимо заменить "на EFI" на "в UEFI режиме".

8). ⁠В документации: п. ⁠5.11. Настройка сети
Реальный результат:
Примечание: Имя домена, для разворачиваемого контроллера домена, должно состоять минимум из двух компонентов, разделённых точкой.

Ожидаемый результат:
Необходимо убрать запятые после слов "домена": Имя домена для разворачиваемого контроллера домена должно состоять минимум из двух компонентов, разделённых точкой.

9). ⁠В документации: Глава 6. Обновление системы до актуального состояния
Реальный результат:
После установки системы, её лучше сразу обновить до актуального состояния. Можно не обновлять систему и сразу приступать к работе только в том случае, если вы не планируете подключаться к сети или Интернету и не собираетесь устанавливать дополнительных программ.

Ожидаемый результат:
Необходимо убрать запятую пред "ее": После установки системы её лучше сразу обновить до актуального состояния.

10). ⁠В документации: п. 8.4. DNS
Реальный результат:
1. Важно: Следует избегать использования суффикса. local. Если домен использует этот суффикс, на сервере и подключаемых компьютерах под управлением Linux необходимо отключить службу avahi-daemon.
2. Примечание
Имя контроллера домена и всех ПК — членов домена — не должно превышать 15 символов (ограничение связано с параметром sAMAccountName в Active Directory).

Ожидаемый результат:
1. Необходимо поставить запятую после "Linux": Если домен использует этот суффикс на сервере и подключаемых компьютерах под управлением Linux, необходимо отключить службу avahi-daemon.
2. Необходимо заменить тире, на круглые скобки или запятые: Имя контроллера домена и всех ПК (членов домена) не должно превышать 15 символов (ограничение связано с параметром sAMAccountName в Active Directory).

⁠11). ⁠В документации: Глава 9. Выбор DNS-бэкенда
Реальный результат:
Если не требуется — можно использовать встроенный сервер имен (SAMBA_INTERNAL). Если требуется, но при этом нежелательно использовать выделенный DNS-сервер — стоит использовать DNS-сервер на основе BIND 9;

Ожидаемый результат:
Необходимо заменить тире на запятую: Если не требуется, можно использовать встроенный сервер имен (SAMBA_INTERNAL). 

12). ⁠В документации: п. 10.2. Установка пакетов
Реальный результат:
Примечание: Реализации Kerberos несовместимы между собой.
Samba на базе Heimdal Kerberos использует KDC несовместимый с MIT Kerberos, поэтому на контроллере домена на базе Heimdal Kerberos из пакета samba-dc, для совместимости с клиентской библиотекой libkrb5, в krb5.conf (в секции — libdefaults) необходимо отключить использование ядерного кеша ключей — KEYRING:persistent:%{uid}:

Ожидаемый результат:
Необходимо поправить пунктуацию: Samba на базе Heimdal Kerberos использует KDC, несовместимый с MIT Kerberos, поэтому на контроллере домена на базе Heimdal Kerberos из пакета samba-dc для совместимости с клиентской библиотекой libkrb5 в krb5.conf (в секции - libdefaults) необходимо отключить использование ядерного кеша ключей — KEYRING:persistent:%{uid}:

13). ⁠В документации: п. 10.4. Установка имени контроллера домена
Реальный результат:
Для сервера, на котором будет разворачиваться контроллер домена, должно быть и установлено правильное имя узла и домена.

Ожидаемый результат: 
Необходимо убрать союз "и" после "быть": Для сервера, на котором будет разворачиваться контроллер домена, должно быть установлено правильное имя узла и домена.

14). ⁠В документации: п. 10.5. Сетевые настройки
Реальный результат:
1. Для корректной работы контроллера домен должны соблюдаться следующие условия:
2. В Центре управления системой в модуле Ethernet-интерфейсы указать имя компьютера и DNS 127.0.0.1:

Ожидаемый результат:
1. Необходимо поставить в род. падеж слово "домен": Для корректной работы контроллера домена должны соблюдаться следующие условия:
2. Предоставленный скриншот из веб-интерфейса ЦУС. Поменять скриншот на обычный ЦУС или поменять текст: В веб-интерфейсе Центра управления системой в модуле Ethernet-интерфейсы указать имя компьютера и DNS 127.0.0.1

15). ⁠В документации: п. 10.7. Параметры команды разворачивания домена
Реальный результат:
Более подробную информацию можно найти в справочной странице samba-tool(8).

Ожидаемый результат:
Заменить предлог "в" на "на" и добавить информацию, как посмотреть справку, по примеру из п. 50.2. Создание SPN и генерация keytab с помощью samba-tool: Более подробную информацию можно найти на справочной странице samba-tool(8) (man samba-tool).

16). ⁠В документации: Таблица 10.1. Основные опции для samba-tool domain provision
Реальный результат:
--dns-backend=NAMESERVER-BACKEND	Выбор DNS-бэкенда:
SAMBA_INTERNAL — встроенный DNS (по умолчанию);
BIND9_FLATFILE — не поддерживается в Альт Домен
BIND9_DLZ — BIND с хранением зон в AD;
NONE — без DNS (не рекомендуется).
--server-role=ROLE	Роль сервера:
domain controller или dc — контроллер домена (по умолчанию)
member server или member — член домена
standalone — автономный сервер

Ожидаемый результат:
Прийти к единому стилю оформление списков, например, поставить везде точку с запятой, а в конце списка точку:
--dns-backend=NAMESERVER-BACKEND	Выбор DNS-бэкенда:
SAMBA_INTERNAL — встроенный DNS (по умолчанию);
BIND9_FLATFILE — не поддерживается в Альт Домен;
BIND9_DLZ — BIND с хранением зон в AD;
NONE — без DNS (не рекомендуется).
--server-role=ROLE	Роль сервера:
domain controller или dc — контроллер домена (по умолчанию);
member server или member — член домена;
standalone — автономный сервер.

17). ⁠В документации: Глава 11. Присоединение к домену в роли контроллера домена
1. Системные требования к дополнительному DC аналогичны требованиям к первому контроллеру домена (см. Системные требования к серверу (контроллеру домена)).
2. --option="dns forwarder=IP" — указывает внешний DNS-сервер для пересылки (обязателен приSAMBA_INTERNAL). Форвардером может быть как вышестоящий DNS-сервер организации, так и публичные от google или yandex, например:

Ожидаемый результат:
1. Необходимо убрать вторую закрывающую скобку: Системные требования к дополнительному DC аналогичны требованиям к первому контроллеру домена (см. Системные требования к серверу (контроллеру домена).
2. Необходимо поправить написание Google и Yandex, в некоторых местах пишется с прописной буквы.

18). ⁠В документации: п. 11.1. Добавление DC с бэкендом SAMBA_INTERNAL
Ожидаемый результат:
После предложения "Присоединение к домену в роли контроллера домена:"
1. Добавить SAMBA_INTERNAL в конец вышеуказанного предложения, чтобы получилось: Присоединение к домену в роли контроллера домена SAMBA_INTERNAL
2. Добавить первым пунктом с гиперссылкой на пункт спецификации: Установить и настроить DNS-сервер SAMBA_INTERNAL (см. 10.8.2. Создание домена);

19). Добавление DC c бэкендом BIND9_DLZ 
Ожидаемый результат:
После "Примечание: Для выполнения операции присоединения к домену требуется пароль администратора домена." добавить:
Для сервера должно быть установлено правильное имя узла и домена (этот шаг можно пропустить, если имя компьютера было задано при установке системы). Для этого необходимо выполнить команды:
# hostnamectl set-hostname dc2.test.alt
Примечание
После изменения имени компьютера могут перестать запускаться приложения. Для решения этой проблемы необходимо перезагрузить систему.

20). В документации: п. 11.3. Проверка результатов присоединения 
Проверить работу DNS:
# host -t A test.alt 
Возможно необходимо добавить, что данную проверку нужно осуществлять на dc1.test.alt