/
How to use BEADM utility

How to use BEADM utility

Owned by Vitaly Shaburov (Unlicensed)
Last updated: Jan 25, 2023
15 min read

Название

beadm - управляет загрузочными разделами (Boot Environments) ZFS

Формат команды

beadm create [-a] [-d description] [-e non-activeBeFmri | BeFmri@snapshot] [-o property=value] ... BeFmri
beadm create BeFmri@snapshot
beadm destroy [-fF] {BeFmri | BeFmriPattern}... | BeFmri@snapshot ... beadm destroy [-fF] -O
beadm list [[[-a | -ds] [-Z]] | [-o attr[,attr]...]...] [-H] [{BeFmri| BeFmriPattern}...]
beadm list -z zonename [-z zonename]... [[-a | -ds] | [-o attr[,attr]...]...] [-H]
beadm mount [-b] BeFmri mountpoint
beadm unmount [-f] BeFmri
beadm rename BeFmri newBeFmri
beadm set-policy {-n [-]policy [-n [-]policy2] ...} BeFmri [BeFmri2 .
beadm activate BeFmri

Описание

Команда beadm - это пользовательский интерфейс для управления ZFS Boot Environments (BEs). Эта утилита предназначена для работы системных администраторов, которые хотят управлять несколькими экземплярами Oracle Solaris на одной системе. Пользователи определяют несколько BE, управляемые BeFmris. Более подробная информация про BeFmris приводится здесь: fmri(7) man page.

С помощью beadm Выможете делать следующее:

  • Создавать новый BE на основе активного BE.

  • Создавать новый BE на основе неактивного BE.

  • Создавать снапшот (слепок) существующего BE.

  • Создавать новый BE на основе существующего снапшота.

  • Активироать существующий неактивный BE.

  • Монтировать BE.

  • Размонтировать BE.

  • Удалять BE.

  • Удалять снапшот BE.

  • Переименовывать существующий неактивный BE.

  • Устанавливать атрибут policy на набор из нескольких BE.

  • Получать информацию о снапшотах, наборах данных (datasets) неглобальных зонах BE.

Подкоманды

У команды beadm имеются подкомандыи опции, которые приводятся ниже. Как пользоваться многими из них можно посмотреть в разделе EXAMPLES ниже.

  • beadm (без аргументов)

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

  • beadm create [–a] [–d description] [–e non-activeBeFmri | BeFmri@snapshot] [–o property=value] ... BeFmri

Создаёт новый BE с именем BeFmri. Если опция –e не указывается, то новый BE будет создан как клон текущего работающего BE. Если указана опция –d, то description будет использоваться в качестве названия точки входа нового BE в меню GRUB (для систем x86) или в загрузочном меню (для систем SPARC). Если опция –d не указывается, то в качестве названия используется BeFmri. Также опция –e не может применяться к незагружаемым BE и снапшотам незагружаемых BE.

–a

Активирует вновь соданный BE в процессе создания. По умолчанию новый BE не активируется.

–d description

Создаёт новый BE с этим описанием.

–e non-activeBeFmri

Создаёт новый BE из существующего неактивного BE, который находится в этом жеzpool , что и новый BE. Копирование BE между пулами запрещено. В BE зоны эта опция может применяться только к загружаемым BE.

–e beFmri@snapshot

Создаёт новый BE из существующего снапшота BE с именем beFmri. Эта опция в BE зоны может применяться только к снапшотам загружаемых BE.

–o property=value

Создаёт наборы данных для нового BE с указанными пропертями ZFS. Можно указывать несколько опций –o. Более подробно об этой опции написано в zfs(8).

  • beadm create BeFmri@snapshot

Создаёт снапшот из существующего BE с именем beFmri. В BE зоны применяется только к загружаемым BE.

  • beadm destroy [–fF] {BeFmri | BeFmriPattern} ... | BeFmri@snapshot ...

Удаляет один или несколько BE или снапшотов существующих BE в соответствии с BeFmri или BeFmriPattern.

BeFmriPattern позволяет включать символы ? или *, как glob(3C)-style wildcards в имени BE или поле zbe-name BeFmri, что соответствует одному или нескольким BE. Символы ? и * не допускаются в поле zpool и zonename BeFmri.

Note : При удалении BE все снапшоты этого BE тоже будут удалены. Поэтому будьте внимательны.

При выполнении из глобальной зоны, если BeFmri или BeFmriPattern ссылаются на BE неглобальной зоны, могут быть удалены только BE неглобальной зоны, которые не помечены как активные при перезагрузке.

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

–f

Принудительно размонтирует BE, если он в настоящий момент смонтирован.

–F

Выполяется без запроса подтверждения на удаление BE.

–O

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

  • beadm list [[[–a | –ds] [–Z]] | [–o attr[,attr]...]...] [–H] [{BeFmri| BeFmriPattern}...]

Выводит инфоормацию о существующих BE, соответствующих указааным BeFmri или BeFmriPattern. Если же BeFmri или BeFmriPattern не указаны, то выводится инфоормация обо всех BE в пуле текущего BE. Для вывода информации о BE, не принадлежащих пулам текущего BE, нужно указать BeFmriPattern be://<zpool_name>/*.

При выводе списка поле Flags показывает, активен ли BE в настоящий момент (N), будет ли он активен при перезагрузке (R) или и то, и другое (NR). Незагружаемые BE глобальной зоны помечаются восклицательным знаком (!). В таких BE версия поддерживаемого пула ZFS меньше, чем версия загрузочного пула. Незагружаемые BE внутри зоны BE также помечаются восклицательным знаком (!). В таких зонах флаг ! означает, что загрузочные артифакты BE находятся вне загрузочного пула, и т.о. BE НЕ МОЖЕТ быть загружен непосредственно. (Для перемещения загрузочных артифактов в загрузочный пул BE или активируйте BE подкомандой activate, или измените политику BE на noevict при помощи подкоманды set-policy). BE зоны, не имеющие соответствующих BE глобальной зоны, помечаются символом (O), что означает, что у них нет родительского BE.

–a

Выводит всю имеющуюся информацию о BE, включая подчинённые файловые системы и снапшоты.

–d

Выводит информацию обо всех подчинённых файловых системах, принадлежащих BE.

–s

Выводит информацию о снапшотах BE.

–Z

Выводит все BE зоны, ассоциированные с BE глобальной зоны. Эта опция может применяться только из глобальной зоны.

–o attr

Выводит указанные атрибуты, отсортированные по значению первого из перечисленных атрибутов. Опция –o может быть указана несколько раз, или в одной опции можно указать несколько атрибутов, разделяемых запятыми.

Опция –o может быть использована без параметров для вывода атрибутов в табличном виде. Её можно использовать вместе с опцией –H для получения вывода с ; в качестве разделителя.

Если у атрибута есть несколько значений, а опция –H не указана, тогда каждое значение будет выведено в отдельной строке в соответствующей колонке. Если одновременно будут выводиться атрибуты с множественными и единственными значениями, то атрибуты с единственным значением будут выводится один раз в соответствующей колонке.

Если при выводе атрибутов с множественными значениями указаны обе опции - –o и –H, то множественные значения упаковываются в одну строку с : в качестве разделителя.

Можно указывать атрибуты из списка, приведённого ниже (имена атрибутов чувствительны к регистру).

created

Дата создания BE.

datasets

Выводит все подчинённые файловые системы BE. Этот атрибут может иметь множественные значения.

flags

Выводит информацию, как описано выше для поля Flags.

fmri

FMRI этого BE.

mountpoint

Точка монтирования BE, если он смонтирован. Если BE не смонтирован, то поле остаётся пустым.

name

Имя BE.

ngz_bes

FMRI всех BE неглобальной зоны, ассоциированных с BE глобальной зоны. Это поле используется только с BE глобальной зоны. Для BE неглобальной зоны оно будет пустым. Этот атрибут может иметь множественные значения.

parent_fmri

FMRI родительского BE для BE неглобальной зоны. Это поле используется только с BE неглобальной зоны. Для BE глобальной зоны оно будет пустым.

parent_uuid

UUID родительского BE для BE неглобальной зоны. Это поле используется только с BE неглобальной зоны. Для BE глобальной зоны оно будет пустым.

policy

Политика BE.

pool_version

Максимальная поддерживаемая BE версия пула, если известна. Если неизвестна, выводится (-). Проперти pool_version очищается, когда BE монтируется для четния/записи, и обновляется, когда BE размонтируется, т.е. когда любой неактивный BE монтируется для чтения/записи, её значение неопределено.

root_dataset

Имя файловой системы ZFS корневого набора данных BE.

snapshots

Выводит снапшоты ZFS, принадлежащие BE. Этот атрибут может иметь множественные значения.

space

Общий размер BE.

uuid

UUID BE. Это поле может быть пустым для BE неглобальной зоны.

zpool

Имя пула, в котором находится BE.

–H

Запрашивает форматный вывод. Формат вывода - список строк с полями, разделёнными ;. Поле размера отображается в байтах, а поле даты создания отображается в формате UTC.

Без опций выводится одна строка со следующими полями для каждого BE. При запуске в глобальной зоне поле uuid - это uuid BE, если есть. Это поле будет пустым, если значение отсутствует. При запуске в неглобальной зоне поле uuid представляет uuid ассоциированного родительского BE.

be-name;uuid;flags;mountpoint;space;policy;created

Если указаны опции –a, –d, или –s, одна или несколько следующих строк выводится для каждого BE. fs_name в этом случае или имя файловой системы ZFS, или имя снапшота ZFS, в зависимости от того, указана опция –d или –s.

be-name;fs_name;flags;mountpoint;space;policy;created

Если указана опция –Z, для каждого BE неглобальной зоны выводится одна или несколько строк следующего формата. be-name - имя BE глобальной зоны, ассоциированного с BE неглобальной зоны. Все остальные поля - атрибуты BE неглобальной зоны.

be-name;ngz-be-fmri;flags;mountpoint;space;created

Если указана опция –o, значения указанных атрибутов выводятся как строка с полями, разделёнными ;.

  • beadm list –z zonename [–z zonename]... [[–a | –ds] | [–o attr[,attr]...]...] [–H]

Выводит информацию обо всех BE зоны в указанных зонах. Эта команда работает только из глобальлной зоны. Указанное имя zonename должно быть определно в текущем глобальном BE.

–a

Выводит всю доступную информацию о каждом BE зоны, включая подчинённые файловые системы и снапшоты.

–d

Выводит информацию обо всех подчинённых файловых системах, принадлежащих каждому BE зоны.

–s

Выводит информацию о снапшотах каждого BE зоны.

–o attr

Выводит информацию об указанных атрибутах каждого BE зоны, отсортированную по значению первого выводимого атрибута. Опция –o может быть указана несколько раз, или в одной опции можно указать несколько атрибутов, разделяемых запятыми. Список допустимых имён атрибутов был приведён выше.

–H

Не выводит заголовок. Каждое поле в списке оделяется ;.

Без опций выводится одна строка со следующими полями для каждого BE зоны:

zbe_fmri;parent_fmri;flags;mountpoint;space;created

Если указаны опции –a, –d, или –s, одна или несколько следующих строк выводится для каждого BE зоны:

zbe_fmri;parent_fmri;fs_name;flags;mountpoint;space;created

Если указана опция –o, указанные атрибуты выводятся в виде строк с полями, разделяемыми ;.

–z zonename

Выводит все BE в указанной зоне. Для вывода BE из нескольких зон укажите опцию –z несколько раз.

  • beadm mount [–b] BeFmri mountpoint

Монтирует BE с именем BeFmri в mountpoint. mountpoint должна быть существующая пустая директория.

Если в командную строку включён аргумент –b, и если есть активный загрузочный набор данных, ассоциированный с указанным BE, этот загрузочный набор данных будет смонтирован в <mountpoint>/bootpool_data. Эта директория создаётся автоматически при монтировании набора данных и автоматически удаляется при размонтировании BE подкомандой beadm unmount.

Note : при размонтировании BE другим способом эта директория не НЕ очищается.

  • beadm unmount [–f] BeFmri

Размонтирует BE с именем BeFmri.

–f

Размонтирует BE принудительно, даже если он занят в текущий момент.

  • beadm rename BeFmri newBeFmri

Переименовывает BE с именем BeFmri в newBeFmri. Для BE зоны можно переименовать только загружаемые BE.

  • beadm set-policy {–n [-]policy [–n [-]policy2] ...} BeFmri [BeFmri2] ...

Устанавливает (или стирает) указанный набор политик для указанного списка BE. Допускается множественный аргумент –n. Строка политики, следующая за –n, может начинаться с дефиса. Если она начинается с дефиса, то эта политика удаляется с указанных BE. Текущий набор поддерживаемых политик:

static

BE, ассоциированный с корневым пулом, управляется вручную, а соответствующий загрузочный набор данных (dataset) в загрузочном пуле управляется системой (если существует активный загрузочный пул).

auto

Если ассоциированный BE создан сервисом автоматического обновления системы svc:/system/auto-update:default, то он будет автоматически удаляться экземпляром svc:/system/auto-update:cleanup в соответствии с проперти config/keep.

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

Политику auto нельзя установить при помощи beadm, он устанавливается только при создании BE сервисом автоматического обновления.

noevict

Работает для корневого набора данных пула BE так же, как и политика static, но соответствующий загрузочный набор данных в загрузочном пуле (если существует активный загрузочный пул) создаётся (если его ещё нет) и никогда не удаляется, даже если нехватка доступного пространства в загрузочном пуле не позволяет перенести соответствующий загрузочный набор данных другого BE в загрузочный пул.

NOTE : Размер загрузочного пула не может превышать 85% от максимально доступного места для сохранения максимальной производительности системы.

  • beadm activate BeFmri

Делает BE с именем BeFmri активным при следующей перезагрузке. В BE зоны только загружаемые BE могут быть активированы.

Поддержка BE зоны

beadm поддерживает концепцию BE зоны, в частности, в том, что касается BE для неглобальных зон. beadm может управлять BE зоны из BE глобальной зоны или изнутри неглобальной зоны.

Все команды beadm можно использовать для управления BE зоны. BE зоны должен быть определён из глобальной зоны с BE FMRI, где указаны оба - имя зоны и имя BE зоны.

Функции beadm в неглобальной зоне работают так же, как и в глобальной зоне, за несколькими исключениями. Есть различие в определении, загружаемый или незагружаемый данный BE (или снапшот BE). BE зоны является загружаемым, если он ассоциирован (т.е. разделяет тот же родительский id, что и UUID BE глобальной зоны) с активным в настоящий момент BE глобальной зоны. В противном случае он считается незагружаемым и помечается знаком '!' в колонке active команды beadm list.

Note : Хотя администратор неглобальной зоны может пометить такой BE как активный вызовом beadm activate, при перезагрузке неглобальной зоны этот BE не будет загружен, потому что BE ассоциирован с BE неглобальной зоны.

BE зоны считается потерянным, если он связан с BE глобальной зоны, который не существует в этой системе, вероятно, из-за миграции зоны. В соответствии с этими условиями beadm ограничивает некоторые действия с незагружаемыми BE следующим образом:

  • Нельзя удалить незагружаемый BE зоны, помеченный как активный при следующей перезагрузке, если незагружаемый BE зоны не является потерянным.

  • Нельзя сделать активным незагружаемый BE.

  • Нельзя сделать снапшот незагружаемого BE.

  • Нельзя использовать beadm create с опцией –e применительно к незагружаемому BE или снапшоту BE.

  • Нельзя переименовывать незагружаемый BE.

Примеры

Пример 1 Создание нового BE с использованием активного BE

Нижеследующая команда создаёт новый BE BE1 клонированием текущего BE.

# beadm create BE1

Пример 2 Создание нового BE с использованием неактивного BE

Нижеследующая команда создаёт новый BE BE2 клонированием существующего неактивного BE с именем BE1.

# beadm create -e BE1 BE2

Пример 3 Создание снапшота существующего BE

Эта команда создаёт снапшот с именем now из существующего BE с именем BE1.

# beadm create BE1@now

Пример 4 Клонирование снапшота для создания нового BE

Нижеследующая команда создаёт новый BE BE3 клонированием существующего снапшота BE1.

# beadm create -e BE1@now BE3

Пример 5 Создание нового BE зоны

Следующая команда создаёт новый BE зоны с именем ZBE1 из запущенного в настоящий момент BE зоны для зоны zone1.

# beadm create zbe://zone1/ZBE1

Пример 6 Создание нового BE с подключением сжатия

Следующая команда создаёт новый BE BE5 из запущенного в настоящий момент BE. Команда создаёт новые наборы данных BE со включенным сжатием.

# beadm create -o compression=on BE5

Пример 7 Создание нового BE с описанием

Эта команда создаёт новый BE BE6из запущенного в настоящий момент BE и добавляет его описание.

# beadm create -d "BE6 used as test environment" BE6

Example 8 Активирование BE

Эта команда активирует существующий неактивный BE BE3.

# beadm activate BE3

Пример 9 Монтирование BE

Следующая команда монтирует BE BE3 в папку /mnt.

# beadm mount BE3 /mnt

Пример 10 Размонтирование BE

Следующая команда монтирует BE BE3.

# beadm unmount BE3

Пример 11 Удаление BE

Следующая команда удаляет BE BE3 без запроса подтверждения.

# beadm destroy -F BE3

Пример 12 Удаление снапшота

Следующая команда удаляет снапшот BE1 с именем now.

# beadm destroy BE1@now

Пример 13 Переименование BE

Эта команда переименует существующий неактивный BE BE1 в BE3.

# beadm rename BE1 BE3

Пример 14 Вывод списка всех BE

Следующая команда выводит список всех существующих BE.

# beadm list BE Name Flags Mountpoint Space Policy Created ----------- ----- ---------- ------- ----------- ---------------- 11.4.15.4.0 - - 1.83G auto,static 2019-10-02 02:37 11.4.16.4.0 N / 211.10M auto,static 2019-11-04 02:21 11.4.17.4.0 R - 8.08G auto,static 2019-12-17 02:40 app-upgrade - - 58.33M static 2019-11-11 14:38

Пример 15 Вывод списка всех BE с информацией о наборах данных и снапшотах

Следующая команда выводит список всех существующих BE со списком всех наборов данных и снапшотов этих BE.

# beadm list -d -s BE Name Flags Mountpoint Space Policy Created -------------- ----- ---------- ------- ------ ---------------- BE1 - - 5.27M static 2015-10-16 10:45 In-BE Datasets Mountpoint Space Created ------------------ ---------- ------- ---------------- rpool/ROOT/BE1 - 5.27M 2015-10-16 10:45 rpool/ROOT/BE1/var - 392.50K 2015-10-16 10:45 Snapshots Space Created --------- ----- ------- BE Name Flags Mountpoint Space Policy Created -------------- ----- ---------- ------- ------ ---------------- BE2 NR / 4.37G static 2015-10-19 07:04 In-BE Datasets Mountpoint Space Created ------------------ ---------- ----- ---------------- rpool/ROOT/BE2 / 4.11G 2015-10-19 07:04 rpool/ROOT/BE2/var /var 1.85G 2015-10-19 07:04 Snapshots Space Created -------------------------------------- ------- ---------------- rpool/ROOT/BE2@2015-10-16-17:45:07 48.33M 2015-10-16 10:45 rpool/ROOT/BE2@2015-10-16-16:45:00 47.58M 2015-10-16 09:45 rpool/ROOT/BE2@2015-10-20-05:59:31 55.82M 2015-10-20 05:59 rpool/ROOT/BE2@install 47.80M 2015-10-16 08:37 rpool/ROOT/BE2@2015-10-19-07:04:08 71.54M 2015-10-19 07:04 rpool/ROOT/BE2/var@2015-10-16-17:45:07 360.38M 2015-10-16 10:45 rpool/ROOT/BE2/var@2015-10-16-16:45:00 1.12M 2015-10-16 09:45 rpool/ROOT/BE2/var@2015-10-20-05:59:31 963.00K 2015-10-20 05:59 rpool/ROOT/BE2/var@2015-10-19-07:04:08 1.13M 2015-10-19 07:04 rpool/ROOT/BE2/var@install 1.22M 2015-10-16 08:37 BE Name Flags Mountpoint Space Policy Created -------------- ----- ---------- ------- ------ ---------------- BE3 - - 2.00K static 2015-10-20 05:59 In-BE Datasets Mountpoint Space Created ------------------ ---------- ----- ---------------- rpool/ROOT/BE3 - 2.00K 2015-10-20 05:59 rpool/ROOT/BE3/var - 1.00K 2015-10-20 05:59 Snapshots Space Created --------- ----- ------- BE Name Flags Mountpoint Space Policy Created -------------- ----- ---------- ------- ------ ---------------- solaris - - 64.61M static 2015-10-16 08:34 In-BE Datasets Mountpoint Space Created ---------------------- ---------- ------ ---------------- rpool/ROOT/solaris - 64.61M 2015-10-16 08:34 rpool/ROOT/solaris/var - 3.27M 2015-10-16 08:34 Snapshots Space Created --------- ----- -------

Пример 16 Вывод списка наборов данных и снапшотов BE

Следующая команда выводит список всей имеющейся информации о BE2.

# beadm list -a BE2 BE Name Flags Mountpoint Space Policy Created ------- ----- ---------- ----- ------ ---------------- BE2 NR / 4.37G static 2015-10-19 07:04 Details: -------- Zpool.......... rpool UUID........... 34ee56de-24fb-4765-a935-afb71dab2850 FMRI........... be://rpool/BE2 Root Dataset... rpool/ROOT/BE2 In-BE Datasets Mountpoint Space Created ------------------ ---------- ----- ---------------- rpool/ROOT/BE2 / 4.11G 2015-10-19 07:04 rpool/ROOT/BE2/var /var 1.85G 2015-10-19 07:04 Snapshots Space Created -------------------------------------- ------- ---------------- rpool/ROOT/BE2@2015-10-16-17:45:07 48.33M 2015-10-16 10:45 rpool/ROOT/BE2@2015-10-16-16:45:00 47.58M 2015-10-16 09:45 rpool/ROOT/BE2@2015-10-20-05:59:31 55.82M 2015-10-20 05:59 rpool/ROOT/BE2@install 47.80M 2015-10-16 08:37 rpool/ROOT/BE2@2015-10-19-07:04:08 71.54M 2015-10-19 07:04 rpool/ROOT/BE2/var@2015-10-16-17:45:07 360.38M 2015-10-16 10:45 rpool/ROOT/BE2/var@2015-10-16-16:45:00 1.12M 2015-10-16 09:45 rpool/ROOT/BE2/var@2015-10-20-05:59:31 963.00K 2015-10-20 05:59 rpool/ROOT/BE2/var@2015-10-19-07:04:08 1.13M 2015-10-19 07:04 rpool/ROOT/BE2/var@install 1.22M 2015-10-16 08:37

Пример 17 Форматный вывод

Следующая команда выводит информацию обо всех BE в автоматически разбираемом формате.

# beadm list -H BE1;73425d63-27d3-47b4-88ef-ee019ca325c2;-;-;5528064;static;1445017508 BE2;34ee56de-24fb-4765-a935-afb71dab2850;NR;/;4693830144;static;1445263448 BE3;356b3e5c-dae2-4d84-914c-f7eed84fa0c4;-;-;2048;static;1445345971 solaris;83d3ee87-62da-4eec-bfa0-b964ff27c01d;-;-;67743744;static;1445009664

Пример 18 Вывод BE зоны, ассоциированных с BE глобальной зоны

Эта команда выводит список всех BE зоны, принадлежащих BE2. Команда запускается из глобальной зоны.

# beadm list -Z BE2 BE Name Flags Mountpoint Space Policy Created ------- ----- ---------- ----- ------ ---------------- BE2 NR / 4.37G static 2015-10-19 07:04 Non-global Zone BE Names Flags Mountpoint Space ------------------------- ----- ------------------------ ------- zbe://zone1/solaris N /system/zones/zone1/root 1.04M zbe://zone1/zbe2 - - 2.00K zbe://zone1/zbe1 R - 17.10M zbe://zone2/solaris NR /system/zones/zone2/root 803.80M zbe://zone4/solaris NR /system/zones/zone4/root 803.87M zbe://zone3/solaris NR /system/zones/zone3/root 803.84M

Пример 19 Вывод списка всех BE зоны в зоне

Эта команда выводит список всех BE в zone1. Запускается из глобальной зоны.

# beadm list -z zone1 Non-global Zone BE Names Parent BE Flags Mountpoint Space ------------------------- ------------- ----- ------------------------ ------- zbe://zone1/BE10 - RO - 705.10M zbe://zone1/BE3 be://rpool/BE3 R - 803.73M zbe://zone1/solaris be://rpool/BE2 N /system/zones/zone1/root 1.04M zbe://zone1/zbe1 be://rpool/BE2 R - 17.10M zbe://zone1/zbe2 be://rpool/BE2 - - 2.00K

Пример 20 Вывод всех незагружаемых BE в BE зоны

Команда выолняется в zbe:/zone1/solaris. Она выводит список и загружаемых, и незагружаемых BE. Незагружаемые BE помечаются знаком ! в колонке Flags, а потерянные BE ещё и знаком O в этой же колонке.

# beadm list BE Name Flags Mountpoint Space Policy Created ------- ----- ---------- ------- ------ ---------------- BE10 !RO - 705.10M static 2015-10-21 05:00 BE3 !R - 803.73M static 2015-10-20 05:59 solaris N / 1.04M static 2015-10-19 14:47 zbe1 R - 17.10M static 2015-10-20 07:25 zbe2 - - 2.00K static 2015-10-20 07:25

Пример 21 Установка флагов политики для набора BE

Следующая команда устанавливает атрибут noevict для BE с именами named BE1, BE2 и BE3 (и также пересылает загрузочные артифакты BE1, BE2 и BE3 в загрузочный пул):

# beadm set-policy -n noevict BE1 BE2 BE3 # beadm list BE Flags Mountpoint Space Policy Created -- ----- ---------- ----- ------ ------- BE1 - - 6.13M noevict,static 2014-10-20 09:14 BE2 NR / 52.86M noevict,static 2014-10-21 04:33 BE3 - - 559.0K noevict,static 2014-10-22 01:59 BE4 !- - 313.1M static 2014-10-22 04:19

А эта команда очищает атрибут noevict (путем установки списка атрибутов на значение, которое его не включает):

# beadm set-policy -n -noevict BE2 # beadm list BE Flags Mountpoint Space Policy Created -- ----- ---------- ----- ------ ------- BE1 - - 6.13M noevict,static 2014-10-20 09:14 BE2 NR / 52.86M static 2014-10-21 04:33 BE3 - - 559.0K noevict,static 2014-10-22 01:59 BE4 !- - 313.1M static 2014-10-22 04:19

Пример 22 Ввод списка указанных атрибутов всех BE

Следующая команда выводит список всех имён BE, дат создания и корневых наборов данных для всех BE.

# beadm list -o name,created,root_dataset BE Name Created Root Dataset -------------- ---------------- -------------- BE1 2015-10-16 10:45 rpool/ROOT/BE1 BE2 2015-10-19 07:04 rpool/ROOT/BE2 BE3 2015-10-20 05:59 rpool/ROOT/BE3 solaris 2015-10-16 08:34 rpool/ROOT/solaris

Пример 23 Ввод списка указанных атрибутов для нескольких BE

Эта команда выводит список имён BE, подчинённых файловых систем и дат созданиядля всех BE, соответствующих BeFmriPattern.

# beadm list -o name,datasets,created be://rpool/BE* BE Name Datasets Created -------------- ---------------- -------------- BE1 rpool/ROOT/BE1 2015-10-16 10:45 rpool/ROOT/BE1/var rpool/ROOT/BE1/my_fs BE2 rpool/ROOT/BE2 2015-10-19 07:04 rpool/ROOT/BE2/var BE3 rpool/ROOT/BE3 2015-10-20 05:59 rpool/ROOT/BE3/var

Пример 24 Ввод списка указанных атрибутов

Вывод списка name, flags, mountpoint, policy и дат создания для всех BE. Эти атрибуты включаются в вывод команды beadm list по умолчанию. Обычно включаемый атрибут Space здесь не указывается. Отсутствие атрибута Space в явном виде может быть полезно в системе с большим количеством зон, поскольку вычисление размера для каждого BE в таких системах занимает больше времени, что приводит к замедлению выполнения команды beadm list.

# beadm list -o name,flags,mountpoint,policy,created BE Name Flags Mountpoint Policy Created ---------------- ----- ---------- ------ ---------------- BE1 - - static 2016-09-06 10:15 BE2 - - static 2016-09-06 11:38 BE3 - - static 2016-09-14 15:24 solaris - - static 2010-09-01 12:32

Возвращаемое значение

0

Success.

>0

Failure.

Файлы

<log_dir>/beadm/beadm.yyyymmdd_hhmmss.<pid>.log

Лог используется для записи результатов отладки beadm. Файл лога создается в одном из следующих 3 мест для каждого вызова команды.

  1. /var/share/beadm: Это предпочтительное место расположения, если оно доступно, и у пользователя есть права на запись в этот каталог.

  2. /system/volatile/beadm: Эта папка используется, если набор данных /var/share ещё не смонтирован.

  3. /tmp/beadm: Этот каталог используется, если у пользователя нет прав на запись в предыдущие 2 каталога.

Время в имени файла обозначается как:

  • yyyymmdd_hhmmss — например, 20071130_140558.

  • yyyy — год, 2007

  • mm — месяц, 11

  • dd — день, 30

  • hh — часы, 14

  • mm — минуты, 05

  • ss — секунды, 58

Если команда выполнена успешно, лог автоматически удаляется. В случае сбоя команды сообщение об ошибке будет содержать полный путь к логу. Ответственность за удаление лога лежит на пользователе.

Related content