rbd discard fixup

Author: socketpair

main.rst

@@ -9,24 +9,25 @@ qemu-kvm и discard
 ++++++++++++++++++
 
 И Ceph (RBD) и Qemu умеют в discard/trim/unmap. Это означает, что гостевая ОС
-может отправить соответствующий запрос к хранилищу чтобы сообщить что данные не
+может отправить соответствующий запрос к хранилищу, чтобы сообщить что данные не
 нужны. Исходно это было предназначено для SSD-дисков с целью оптимизации
 wear-leveling (выравнивание износа). В RBD это позволяет удалить ненужные данные
 из кластера и тем самым уменьшить бекфиллинг, размеры снапшотов и др.
 
 Мы знаем, что RBD виртуально делит диски на куски по 4 МБ (по-умолчанию). Каждый
 кусок -- это один объект Rados. Соответственно, дискард может либо удалить целиком
 один объект (если он не нужен), либо сократить размер (вплоть до нуля). Что он не может
--- так это продискардить середину объекта или начало. В API RBD нет функции для
-выяснения этого чанка. Поэтому Qemu не может догадаться какие дискарды можно отправлять
-в librbd а какие закончатся ошибкой. В документации про это ничего не сказано.
+-- так это продискардить середину объекта или начало. Он мог бы просто заполнить нулями,
+но нет. Появляется ошибка, правда, не фатальная. В API RBD нет функции для
+выяснения размера чанка. Поэтому Qemu не может догадаться какие дискарды можно отправлять
+в librbd, а какие закончатся ошибкой. В документации про это ничего не сказано.
 
 Есть костыль для ceph.conf -- параметр ``rbd_skip_partial_discard``. Однако:
 
-http://tracker.ceph.com/issues/16386
-http://tracker.ceph.com/issues/16869
+* http://tracker.ceph.com/issues/16386
+* http://tracker.ceph.com/issues/16869
 
-В связи с чем, лучше проинструктировать Qemu чтобы она сообщила в гостевую о
+В связи с чем, лучше проинструктировать Qemu чтобы она сообщила в гостевую об
 имеющемся выравнивании в 4 МБ. Тогда ядро гостевой ОС не будет отправлять дискарды
 которые невозможно выполнить в RBD.
 
@@ -45,10 +46,13 @@ http://tracker.ceph.com/issues/16869
 .. important::
 
    ``xmlns:qemu='http://libvirt.org/schemas/domain/qemu/1.0'`` крайне важен.
-   без этой строки ``<qemu:commandline>`` будет проигнорирован. Проверить
+   Без этой строки ``<qemu:commandline>`` будет проигнорирован. Проверить
    можно повторно отредактировав описание ВЫКЛЮЧЕНОЙ виртуальной машины
    ``virsh edit some-domain``
 
+   Данный фрагмент будет работать только для virtio-scsi. Для IDE аналогично,
+   но мне неизвестно как :).
+
 (Пример по ссылке http://docs.ceph.com/docs/master/rbd/qemu-rbd похоже что
 устарел и не работает)
 
@@ -67,22 +71,22 @@ http://tracker.ceph.com/issues/16869
    Discard будет работать только для виртуальных дисковых интерфейсов IDE и
    virtio-scsi. Не путайте virtio и virtio-scsi -- это два совершенно разных
    интерфейса. virtio устарел и более не развивается. В гостевой ОС
-   virtio-scsi выклядит как /dev/sd*, а virtio как /dev/vd*
+   virtio-scsi выглядит как ``/dev/sd*``, а virtio как ``/dev/vd*``.
 
-Чтобы это заработало полностью, нужно убедиться что эта возможность во-первых,
-появилась на блочном уровне в гостевй ОС, во-вторых, чтобы гостевая ОС
+Чтобы это заработало полностью, нужно убедиться что эта возможность, во-первых,
+появилась на блочном уровне в гостевой ОС, а во-вторых, чтобы гостевая ОС
 использовала эту функцию.
 
 Linux
 ~~~~~
 
 * ``fstrim -v -a``. Вручную, либо по расписанию (раз в неделю). Рекомендуется.
-  не уверен, но в Ubuntu по-моему работает из коробки.
+  не уверен, но в Ubuntu, по-моему, работает из коробки.
 * Опции для SWAP-разделов. TODO: расписать какие именно. Есть первичный дискард
   перед подключением, есть включение дискарда во время работы.
 * Есть опции при монтировании различных ФС чтобы выполняли discard для данных
   которые стали ненужными (после удаления файлов)
-* Команда `blkdiscard`` для очистки всего устройства либо раздела или тома LVM.
+* Команда ``blkdiscard`` для очистки всего устройства либо раздела или тома LVM.
 
 .. warning::
 
@@ -93,9 +97,16 @@ Linux
 Windows
 ~~~~~~~
 
-TODO: всё работает из коробки как-то само собой. на старых версиях можно включить
+TODO: всё работает из коробки как-то само собой. На старых версиях можно включить
 через реестр. Как посмотреть ? Как форсировано прочистить ?
 
+Настоятельно рекомендуется установить дополнения в гостевую ОС:
+
+* https://fedoraproject.org/wiki/Windows_Virtio_Drivers
+* https://www.linux-kvm.org/page/WindowsGuestDrivers/Download_Drivers
+
+Иначе придётся довольствоваться только IDE, а это сильно меньшая производительность.
+
 
 Недорасписанное
 +++++++++++++++