vinum(8)

НАЗВАНИЕ

vinum - программа управления диспетчером логических томов (Logical Volume Manager)

СИНТАКСИС

vinum [команда] [-опции]

КОМАНДЫ

attach сплетение том [rename]
attach поддиск сплетение [смещение] [rename]

Подключает сплетение (plex) к тому (volume) или поддиск (subdisk) к сплетению.

checkparity сплетение [-f] [-v]

Проверяет блоки четности в сплетении RAID-4 или RAID-5.

concat [-f] [-n имя] [-v] диски

Создает конкатенированный том из указанных дисков.

create [-f] файл_описания

Создает том как указано в файле описания.

debug

Вызывает вход диспетчера томов в режим отладчика ядра.

debug флаги

Устанавливает флаги отладки.

detach [-f] [сплетение | поддиск]

Отключает сплетение или поддиск от тома или сплетения, к которому он подключен.

dumpconfig [диск ...]

Выдает информацию о конфигурации, хранящуюся на указанных дисках или на всех дисках в системе, если имена дисков не указаны.

info [-v] [-V]

Выдает информацию о состоянии диспетчера томов.

init [-S размер] [-w] сплетение | поддиск

Инициализирует нулями содержимое поддиска или всех поддисков сплетения.

label том

Создает метку тома.

l | list [-r] [-s] [-v] [-V] [том | сплетение | поддиск]

Выдает информацию об указанных объектах.

ld [-r] [-s] [-v] [-V] [том]

Выдает информацию о дисках.

ls [-r] [-s] [-v] [-V] [поддиск]

Выдает информацию о поддисках.

lp [-r] [-s] [-v] [-V] [сплетение]

Выдает информацию о сплетениях.

lv [-r] [-s] [-v] [-V] [том]

Выдает информацию о томах.

makedev

Пересоздает файлы устройств в каталоге /dev/vinum.

mirror [-f] [-n имя] [-s] [-v] диски

Создает зеркальный том из указанных дисков.

move | mv -f диск объект ...

Переносит объекты на указанный диск.

printconfig [файл]

Записывает копию текущей конфигурации в файл.

quit

Завершает работу утилиты vinum в интерактивном режиме. Обычно это происходит при вводе символа конца файла (EOF).

read диск ...

Читает конфигурацию vinum с указанных дисков.

rename [-r] [диск | поддиск | сплетение | том] новое_имя

Переименовывает указанный объект.

rebuildparity сплетение [-f] [-v] [-V]

Пересоздает блоки четности сплетения типа RAID-4 или RAID-5.

resetconfig

Сбрасывает полную конфигурацию vinum.

resetstats [-r] [том | сплетение | поддиск]

Сбрасывает статистические счетчики для указанных объектов или для всех объектов, если ни один не указан.

rm [-f] [-r] том | сплетение | поддиск

Удаляет объект.

saveconfig

Сохраняет конфигурацию vinum на диск после сбоев конфигурации.

setdaemon [значение]

Устанавливает конфигурацию демона.

setstate состояние [том | сплетение | поддиск | диск]

Устанавливает состояние, не влияя на другие объекты, только в диагностических целях.

start

Читает конфигурацию со всех дисков vinum.

