Модуль community.general.vdo — модуль для управления VDO

ackthreads

string

Задает количество потоков для подтверждения завершения запрошенных операций ввода-вывода VDO. Допустимые значения — целые числа от 1 до 100 (из-за накладных расходов предпочтительны меньшие значения). По умолчанию используется 1. Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

activated

boolean

Состояние activate тома VDO. Если задано значение false, том VDO нельзя запустить, и он не запускается при старте системы. Однако при первоначальном создании том VDO со значением activated=false остается запущенным до остановки. Таково поведение команды vdo create по умолчанию: она позволяет пользователю записать на том VDO базовый объем метаданных (файловую систему, заголовки LVM и т. д.), прежде чем остановить том и оставить его деактивированным до момента готовности к использованию.

Варианты:

• false
• true

biothreads

string

Задает количество потоков для отправки операций ввода-вывода устройству хранения. Допустимые значения — целые числа от 1 до 100 (из-за накладных расходов предпочтительны меньшие значения). По умолчанию используется 4. Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

blockmapcachesize

string

Объем памяти, выделяемой для кэширования страниц карты блоков, в мегабайтах (также можно указать суффикс в стиле LVM: K, M, G или T). По умолчанию используется 128M; это же значение является минимальным. Значение задает размер кэша; использование памяти при этом увеличивается на 15%. Каждые 1,25 ГБ карты блоков охватывают 1 ТБ логических блоков, поэтому небольшой объем памяти для кэша карты блоков позволяет кэшировать значительно больший объем данных карты блоков.

Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

compression

string

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

Варианты:

• "disabled"
• "enabled"

cputhreads

string

Задает количество потоков для задач с высокой нагрузкой на ЦП, таких как хеширование или сжатие. Допустимые значения — целые числа от 1 до 100 (из-за накладных расходов предпочтительны меньшие значения). По умолчанию используется 2. Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

deduplication

string

Настраивает, включена ли дедупликация. Для создаваемого тома по умолчанию используется enabled. Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

Варианты:

• "disabled"
• "enabled"

device

string

Полный путь к устройству, используемому для хранения VDO.

Этот параметр обязателен, если state=present.

emulate512

boolean

Включает режим эмуляции 512 байт, позволяющий драйверам или файловым системам обращаться к тому VDO с гранулярностью 512 байт вместо гранулярности по умолчанию, равной 4096 байтам.

Рекомендуется использовать этот режим только в том случае, если драйверу или файловой системе требуется доступ к устройству с размером сектора 512 байт.

Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома.

Варианты:

• false ← (по умолчанию)
• true

force

boolean

добавлено в community.general 2.4.0

При создании тома игнорирует имеющиеся на устройстве хранения файловую систему или сигнатуру VDO. При остановке или удалении тома VDO сначала размонтирует хранящуюся на устройстве файловую систему, если она смонтирована.

Предупреждение: Этот параметр отключает все проверки безопасности, поэтому важно убедиться в точности и обоснованности всех указанных параметров.

Варианты:

• false ← (по умолчанию)
• true

growphysical

boolean

Указывает, следует ли попытаться выполнить операцию growphysical, если на устройстве достаточно неиспользуемого пространства. Операция growphysical выполняется, если относительно предыдущего физического размера затронутого тома VDO имеется не менее 64 ГБ свободного пространства.

Варианты:

• false ← (по умолчанию)
• true

indexmem

string

Задает объем памяти индекса в гигабайтах. По умолчанию используется 0.25. Можно указать специальные десятичные значения 0.25, 0.5 и 0.75, а также любое положительное целое число. Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома.

indexmode

string

Задает режим индекса Albireo.

По умолчанию используется dense. В этом режиме окно дедупликации составляет 1 ГБ памяти индекса на 1 ТБ входящих данных, при этом для хранения индекса требуется 10 ГБ постоянного хранилища.

В режиме sparse окно дедупликации составляет 1 ГБ памяти индекса на 10 ТБ входящих данных, однако для хранения индекса требуется 100 ГБ постоянного хранилища.

Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома.

