Bug 53713

Summary: Документация docs-alt-server-v, Глава 39. Системы хранения PVE: ошибки пунктуации и улучшения
Product: Sisyphus Reporter: Tatyana Gagina <tatyana>
Component: docs-alt-server-vAssignee: lepata <lepata>
Status: CLOSED FIXED QA Contact: qa-sisyphus
Severity: normal    
Priority: P5 CC: azol, boyarsh, cas, lepata, lepata
Version: unstable   
Hardware: x86_64   
OS: Linux   
Attachments:
Description Flags
пример для скриншота с Thinpool
none
Создание Thinpool none

Description Tatyana Gagina 2025-04-03 13:20:01 MSK 
Версия: docs-alt-server-v-10.4-alt5

Перейти в документации к главе 39. Системы хранения PVE.

Предложения:
1. п.⁠39.4.5.1. Администрирование BTRFS:
Можно выставить сначала команду по созданию снимка, а потом по удалению подтома:
# btrfs subvolume snapshot -r /mnt/data/btrfs-storage /mnt/data/new
затем
# btrfs subvolume delete /mnt/data/btrfs-storage
Переставить, если есть в этом необходимость. 

2. п.⁠39.4.6. CIFS
Можно добавить после абзаца "После ввода IP-адреса удаленного сервера, доступные ресурсы будут автоматически просканированы и будут отображены в выпадающем списке Share".
Если в списке не будет отображены ресурсы сервера, то проверить запущен ли на нём samba.service. 
(для перезапуска Samba-сервера: # systemctl restart samba.service). Добавлять, если есть в этом необходимость.

Ошибки пунктуации:
1. п.⁠39.3. Идентификатор тома
"При удалении ВМ или контейнера, система также удаляет все связанные тома, принадлежащие этой ВМ или контейнеру".

Результат: лишняя запятая между словами "контейнера  и "система". Здесь также обратить внимание, что указано "Вм" вместо "ВМ".
Ожидаемый результат: "При удалении ВМ или контейнера система также удаляет все связанные тома, принадлежащие этой ВМ или контейнеру".


2. п.⁠39.3. Идентификатор тома
"После ввода IP-адреса удаленного сервера, доступные ресурсы будут автоматически просканированы и будут отображены в выпадающем списке Export".

Результат: лишняя запятая между словами "сервера" и "доступные".
Ожидаемый результат: "После ввода IP-адреса удаленного сервера доступные ресурсы будут автоматически просканированы и будут отображены в выпадающем списке Export".

3. Опечатка в команде: "Рекомендуется использовать значение UUID (выведенное командой mkfs.btrf)..."

Результат: указано mkfs.btrf без "s" на конце.
Ожидаемый результат: mkfs.btrfs
"Рекомендуется использовать значение UUID (выведенное командой mkfs.btrfs)..."
Comment 1 Tatyana Gagina 2025-04-03 13:21:13 MSK 
(Ответ для Tatyana Gagina на комментарий #0)
> 3. Опечатка в команде: "Рекомендуется использовать значение UUID (выведенное
> командой mkfs.btrf)..."
> 
> Результат: указано mkfs.btrf без "s" на конце.
> Ожидаемый результат: mkfs.btrfs
> "Рекомендуется использовать значение UUID (выведенное командой
> mkfs.btrfs)..."

Смотреть здесь п. ⁠39.4.5.1. Администрирование BTRFS
Comment 2 Tatyana Gagina 2025-04-03 16:35:18 MSK 
Ошибки пунктуации:
4. п. ⁠39.4.8.1. Создание локального хранилища ZFS в веб-интерфейсе
Для создания локального хранилища ZFS в веб-интерфейсе, следует выбрать узел, на котором будет создано хранилище, в разделе Диски выбрать пункт ZFS и нажать кнопку Создать: ZFS:

Результат: лишняя запятая между словами "веб-интерфейсе" и "следует".
Ожидаемый результат: "Для создания локального хранилища ZFS в веб-интерфейсе следует выбрать узел, на котором будет создано хранилище, в разделе Диски выбрать пункт ZFS и нажать кнопку Создать: ZFS:.."

5. п. ⁠39.4.9.1. Создание локального LVM хранилища в веб-интерфейсе
"Для создания локального LVM хранилища в веб-интерфейсе необходимо чтобы в системе имелся хотя бы один пустой жесткий диск".

Результат: не хватает запятой между словами "необходимо" и "чтобы".
Ожидаемый результат: "Для создания локального LVM хранилища в веб-интерфейсе необходимо, чтобы в системе имелся хотя бы один пустой жесткий диск".

6. п. ⁠39.4.10.1. Создание локального LVM-Thin хранилища в веб-интерфейсе
"Для создания локального LVM-Thin хранилища в веб-интерфейсе следует выбрать узел, на котором будет создано хранилище. В разделе Диски выбрать пункт Lvm-thin, и нажать кнопку Создать: Thinpool:.."

Результат: лишняя запятая между "Lvm-thin" и "и нажать".
Ожидаемый результат: "Для создания локального LVM-Thin хранилища в веб-интерфейсе следует выбрать узел, на котором будет создано хранилище. В разделе Диски выбрать пункт Lvm-thin и нажать кнопку Создать: Thinpool:.."
___________
Предложение:
3. п. ⁠39.4.10.1. Создание локального LVM-Thin хранилища в веб-интерфейсе
Абзац "Для создания локального LVM-Thin хранилища в веб-интерфейсе следует выбрать узел, на котором будет создано хранилище, в разделе Диски выбрать пункт LVM-Thin, и нажать кнопку Создать: Thinpool:.." -> обратить внимание на скриншот ниже, указано:
"Не удалось найти Thin-Pool".
При проверке на кластере PVE при отсутствующем Thinpool невозможно дальше открыть окно "Создать: LVM Thinpool", только при его наличии.
Предложение: заменить скриншот, на котором будет указан готовый LVM Thinpool (как "пример для скриншота с Thinpool", приблизительный).
Comment 3 Tatyana Gagina 2025-04-03 16:36:03 MSK 
Created attachment 18140 [details]
пример для скриншота с Thinpool
Comment 4 Elena Mishina 2025-04-03 18:02:12 MSK 
Created attachment 18144 [details]
Создание Thinpool

Последнее предложение совсем непонятно. Что-то вроде: нельзя создать новый Thinpool, если нет Thinpool? 
Но это же не так (см.скриншот)
Comment 5 Tatyana Gagina 2025-04-04 10:47:30 MSK 
(Ответ для Elena Mishina на комментарий #4)
> Создано вложение 18144 [details] [подробности]
> Создание Thinpool
> 
> Последнее предложение совсем непонятно. Что-то вроде: нельзя создать новый
> Thinpool, если нет Thinpool? 
> Но это же не так (см.скриншот)

Проверила повторно. При первой проверке не удалось создать Thinpool (были сбои на PVE). 
При второй - успешно. Вопрос по поводу данного пункта 39.4.10.1 снят.
Comment 6 Repository Robot 2025-04-07 17:10:09 MSK 
docs-alt-server-v-10.4-alt6 -> sisyphus:

 Mon Apr 07 2025 Elena Mishina <lepata@altlinux> 10.4-alt6
 - fix some typos (ALT 53728, 53724, 53744, 53713, 53702, 53963, 53691, 53601, 53623)
 - small improvements (ALT 53635, 53716)