manila/doc/source/configuration/tables/manila-zfs.inc
Tom Barron fae499cb73 doc migration: configuration reference
In accord with the OpenStack documentation migration spec [1],
this patch pulls over material from the centralized Configuration
Reference so that it will not be lost.  As indicated in the spec,
dynamic generation of this material will be left for later work.

[1] https://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html

Closes-Bug: #1706181
Depends-On: Ib0fca0c16e14c05307bfc31ae50c65271b7402f1
Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454

Change-Id: I7f3b584ac9907da1f07dedd26324cf4703bc7e6c
2017-08-25 13:21:08 +00:00

47 lines
3.1 KiB
PHP

..
Warning: Do not edit this file. It is automatically generated from the
software project's code and your changes will be overwritten.
The tool to generate this file lives in openstack-doc-tools repository.
Please make any changes needed in the code, then run the
autogenerate-config-doc tool from the openstack-doc-tools repository, or
ask for help on the documentation mailing list, IRC channel or meeting.
.. _manila-zfs:
.. list-table:: Description of ZFS share driver configuration options
:header-rows: 1
:class: config-ref-table
* - Configuration option = Default value
- Description
* - **[DEFAULT]**
-
* - ``zfs_dataset_creation_options`` = ``None``
- (List) Define here list of options that should be applied for each dataset creation if needed. Example: compression=gzip,dedup=off. Note that, for secondary replicas option 'readonly' will be set to 'on' and for active replicas to 'off' in any way. Also, 'quota' will be equal to share size. Optional.
* - ``zfs_dataset_name_prefix`` = ``manila_share_``
- (String) Prefix to be used in each dataset name. Optional.
* - ``zfs_dataset_snapshot_name_prefix`` = ``manila_share_snapshot_``
- (String) Prefix to be used in each dataset snapshot name. Optional.
* - ``zfs_migration_snapshot_prefix`` = ``tmp_snapshot_for_share_migration_``
- (String) Set snapshot prefix for usage in ZFS migration. Required.
* - ``zfs_replica_snapshot_prefix`` = ``tmp_snapshot_for_replication_``
- (String) Set snapshot prefix for usage in ZFS replication. Required.
* - ``zfs_service_ip`` = ``None``
- (String) IP to be added to admin-facing export location. Required.
* - ``zfs_share_export_ip`` = ``None``
- (String) IP to be added to user-facing export location. Required.
* - ``zfs_share_helpers`` = ``NFS=manila.share.drivers.zfsonlinux.utils.NFSviaZFSHelper``
- (List) Specify list of share export helpers for ZFS storage. It should look like following: 'FOO_protocol=foo.FooClass,BAR_protocol=bar.BarClass'. Required.
* - ``zfs_ssh_private_key_path`` = ``None``
- (String) Path to SSH private key that should be used for SSH'ing ZFS storage host. Not used for replication operations. Optional.
* - ``zfs_ssh_user_password`` = ``None``
- (String) Password for user that is used for SSH'ing ZFS storage host. Not used for replication operations. They require passwordless SSH access. Optional.
* - ``zfs_ssh_username`` = ``None``
- (String) SSH user that will be used in 2 cases: 1) By manila-share service in case it is located on different host than its ZFS storage. 2) By manila-share services with other ZFS backends that perform replication. It is expected that SSH'ing will be key-based, passwordless. This user should be passwordless sudoer. Optional.
* - ``zfs_use_ssh`` = ``False``
- (Boolean) Remote ZFS storage hostname that should be used for SSH'ing. Optional.
* - ``zfs_zpool_list`` = ``None``
- (List) Specify list of zpools that are allowed to be used by backend. Can contain nested datasets. Examples: Without nested dataset: 'zpool_name'. With nested dataset: 'zpool_name/nested_dataset_name'. Required.