Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Driver pool.virtual

Minimal configlet:

[pool#1]
type = virtual

Minimal setup command:

om test/ccfg/foo set --kw="type=virtual"

Supported keywords:

  • capabilities
  • max_peers
  • mkblk_opt
  • mkfs_opt
  • mnt_opt
  • optional_volume_env
  • status_schedule
  • template
  • type
  • volume_env

Keyword capabilities

required:    false
scopable:    false
default:     file roo rwo rox rwx
convert:     list

Description:

The capabilities exposed by the virtual pool.

Supported capabilities:

  • blk The pool can satisfy the format=false requirement.

  • file The pool can satisfy the format=true requirement.

  • move The pool volumes can host data for resources proposing live migration (e.g. container.kvm).

  • roo Read-Only from One node. The pool can satisfy the access=roo requirement.

  • rox Read-Only from Many nodes. The pool can satisfy the access=rox requirement.

  • rwo Read-Write from One node. The pool can satisfy the access=rwo requirement.

  • rwx Read-Write from Many nodes. The pool can satisfy the access=rwx requirement.

  • shared The same technical object is used on all nodes.

  • snap The volume can be snapshotted.

  • volatile The pool can satisfy the volatile=true requirement.

Keyword max_peers

required:    false
scopable:    false
convert:     int

Example:

max_peers=8

Description:

Keyword mkblk_opt

required:    false
scopable:    false

Description:

The zvol, lv, and other block device creation command options to use to prepare the pool devices.

Keyword mkfs_opt

required:    false
scopable:    false

Example:

mkfs_opt=-O largefile

Description:

The mkfs command options to use to format the pool devices.

Keyword mnt_opt

required:    false
scopable:    true

Description:

The mount options of the fs created over the pool devices.

Keyword optional_volume_env

required:    false
scopable:    false
convert:     list

Example:

optional_volume_env=container#1.name:container_name env.foo:foo

Description:

The list of the vol consumer service config keywords which values are mapped as env keys in the allocated volume service.

If the keyword is not set at the source, the default value in the template env section applies.

Keyword status_schedule

required:    false
scopable:    false

Description:

The value to set to the status_schedule keyword of the vol objects allocated from the pool.

See usr/share/doc/schedule for the schedule syntax.

Keyword template

required:    false
scopable:    false

Example:

template=templates/vol/mpool-over-loop

Description:

The path of a vol to use as a template for new volumes.

Keyword type

required:    false
scopable:    false
candidates:  directory, loop, vg, zpool, freenas, share, shm, symmetrix, truenas, virtual, dorado, hoc, drbd, pure, rados
default:     directory

Description:

The pool type.

Keyword volume_env

required:    false
scopable:    false
convert:     list

Example:

volume_env=container#1.name:container_name env.foo:foo

Description:

The list of the vol consumer service config keywords which values are mapped as env keys in the allocated volume service.

If the keyword is not set at the source, an error is raised.