community.general.beadm – Manage ZFS boot environments on FreeBSD/Solaris/illumos systems.

Note

This plugin is part of the community.general collection (version 3.8.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.beadm.

Synopsis

Create, delete or activate ZFS boot environments.
Mount and unmount ZFS boot environments.

Parameters

Parameter	Choices/Defaults	Comments
description string		Associate a description with a new boot environment. This option is available only on Solarish platforms.
force boolean	Choices: no ← yes	Specifies if the unmount should be forced.
mountpoint path		Path where to mount the ZFS boot environment.
name string / required		ZFS boot environment name. aliases: be
options string		Create the datasets for new BE with specific ZFS properties. Multiple options can be specified. This option is available only on Solarish platforms.
snapshot string		If specified, the new boot environment will be cloned from the given snapshot or inactive boot environment.
state string	Choices: absent activated mounted present ← unmounted	Create or delete ZFS boot environment.

Examples

- name: Create ZFS boot environment
  community.general.beadm:
    name: upgrade-be
    state: present

- name: Create ZFS boot environment from existing inactive boot environment
  community.general.beadm:
    name: upgrade-be
    snapshot: be@old
    state: present

- name: Create ZFS boot environment with compression enabled and description "upgrade"
  community.general.beadm:
    name: upgrade-be
    options: "compression=on"
    description: upgrade
    state: present

- name: Delete ZFS boot environment
  community.general.beadm:
    name: old-be
    state: absent

- name: Mount ZFS boot environment on /tmp/be
  community.general.beadm:
    name: BE
    mountpoint: /tmp/be
    state: mounted

- name: Unmount ZFS boot environment
  community.general.beadm:
    name: BE
    state: unmounted

- name: Activate ZFS boot environment
  community.general.beadm:
    name: upgrade-be
    state: activated

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
description string	always	BE description Sample: Upgrade from 9.0 to 10.0
force boolean	always	If forced action is wanted
mountpoint string	always	BE mountpoint Sample: /mnt/be
name string	always	BE name Sample: pre-upgrade
options string	always	BE additional options Sample: compression=on
snapshot string	always	ZFS snapshot to create BE from Sample: rpool/ROOT/oi-hipster@fresh
state string	always	state of the target Sample: present

Authors

Adam Števko (@xen0l)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/beadm_module.html

Docs

Docs4dev

Title here