vdo – Модуль управления VDO
Новая версия 2.5.
Описание
- Этот модуль управляет устройством дедупликации и сжатия VDO.
- VDO, или Virtual Data Optimizer, — это целевой модуль-маппер устройства, который предоставляет возможности дедупликации, сжатия и тонкого выделения блоков в режиме реального времени для первичного хранилища.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- PyYAML
- kmod-kvdo
- vdo
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ackthreads строка | Указывает количество потоков для подтверждения завершения запрошенных операций ввода-вывода VDO. Допустимые значения — целые числа от 1 до 100 (меньшие значения предпочтительнее из-за накладных расходов). По умолчанию значение равно 1. Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. | |
| activated булево |
| Статус активации тома VDO. Если значение равно "no", тома VDO нельзя запустить, и он не запустится при запуске системы. Однако при первоначальном создании том VDO со значением "activated", установленным в "off", будет запущен, пока не будет остановлен. Это поведение команды "vdo create" по умолчанию; оно предоставляет пользователю возможность записать базовый объем метаданных (файловая система, заголовки LVM и т.д.) в том VDO перед остановкой тома и оставлением его неактивированным до готовности к использованию. |
| biothreads строка | Указывает количество потоков для отправки операций ввода-вывода на устройство хранения. Допустимые значения — целые числа от 1 до 100 (меньшие значения предпочтительнее из-за накладных расходов). По умолчанию значение равно 4. Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. | |
| blockmapcachesize строка | Объем памяти, выделенный для кэширования страниц карты блоков, в мегабайтах (или может быть указан с использованием постфикса LVM в формате K, M, G или T). Значение по умолчанию (и минимальное) равно 128М. Значение определяет размер кэша; есть накладные расходы на использование памяти в размере 15%. Каждый 1,25 Гб карты блоков охватывает 1 ТБ логических блоков, поэтому небольшой объем памяти кэша карты блоков может кэшировать значительный объем данных карты блоков. Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. | |
| compression строка |
| Настраивает включение сжатия. По умолчанию для созданного тома значение равно 'enabled'. Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. |
| cputhreads строка | Указывает количество потоков для задач, требующих больших вычислений ЦП, таких как хеширование или сжатие. Допустимые значения — целые числа от 1 до 100 (меньшие значения предпочтительнее из-за накладных расходов). По умолчанию значение равно 2. Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. | |
| deduplication строка |
| Настраивает включение дедупликации. По умолчанию для созданного тома значение равно 'enabled'. Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. |
| device строка | Полный путь к устройству для хранения VDO. Требуется, если "state" равно "present". | |
| emulate512 булево |
| Включает эмуляцию 512-байтового режима, позволяя драйверам или файловым системам получать доступ к тому VDO с размером сектора 512 байт вместо стандартного 4096 байт. По умолчанию значение 'выключено'; рекомендуется только при необходимости доступа драйвера или файловой системы к устройству на уровне сектора 512 байт. Этот параметр доступен только при создании нового тома и не может быть изменён для существующего тома. |
| growphysical булево |
| Указывает, следует ли пытаться выполнить операцию growphysical, если на устройстве достаточно свободного места. Операция growphysical будет выполнена, если на устройстве свободно не менее 64 ГБ места относительно предыдущего физического размера затронутого тома VDO. |
| indexmem строка | Указывает объем памяти индекса в гигабайтах. По умолчанию значение равно 0,25. Можно использовать специальные значения с плавающей запятой 0,25, 0,5 и 0,75, а также любое положительное целое число. Этот параметр доступен только при создании нового тома и не может быть изменён для существующего тома. | |
| indexmode строка |
| Указывает режим индекса Albireo индекса. По умолчанию используется режим 'dense', в котором окно дедупликации составляет 1 ГБ памяти индекса на 1 ТБ входящих данных, требуя 10 ГБ данных индекса на постоянном хранилище. В режиме 'sparse' окно дедупликации составляет 1 ГБ памяти индекса на 10 ТБ входящих данных, но требуется 100 ГБ данных индекса на постоянном хранилище. Этот параметр доступен только при создании нового тома и не может быть изменён для существующего тома. |
| logicalsize строка | Логический размер тома VDO (в мегабайтах или формате LVM). Если для нового тома он не указан, он по умолчанию совпадает с размером базового устройства хранения, указанного в параметре 'device'. При сохранении существующих томов размер будет сохранён, если параметр logicalsize не указан или меньше или равен текущему размеру. Если указанный размер больше текущего размера, будет выполнена операция growlogical. | |
| logicalthreads строка | Указывает количество потоков, на которые следует разделить части обработки VDO, основанные на логических адресах блоков. Допустимые значения — целые числа от 1 до 100 (меньшие значения предпочтительнее из-за накладных расходов). По умолчанию значение равно 1. Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. | |
| name строка / обязательно | Имя тома VDO. | |
| physicalthreads строка | Указывает количество потоков, на которые следует разделить части обработки VDO, основанные на физических адресах блоков. Допустимые значения — целые числа от 1 до 16 (меньшие значения предпочтительнее из-за накладных расходов). Физическое пространство, используемое томом VDO, должно быть больше (slabsize * physicalthreads). По умолчанию значение равно 1. Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. | |
| readcache строка |
| Включает или отключает кэш чтения. По умолчанию значение равно 'disabled'. Выбор 'enabled' включает кэш чтения, что может улучшить производительность для рабочих нагрузок с высокой дедупликацией, рабочих нагрузок чтения с высокой степенью сжатия или на жестких дисках. Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. Функция кэша чтения доступна в VDO 6.1 и более ранних версиях. |
| readcachesize строка | Указывает дополнительный размер кэша чтения устройства VDO в мегабайтах. Это дополнительно к системно определенному минимуму. Использование значения с суффиксом K, M, G или T необязательно. Значение по умолчанию равно 0. 1,125 МБ памяти на поток bio будет использоваться на 1 МБ кэша чтения (например, том VDO с 4 потоками bio будет иметь накладные расходы на использование памяти кэша чтения в размере 4,5 МБ на 1 МБ указанного кэша чтения). Существующие тома сохранят свои ранее настроенные значения, если в скрипте не указано иное значение. Функция кэша чтения доступна в VDO 6.1 и более ранних версиях. | |
| running булево |
| Запущен ли этот том VDO. Том VDO должен быть активирован, чтобы его можно было запустить. |
| slabsize строка | Размер приращения, на который увеличивается физический размер тома VDO, в мегабайтах (или может быть указан с использованием постфикса LVM в формате K, M, G или T). Должно быть степенью двойки в диапазоне от 128 МБ до 32 ГБ. По умолчанию значение равно 2 ГБ, что поддерживает тома с физическим размером до 16 ТБ. Максимальное значение, 32 ГБ, поддерживает физический размер до 256 ТБ. Этот параметр доступен только при создании нового тома и не может быть изменён для существующего тома. | |
| state строка / обязательно |
| Должен ли этот том VDO быть "present" или "absent". Если тома VDO "present" не существует, он будет создан. Если том VDO "present" уже существует, он будет изменён путём обновления конфигурации, которая вступит в силу после перезапуска тома VDO. Не все параметры существующего тома VDO могут быть изменены; список "statusparamkeys" содержит параметры, которые можно изменить после создания. Если тома VDO "absent" не существует, он не будет удалён. |
| writepolicy string |
| Указывает политику записи для тома VDO. Режим 'sync' подтверждает запись только после того, как данные окажутся на стабильном хранилище. Режим 'async' подтверждает запись, когда данные были помещены в кэш для записи на стабильное хранилище. По умолчанию (и очень рекомендуется) режим 'auto' проверяет устройство хранения, чтобы определить, поддерживает ли оно сброс данных. Устройства, которые поддерживают сброс, приведут к тому, что том VDO будет в режиме 'async', а устройства, которые не поддерживают сброс, будут работать в режиме sync. Существующие тома сохранят свою ранее настроенную конфигурацию, если в плане не указано иное значение. |
Примечания
Примечание
- В целом, следует использовать стандартную конфигурацию потоков.
Примеры
- name: Create 2 TB VDO volume vdo1 on device /dev/md0
vdo:
name: vdo1
state: present
device: /dev/md0
logicalsize: 2T
- name: Remove VDO volume vdo1
vdo:
name: vdo1
state: absent
Статус
- Для этого модуля не гарантируется обратная совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Bryan Gurney (@bgurney-rh)
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/vdo_module.html