Варианты:

• "dense"
• "sparse"

logicalsize

string

Логический размер тома VDO (в мегабайтах или в формате суффиксов LVM). Если для нового тома значение не указано, по умолчанию используется размер базового устройства хранения, заданный параметром device. Размер существующих томов сохраняется, если параметр logicalsize не указан или его значение меньше либо равно текущему размеру. Если указанное значение больше текущего размера, выполняется операция growlogical.

logicalthreads

string

Задает количество потоков, на которые распределяются части обработки VDO на основе логических адресов блоков. Допустимые значения — целые числа от 1 до 100 (из-за накладных расходов предпочтительны меньшие значения). По умолчанию используется 1. Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

name

string / обязательный

Имя тома VDO.

physicalthreads

string

Задает количество потоков, на которые распределяются части обработки VDO на основе физических адресов блоков. Допустимые значения — целые числа от 1 до 16 (из-за накладных расходов предпочтительны меньшие значения). Физическое пространство, используемое томом VDO, должно быть больше, чем (slabsize * physicalthreads). По умолчанию используется 1. Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

readcache

string

Включает или отключает кэш чтения. По умолчанию используется disabled. Значение enabled включает кэш чтения, который может повысить производительность при высокой дедупликации, при интенсивном чтении данных с высоким уровнем сжатия или при использовании жестких дисков. Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

Функция кэша чтения доступна в VDO 6.1 и более ранних версиях.

Варианты:

• "disabled"
• "enabled"

readcachesize

string

Задает дополнительный размер кэша чтения устройства VDO в мегабайтах. Он добавляется к системному минимуму. Суффикс K, M, G или T можно указывать по желанию. По умолчанию используется 0. На каждый 1 МБ заданного кэша чтения расходуется 1,125 МБ памяти на каждый поток bio (например, при настройке тома VDO с 4 потоками bio накладные расходы памяти для кэша чтения составят 4,5 МБ на каждый 1 МБ заданного кэша чтения). Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

Функция кэша чтения доступна в VDO 6.1 и более ранних версиях.

running

boolean

Указывает, запущен ли этот том VDO.

Для запуска том VDO должен быть активирован.

Варианты:

• false
• true

slabsize

string

Размер приращения, на которое увеличивается физический размер тома VDO, в мегабайтах (также можно указать суффикс в стиле LVM: K, M, G или T). Значение должно быть степенью двойки от 128M до 32G. По умолчанию используется 2G, что поддерживает тома с физическим размером до 16T. Максимальное значение 32G поддерживает физический размер до 256T. Этот параметр доступен только при создании нового тома и не может быть изменен для существующего тома.

state

string

Указывает, должен ли этот том VDO быть present или absent. Если том VDO present не существует, он создается. Если том VDO present уже существует, он изменяется путем обновления конфигурации, которая вступает в силу после перезапуска тома VDO. Не все параметры существующего тома VDO можно изменить; список statusparamkeys в коде содержит параметры, которые можно изменить после создания. Если том VDO absent не существует, он не удаляется.

Варианты:

• "absent"
• "present" ← (по умолчанию)

writepolicy

string

Задает политику записи для тома VDO.

В режиме sync запись подтверждается только после сохранения данных в энергонезависимом хранилище.

В режиме async запись подтверждается, когда данные помещены в кэш для последующей записи в энергонезависимое хранилище.

Режим auto (используемый по умолчанию и настоятельно рекомендуемый) проверяет, поддерживает ли устройство хранения сброс буферов. Если устройство поддерживает сброс буферов, том VDO работает в режиме async; если не поддерживает — в режиме sync.

Для существующих томов сохраняется ранее настроенное значение, если в плейбуке не указано другое.

Варианты:

• "async"
• "auto"
• "sync"

check_mode

Поддержка: нет

Может выполняться в режиме check_mode и возвращать прогноз изменения состояния без изменения целевого объекта.

diff_mode

Поддержка: нет

В режиме diff возвращает сведения об изменениях (или о возможных изменениях в check_mode).