start [-i интервал [-S размер] [-w] том | сплетение | поддиск

Позволяет системе обращаться к объектам

stop [-f] [том | сплетение | поддиск]

Прекращает доступ к объектам или останавливает vinum, если параметры не указаны.

stripe [-f] [-n имя] [-v] диски

Создает том с чередованием из указанных дисков.

ОПИСАНИЕ

Утилита vinum взаимодействует с компонентом ядра диспетчерра логических томов Vinum. Утилита предназначена либо для интерактивного использования, если запущена без аргументов командной строки, либо для выполнения одной переданной в командной строке команды. В интерактивном режиме утилита vinum сохрраняет хронологию выполнения команд.

ОПЦИИ

После команд vinum могут указываться необязательные опции. Любую из следующих опций можно указывать для любой команды, но в некоторых случаях опции игнорируются. Например, команда stop игнорирует опции -v и -V.

-f

Опция -f ("force") отменяет проверки защиты. Эту опцию надо использовать крайне осторожно. Эта опция предназначена только для критических случаев. Например, команда

rm -f myvolume

удаляет том myvolume, даже если он открыт. Любой последующий доступ к этому тому почти наверрняка вызовет панику в системе.

-i миллисекунд

При выполнении команд init и start, ожидать указанное количество миллисекунд между копированиями каждого блока. Это уменьшает нагрузку на систему.

-n имя

Используйте опцию -n для указания имени тома в простых командах конфигурации concat, mirror и stripe.

-r

Опция -r ("recursive") используется в командах list для выдачи информации не только об указанных объектах, но и о входящих в них объектах. Например, при указании в команде lv, опция -r позволит также получить информацию о сплетениях и поддисках, принадлежащих тому.

-s

Опция -s ("statistics") используется в командах list для выдачи статистической информации. В команде mirror эта опция используется для указания того, что необходимо создавать сплетения с чередованием.

-S размер

Опция -S задает размер (transfer size) для команд init и start.

-v

Опция -v ("verbose") может использоваться для запроса более подробной информации.

-V

Опция -V ("Very verbose") может использоваться для запроса еще более подробной информации, чем выдает опция -v.

-w

Опция -w ("wait") требует от утилиты vinum дожидаться завершения команд, которые обычно работают в фоновом режиме, например, init.

ДЕТАЛЬНОЕ ОПИСАНИЕ КОМАНД

Команды vinum выполняют следующие функции:

attach сплетение том [rename]
attach поддиск сплетение [смещение] [rename]

Команда vinum attach вставляет указанное сплетение или поддиск в том или сплетение, соответственно. В случае поддиска, можно указать смещение в сплетении. Если смещение не задано, поддиск будет добавлен в первое подходящее место. После подключения сплетения к непустому тому, утилита vinum реинтегрирует сплетение.

Если указано ключевое слово rename, утилита vinum переименовывает объект (и, в случае сплетения, любые входящие в него поддиски) в соответствии со стандартными соглашениями по именованию vinum. Для переименования объекта с присвоением нестандартного имени испольуйте команду rename.

При подключении поддисков следует учитывать несколько соображений:

• Поддиски обычно можно подключать только к конкатенированным сплетениям.
• Если в сплетении RAID-5 с чередованием не хватает поддиска (например, после сбоя диска), его следует заменять только поддиском такого же размера.
• Для добавления дополнительных поддисков к спелетению с чередованием или типа RAID-5, используйте опцию -f. В результате, данн_е в сплетении будут повреждены.
• Для конкатенированных сплетений параметр смещение задает смещение в блоках от начала сплетения. Для сплетений типа RAID-5 с чередованием он задает смещение первого блока поддиска: другими словами, смещение представляет собой числовую позицию поддиска, умноженную на размер полосы. Например, в сплетении с размером полосы 271 Кбайт первый поддиск будет иметь смещение 0, второй - смещение 271 Кбайт, третий - 542 Кбайта и т.д. В этом вычислении блоки четности в спллетениях типа RAID-5 игнорируются.

checkparity сплетение [-f] [-v]

Проверяет блоки четности в указанном сплетении типа RAID-4 или RAID-5. Эта операция поддерживает указатель в сплетении, так что проверку, при необходимости, можно остановить и затем возобновить с той же позиции. Кроме того, этот указатель используется командой rebuildparity, поэтому пересоздание блоков четности нужно будет начинать только с места, где выявлена первая проблема четности. Если указан флаг -f, команда checkparity начинает проверку с начала сплетения. Если указан флаг -v, checkparity выдает отчет о работе процесса.

concat [-f] [-n имя] [-v] диски

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

Обычно команда concat устанавливает для тома и его компонентов произвольные имена. Имя состоит из слова "vinum" и небольшого целого числа, например, "vinum3". Можно задать имя для тома явно с помощью опции -n имя. Имена сплетений и поддисков строятся стандартно на базе имени соответствующего тома.

Для дисков имена задавать нельзя. Если диски были проинициализированы как диски vinum, имя остается. В противном случае, диски получают имена, состоящие из слова "vinumdrive" и небольшого целого числа, например, "vinumdrive7". Как и для команды create, опцию -f можно использовать для переопределения ранее данного имени. Опция -v используется для получения подробных результатов.

Примеры использования этой команды см. в разделе "УПРОЩЕННОЕ КОНФИГУРИРОВАНИЕ" ниже.

create [-f] файл_описания

Команда vinum create используется для создания любого объекта. С учетом достаточно сложных взаимосвязей и потенциальных опасностей прри создании объекта vinum, в интерактивном интерфейсе эта функция недоступна. Если имя файла не указано, команда vinum открывает временный файл в редакторе. Если установлена переменная среды EDITOR, утилита vinum запускает указанный в ней редактор. Если же нет, запускается стандартный редактор vi. Подробнее о формате файла описания см. в разделе "ФАЙЛ КОНФИГУРАЦИИ" ниже.

Учтите, что функция vinum create - аддитивна: если выполнить ее несколько раз, будет создано несколько экземпляров всех неименованных объектов.

Обычно команда create не будет изменять имена существующих дисков vinum, чтобы случайно не стереть их. Корректный способ удалить не нужные более диски vinum - сбросить конфигурацию с помощью команды resetconfig. В некоторых случаях, однако, может потребоваться создать новые данные на дисках vinum, которые не удается запустить. В этом случае используйте команду create -f.

debug

Команда vinum debug без параметров используется для входа в удаленный отладчик ядра (remote kernel debugger). Она срабатывает только если vinum собран с опцией VINUMDEBUG. Эта опция остановит работу операционной системы, пока не завершится работа отладчика ядра. Если установлена удаленная отладка, а удаленное подключение к отладчику ядра организовать не получается, для выхода из режима отлади придется перезагрузить систему.

debug флаги

Устанавливает битовую маску внутренних флагов отладки. Эти флаги могут меняться без уведомления по ходу развития продукта; уточните их значения в заголовочном файле <sys/dev/vinumvar.h>. Битовая маска строится из следующих значений:

DEBUG_ADDRESSES (1)

Показывать информацию буфера в ходе запросов.

DEBUG_RESID (4)

Перейти в отладчик в complete_rqe().

DEBUG_LASTREQS (8)

Поддерживать циклический буфер последних запросов.

DEBUG_REVIVECONFLICT (16)

Выдавать информацию о конфликтах восстановления (revive conflicts).

DEBUG_EOFINFO (32)

Выдавать информацию о внутреннем состоянии при возврате символа конца файла (EOF) со сплетения с чередованием (striped plex).

DEBUG_MEMFREE (64)

Поддерживать циклический список последних освобожденных подсистемой выделения памяти (memory allocator) областей памяти.

DEBUG_REMOTEGDB (256)

Перейти в удаленный отладчик gdb при выполнении команды debug.

DEBUG_WARNINGS (512)

Выдавать ряд предупреждений о несущественных проблемах в реализации.

detach [-f] сплетение
detach [-f] поддиск

Команда vinum detach удаляет (отключает) указанное сплетение или поддиск из тома или сплетения, к которому он подключен. Если удаление объекта приводит к нарушению целостности данных тома, операция не сработает, если только не указана опция -f. Если имя объекта строится на базе объекта, в который он входит (например, поддиск vol1.p7.s0, подключенный к сплетению vol1.p7), имя будет изменено путем добавления префикса "ex-" (например, ex-vol1.p7.s0). При необходимости, имя в процессе будет усечено.

Команда detach не уменьшает количество поддисков в сплетении с чередованием или типа RAID-5. Вместо этого поддиск помечается как отсутствующий и может быть в дальнейшем заменен с помощью команды attach.

dumpconfig [диск ...]

Команда vinum dumpconfig выдает информацию о конфигурации, хранящуюся на указанных дисках. Если имена дисков не указаны, команда dumpconfig просматривает все диски в системе в поисках разделов Vinum, и сбрасывает находящуюся на них информацию. Если изменения конфигурации отключены, может оказаться, что эта информация не совпадает с выдаваемой командой list. Эта команда используется, в основном, для сопровождения и отладки.

info

Команда vinum info выдает информацию об использовании памяти драйвером vinum. Она предназначена, в основном, для отладки. При указании опции -v она будет выдавать детальную информацию об используемых областях памяти.

При указании опции -V команда info выдает информацию о последних (до 64) запросах ввода-вывода, обработанных драйвером vinum. Эта информация собирается, только если установлен флаг отладки 8. Информация выдается в следующем формате:

vinum -> info -V
Flags: 0x200 1 opens
Total of 38 blocks malloced, total memory: 16460
Maximum allocs: 56, malloc table at 0xf0f72dbc

Time Event Buf Dev Offset Bytes SD SDoff Doffset Goffset

14:40:00.637758 1VS Write 0xf2361f40 91.3 0x10 16384
14:40:00.639280 2LR Write 0xf2361f40 91.3 0x10 16384
14:40:00.639294 3RQ Read 0xf2361f40 4.39 0x104109 8192 19 0 0 0
14:40:00.639455 3RQ Read 0xf2361f40 4.23 0xd2109 8192 17 0 0 0
14:40:00.639529 3RQ Read 0xf2361f40 4.15 0x6e109 8192 16 0 0 0
14:40:00.652978 4DN Read 0xf2361f40 4.39 0x104109 8192 19 0 0 0
14:40:00.667040 4DN Read 0xf2361f40 4.15 0x6e109 8192 16 0 0 0
14:40:00.668556 4DN Read 0xf2361f40 4.23 0xd2109 8192 17 0 0 0
14:40:00.669777 6RP Write 0xf2361f40 4.39 0x104109 8192 19 0 0 0
14:40:00.685547 4DN Write 0xf2361f40 4.39 0x104109 8192 19 0 0 0
11:11:14.975184 Lock 0xc2374210 2 0x1f8001
11:11:15.018400 7VS Write 0xc2374210 0x7c0 32768 10
11:11:15.018456 8LR Write 0xc2374210 13.39 0xcc0c9 32768
11:11:15.046229 Unlock 0xc2374210 2 0x1f8001

Поле Buf всегда содержит адрес заголовка пользовательского буфера. Его можно использовать для идентификации запроса, связанного с пользовательским запросом, хотя это и не на 100% надежно: теоретически, два последовательных запроса могут использовать один и тот же заголовок буфера, хотя это и нетипично. Начало запроса идентифицируется значениями 1VS или 7VS в поле Event. Первый представленный выше пример показывает запросы драйвера, связанные с выполнением запроса пользователя. Второй пример - запрос ввода-вывода поддиска с блокировкой.

Поле Event содержит информацию, связанную с последовательностью событий в цепочке выполнения запроса (request chain). Цифры от 1 до 6 показывают приблизительную последовательность событий, а двухбуквенное сокращение описывает действие:

1VS

(vinumstrategy) показывает информацию о пользовательском запросе при входе в vinumstrategy(). Номер устройства определяет устройство vinum, а смещение и длина - это пользовательские параметры. С такой записи всегда начинается последовательность выполнения запроса.

2LR

(launch_requests) показывает пользовательский запрос непосредственно перед выполнением низкоуровневых запросов vinum в функции launch_requests(). Параметры должны быть такими же, как и в записи 1VS.

В следующих запросах Dev - номер устройства соответствующего раздела диска, Offset - смещение от начала раздела, SD - индекс поддиска в vinum_conf, SDoff - смещение от начала поддиска, Doffset - смещение соответствующего запроса данных, а Goffset - смещение соответствующего запроса группы, если оно необходимо.

3RQ

(request) показывает один из, возможно, нескольких низкоуровневых запросов vinum, выполненных для удовлетворения запроса верхнего уровня. Эта информация также регистрируется в launch_requests().

4DN

(done) вызывается из complete_rqe(), показывая завершение запроса. Это завершение должно соответствовать запросу, инициированному либо на стадии 4DN из функции launch_requests(), либо из функции complete_raid5_write() на стадии 5RD или 6RP.

5RD

(RAID-5 data) вызывается из функции complete_raid5_write() и представляет данные, записанные на полосу данных массива RAID-5 после вычисления четности.

6RP

(RAID-5 parity) вызывается из функции complete_raid5_write() и представляет данные, записанные на полосу четности (parity stripe) массива RAID-5 после вычисления четности.

7VS

Показывает запрос ввода/вывода для поддиска. Эти запросы, обычно, являются внутренними для драйвера vinum и используются для операций типа инициализации или пересоздания сплетений.

8LR

Показывает низкоуровневую операцию, сгенерированную для запроса ввода/вывода для поддиска.

Lockwait

Указывает, что процесс ждет блокировки диапазона (range lock). Параметрами являются заголовок буфера, соответствующего запросу, номер сплетения и номер блока. Из внтуренних соображений номер блока - на единицу больше, чем адрес начала полосы.

Lock

Указывает, что была получена блокировка диапазона. Параметры такие же, как и для ожидания блокировки диапазона.

Unlock

Указывает, что блокировка диапазона была снята. Параметры такие же, как и для ожидания блокировки диапазона.

init [-S размер] [-w] сплетение | поддиск

Команда vinum init инициализирует поддиск путем записи на него нулей. Можно инициализировать все поддиски в сплетении, указав имя сплетения. Это - единственный способ гарантировать согласованность данных в сплетении. Эту инициализацию необходимо выполнять до начала использования сплетения типа RAID-5. Ее также рекомендуется выполнять и для других новых сплетений. Утилита vinum инициализирует все поддиски сплетения параллельно. Поскольку это действие может потребовать много времени, оно обычно выполняется в фоновом режиме. Если необходимо подождать завершения команды, используйте опцию -w (wait).

Укажите опцию -S, если необходимо записывать блоками нестандартного (отличающегося от 16 Кбайт) размера. Утилита vinum выдает сообщение на консоль по завершении инициализации.

label том

Команда label записывает на том метку тома в стиле ufs. Это - простая альтернатива соответствующему вызову утилиты disklabel. Ее выполнение необходимо потому, что некоторые команды ufs по-прежнему читают диск в поисках метки вместо того, чтобы выполнять соответствующий вызов ioctl(2) для доступа к ней. Драйвер vinum хранит метку тома отдельно от данных тома, так что эта команда не нужна для newfs(8). Использовать эту команду не рекомендуется.

list [-r] [-V] [том | сплетение | поддиск]
l [-r] [-V] [том | сплетение | поддиск]
ld [-r] [-s] [-v] [-V] [том]
ls [-r] [-s] [-v] [-V] [поддиск]
lp [-r] [-s] [-v] [-V] [сплетение]
lv [-r] [-s] [-v] [-V] [том]

Команда list используется для получения информации об указанном объекте. Если аргумент не указан, выдается информация о всех объектах, известных драйверу vinum. Команда l - синоним для list.

Опция -r относится к томам и сплетениям: если она указана, то рекурсивно выдает информацию для поддисков и (для тома) сплетений, составляющих объекты. Команды lv, lp, ls и ld выдают только тома, сплетения, поддиски и диски, соответственно. Они особенно полезны при вызове без параметров.

Опция -s вызывает выдачу утилитой vinum статистической информации по устройствам, опция -v (verbose) приводит к выдаче определенной дополнительной информации, а опция -V обеспечивает выдачу существенного объема дополнительной информации.

makedev

Команда makedev удаляет каталог /dev/vinum и пересоздает его вместе со специальными файлами устройств, отражающими текущую конфигурацию. Эта команда не предназначена для общего использования и должна использоваться только в критических ситуациях.

mirror [-f] [-n имя] [-s] [-v] диски

Команда mirror является упрощенной альтернативой команде create при создании зеркалированных томов. При вызове без опций она создает том типа RAID-1 (зеркалированный) из двух конкатенированных сплетений. Самые большие фрагменты свободного места на каждом диске используются для создания поддисков для сплетений. Первое сплетение строится из дисков в списке с нечетными номерами, а второе - из четных. Если диски - разного размера, то и сплетения получатся разного размера.

Если указана опция -s, команда mirror строит сплетения с чередованием, с размером полосы 279 Кбайт. Размер поддисков в каждом сплетении соответствует размеру наименьшего фрагмента подряд идущего свободного места на всех дисках, формирующих сплетение. И в этом случае рамзеры сплетений могут отличаться.

Обычно команда mirror автоматически создает имя для тома и его компонентов. Это имя состоит из слова "vinum" и небольшого целого числа, например, "vinum3". Это можно изменить с помощью опции -n имя, которая присваивает указанное имя тому. Имена сплетений и поддисков строятся на основе имени тома стандартным образом.

Имена дисков выбирать нельзя. Если диски уже были проинициализированы как диски vinum, их имена неизменны. В противном случае, диски получают имена, состоящие из слова "vinumdrive" и небольшого целого числа, например, "vinumdrive7". Как и в случае команды create, опция -f может использоваться для указания того, что прежнее имя надо изменить. Опция -v используется для выдачи более детальной информации.

Ряд примеров использования этой команды представлен в разделе "УПРОЩЕННОЕ КОНФИГУРИРОВАНИЕ" ниже.

mv -f диск объект ...
move -f диск объект ...

Переносит все поддиски указанных объектов на новый диск. Объектами могут быть поддиски, диски или сплетения. Если указаны диски или сплетения, переносятся все поддиски, связанные с этими объектами.

Опция -f для этой функции необходима, поскольку в настоящее время она не сохраняет данные на поддиске. Эта возможность будет добавлена в дальнейшем. Но и в нынешнем виде эта команда подходит для восстановления после сбоя диска.

printconfig [файл]

Записывает копию текущей конфигурации в файл в формате, который можно использовать для воссоздания конфигурации vinum. В отличие от хранящейся на диске конфигурации, она включает определения дисков. Если файл не указан, утилита vinum выдает информацию в стандартный выходной поток.

quit

Завершает работу утилиты vinum в интерактивном режиме. Обычно для этого достаточно ввести символ конца файла (EOF).

read диск ...

Команда read сканирует указанные диски в поисках разделов vinum, содержащих ранее созданную информацию о конфигурации. Она читает информацию о конфигурации, начиная с последних изменений и до самых давних. Утилита vinum поддерживает актуальну копию всей конфигурационной информации на каждом разделе диска. Необходимо указать все секции (slices) в конфигурации в качестве параметра этой команды.

Команда read предназначена для избирательной загрузки конфигурации vinum в системе, где есть другие разделы vinum. Если необходимо запустить все разделы в системе, проще использовать команду start.

Если по ходу выполнения этой команды утилитой vinum возникают любые ошибки, она отключает автоматическое обновление конфигурации, чтобы предотвратить повреждение копий на диске. Это также происходит, если в конфигурации на диске обнаруживается ошибка (например, поддиски с недопустимой спецификацией занимаемого места). Изменения можно возобновить с помощью команд setdaemon и saveconfig. Сбросьте бит 2 (числовое значение - 4) в маске опций демона, чтобы снова можно было сохранять изменения конфигурации.

rebuildparity сплетение [-f] [-v] [-V]

Пересоздает блоки четности для указанного сплетения типа RAID-4 или RAID-5. Это действие поддерживает указатель на сплетение, так что его можно остановить и в дальнейшем перезапустить с того же места, при необходимости. Кроме того, этот указатель используется командой checkparity, поэтому пересоздание блоков четности можно будет начать с того места, где выявлена первая проблема четности.

Если указан флаг -f, команда rebuildparity начинает пересоздание с начала сплетения. Если указан флаг -v, команда rebuildparity сначала проверяет существующие блоки четности и выдает информацию о тех из них, которые оказались некорректными до пересоздания. Если указан флаг -V, команда rebuildparity выдает отчет о ходе работы.

rename [-r] [диск | поддиск | сплетение | том] новое_имя

Изменяет имя указанного объекта. Если указана опция -r, подчиненные объекты будут переименовываться по стандартным правилам: имена сплетений будут строиться путем добавления .номер_сплетения к имени тома, а имена поддисков - путем добавления .номер_поддиска к имени сплетения.

resetconfig

Команда resetconfig полностью сбрасывает конфигурацию vinum в системе. Используйте эту команду только при необходимости полностью удалить конфигурацию. Утилита vinum попросит подтверждения; необходимо ввсести слова NO FUTURE как показано ниже:

# vinum resetconfig

WARNING! This command will completely wipe out your vinum
configuration. All data will be lost. If you really want
to do this, enter the text

NO FUTURE
Enter text -> NO FUTURE
Vinum configuration obliterated

Как и сказано в сообщении, эта команда - жест отчаяния. Используйте ее, только если хотите никогда больше не видеть существующую конфигурацию.

resetstats [-r] [том | сплетение | поддиск]

Драйвер vinum поддерживает ряд статистических счтетчиков для каждого объекта. Подробнее см. в заголовочном файле <sys/dev/vinumvar.h>. Команда resetstats используется для сброса этих счетчиков. При указании опции -r, vinum также сбрасывает счетчики подчиненных объектов.

rm [-f] [-r] том | сплетение | поддиск

Команда rm удаляет объект из конфигурации vinum. После удаления объекта восстановить его нельзя. Обычно перед удалением объекта утилита vinum выполняет множество проверок согласованности. Опция -f требует от vinum пропустить эти проверки и удалить объект в любом случае. Используйте эту опцию очень осторожно: она может привсети к полной потере данных тома.

Обычно команда vinum отказывается удалять том или сплетение, если у него есть подчиненные сплетения или поддиски, соответственно. Можно потребовать от vinum безусловного удаления объекта с помощью опции -f или просто удалить все подчиненные объекты тоже с помощью опции -r (recursive). При удалении тома с опцией -r будут удалены как сплетения, так и поддиски, принадлежащие сплетениям.

saveconfig

Сохраняет текущую конфигурацию на диск. Обычно это не нужно, поскольку утилита vinum автоматически сохраняет любые изменения в конфигурации. Если при запуске возникапет ошибка, обновления будут отключены. При их повторном включении с помощью команды setdaemon, vinum не сохраняет автоматически конфигурацию на диск. Используйте эту команду для сохранения конфигурации.

setdaemon [значение]

Команда setdaemon устанавливает переменную битовую маску для демона vinum. Эта команда - временная и будет заменена. В настоящее время битовая маска может содержать биты 1 (регистрировать каждое действие с помощью syslog) и 4 (не обновлять конфигурацию). Необязательный бит 4 может пригодиться при восстановлении после ошибки.

setstate состояние [том | сплетение | поддиск | диск]

Команда setstate устанавливает заданное состояние для указанных объектов. При этом не используется обычный механизм проверки согласованности vinum, так что эту команду следует использовать только для восстановления. Неправильное использование этой команды может вызвать сбой системы.

start [-i интервал] [-S размер] [-w] [сплетение | поддиск]

Команда start запускает (переводит в работающее состояние) одини или несколько объектов vinum.

Если имена объектов не указаны, утилита vinum сканирует все известные системе диски в поисках дисков vinum, а затем читает конфигурацию так, как было описано для команды read. Диск vinum (vinum drive) содердите заголовок со всей информацией о данных, хранящихся на диске, включая имена других дисков, которые необходимы для представления сплетений и томов.

Если по ходу выполнения этой команды утилитой vinum будут обнаружены ошибки, она отключит автоматическое обновление конфигурации, чтобы избежать повреждения копий на диске. То же самое произойдет, если конфигурация на диске содержит ошибку (например, поддиски с недопустимой спецификацией занимаемого места). Изменения можно возобновить с помощью команд setdaemon и saveconfig. Сбросьте бит 2 (числовое значение - 4) в маске опций демона, чтобы снова можно было сохранять изменения конфигурации.

Если имена объектов указаны, утилита vinum запускает их. Обычно эту операцию имеет смысл выполнять только для поддисков. Действие зависит от текущего состояния объекта:

• Если объект уже работает, утилита vinum ничего не делает.
• Если объект является поддиском в состояниях down или reborn, утлита vinum запускает его (меняет состояние на up).
• Если объект является поддиском в состоянии empty (пуст), изменение зависит от поддиска. Если он входит в сплетение, являющееся частью тома, в котором есть и другие сплетения, утилита vinum переводит поддиск в состояние reviving и пытается скопировать данные с тома. По завершении этой операции поддиск запускается. Если же поддиск входит в сплетение, являющееся частью тома, в котором других сплетений нет, или если он вообще не входит в сплетение, утилита vinum запускает его немедленно.
• Если объект является поддиском в состоянии reviving, утилита vinum продолжает его "оживление" в отключенном режиме. По завершении этой операции поддиск запускается.

Когда поддиск запускается (переводится в состояние up), утилита vinum автоматически проверяет состояние сплетения и тома, к которым он может принадлежать и изменяет их состояние при необходимости.

Если объект является сплетением, команда start проверяет состояние подчиненных поддисков (и сплетений, в случае тома) и запускает все поддиски, которые можно запустить.

Для запуска сплетения в томе из нескольких сплетений данные должны быть скопированы с другого сплетения в томе. Поскольку зачастую для этого требуется много времени, это обычно делается в фоновом режиме. Если необходимо дождаться завершения этой операции (например, если она выполняется в сценарии), используйте опцию -w.

Копирование данных не только требует много времени, но и может существенно нагружать систему. Можно указать размер передаваемого блока в байтах или секторах с помощью опции -S, и интервал (в миллисекундах) ожидания между копированиями каждого блока с помощью опции -i. Обе эти опции позволяют снизить нагрузку на систему.

stop [-f] [том | сплетение | поддиск]

Если параметры не указаны, команда stop удаляет демон ядра vinum и останавливает vinum(4). Это можно сделать, только если ни один из объектов не активен. В частности, опция -f не позволяет обойти это требование. Обычно команда stop записывает текущую конфигурацию обратно на диски перед завершением работы. Это будет невозможно, если изменения конфигурации отключены, поэтому vinum не остановится, если изменения конфигурации отключены. Это можно обойти, указав опцию -f.

Команда stop может работать только если vinum был загружен как демон ядра (kld), поскольку статически сконфигурированных драйвер выгрузить нельзя. Команда vinum stop не сработает, если vinum сконфигурирован статически.

Если имена объектов указаны, команда stop отключает доступ к объектам. Если объекты имеют подчиненные объекты, эти подчиненные объекты должны быть либо не активны (остановлены или в состоянии ошибки), либо надо указывать опции -r и -f. Эта команда не удаляет объекты из конфигурации. К ним можно будет снова получить доступ после команды start.

По умолчанию утилита vinum не останавливает активные объекты. Например, нельзя остановить сплетение, подключенное к активному тому, и нельзя отключить открытый том. Опция -f требует от vinum пропустить эту проверку и удалить объект в любом случае. Используйте эту опцию максимально осторожно, и только помня о последствиях: при некорректном использовании она может привести к серьезному повреждению данных.

stripe [-f] [-n имя] [-v] диски

Команда stripe является упрощенной альтернативой команде create для создания томов из единственного сплетения с чередованием. Размер поддисков определяется как размер максимального фрагмента свободного места, доступного на всех указанных дисках. Размер полосы фиксирован - 279 Кбайт.

Обычно команда stripe создает для тома и его компонентов стандартные имена. Имя состоит из слова "vinum" и небольшого целого числа, например, "vinum3". Можно задать нестандартное имя с помощью опции -n имя, что присваивает указанное имя тому. Имена сплетений и поддисков строятся на основе имени тома стандартным образом.

Имена для дисков задавать нельзя. Если диски уже были проинициализированы как диски vinum, имя остается. В противном случае, диски получают имена, начинающиеся со слова "vinumdrive", и заканчивающееся небольшим целым числом, например, "vinumdrive7". Как и в случае команды create, можно использовать опцию -f для изменения прежнего имени. Опция -v используется для получения детальных результатов.

Несколько примеров использования этой команды см. в разделе "УПРОЩЕННОЕ КОНФИГУРИРОВАНИЕ" ниже.

УПРОЩЕННОЕ КОНФИГУРИРОВАНИЕ

В этом разделе описан упрощенный интерфейс для конфигурирования vinum с помощью команд concat, mirror и stripe. Эти команды создают удобные конфигурации для ряда стандартных ситуаций, но не обеспечивают такую гибкость, как команда create.

Описание этих команд было представлено выше. Вот ряд примеров, построенных на одном и том же наборе дисков. Учтите, что первый диск, /dev/da1h, - меньше других. Это влияет на размеры поддисков каждого вида.

Во всех следующих примерах используется -v, чтобы показать команды, передаваемые в систему, а также для получения информации о структуре тома. Без опции -v эти команды ничего не выдают.

  Том с одним конкатенированным сплетением

Используйте том с одним конкатенированным сплетением для получения максимально возможного объема дисковой памяти без обеспечения защиты от сбоев диска:

vinum -> concat -v /dev/da1h /dev/da2h /dev/da3h /dev/da4h
volume vinum0
 plex name vinum0.p0 org concat
drive vinumdrive0 device /dev/da1h
 sd name vinum0.p0.s0 drive vinumdrive0 size 0
drive vinumdrive1 device /dev/da2h
 sd name vinum0.p0.s1 drive vinumdrive1 size 0
drive vinumdrive2 device /dev/da3h
 sd name vinum0.p0.s2 drive vinumdrive2 size 0
drive vinumdrive3 device /dev/da4h
 sd name vinum0.p0.s3 drive vinumdrive3 size 0
V vinum0 State: up Plexes: 1 Size: 2134 MB
P vinum0.p0 C State: up Subdisks: 4 Size: 2134 MB
S vinum0.p0.s0 State: up D: vinumdrive0 Size: 414 MB
S vinum0.p0.s1 State: up D: vinumdrive1 Size: 573 MB
S vinum0.p0.s2 State: up D: vinumdrive2 Size: 573 MB
S vinum0.p0.s3 State: up D: vinumdrive3 Size: 573 MB

В нашем случае использовано все место на всех четырех дисках, что дало нам в итоге 2134 Мбайта.

  Том с одним сплетением с чередованием

То