Bug 53713

Summary:

Документация docs-alt-server-v, Глава 39. Системы хранения PVE: ошибки пунктуации и улучшения

Product:

Sisyphus

Reporter:

Tatyana Gagina <tatyana>

Component:

docs-alt-server-v

Assignee:

lepata <lepata>

Status:

CLOSED FIXED

QA Contact:

qa-sisyphus

Severity:

normal

Priority:

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)