附加选项

这些选项也可以在 manila.conf 文件中设置。

证书颁发机构配置选项说明

配置选项 = 默认值

描述

[DEFAULT]

osapi_share_use_ssl = False

(布尔值) 如果设置为 True，则将套接字封装在 SSL 上下文中。
通用配置选项说明

配置选项 = 默认值

描述

[DEFAULT]

check_hash = False

(布尔值) 选择是否在数据复制时检查每个文件的哈希值。

client_socket_timeout = 900

(整数) 客户端连接套接字操作的超时时间。如果传入连接空闲此秒数，则将关闭该连接。值为“0”表示无限期等待。

compute_api_class = manila.compute.nova.API

(字符串) 要使用的计算 API 类的完整类名。

data_access_wait_access_rules_timeout = 180

(整数) 在迁移共享时，等待后端上的访问规则允许/拒绝的时间 (秒)。

data_manager = manila.data.manager.DataManager

(字符串) 数据管理器的完整类名。

data_node_access_admin_user = None

(字符串) 安全服务中注册的管理员用户名，以便允许访问基于用户身份验证的共享。

data_node_access_cert = None

(字符串) 安装在数据节点中的证书，以便允许访问基于证书身份验证的共享。

data_node_access_ips = None

(字符串) 连接到管理网络的节点接口的 IP 地址列表。用于允许访问挂载共享。默认值为 []。

data_node_mount_options = {}

(字典) 包含在共享协议的挂载命令中的挂载选项。使用字典格式，例如：{‘nfs’: ‘-o nfsvers=3’, ‘cifs’: ‘-o user=foo,pass=bar’}

data_topic = manila-data

(字符串) 数据节点侦听的主题。

enable_new_services = True

(布尔值) 在创建时添加到可用池的服务。

fatal_exception_format_errors = False

(布尔值) 是否将异常消息格式错误视为致命错误。

filter_function = None

(字符串) 用于过滤主机的方程的字符串表示形式。

host = <your_hostname>

(字符串) 此节点的名称。它可以是一个不透明的标识符。它不一定是主机名、FQDN 或 IP 地址。

max_over_subscription_ratio = 20.0

(浮点数) 当涉及稀疏配置时，超额订阅率的浮点数表示形式。默认比率为 20.0，这意味着配置的容量可以是总物理容量的 20 倍。如果比率为 10.5，则表示配置的容量可以是总物理容量的 10.5 倍。比率为 1.0 表示配置的容量不能超过总物理容量。比率低于 1.0 无效。

memcached_servers = None

(列表) Memcached 服务器或进程内缓存为 None。

monkey_patch = False

(布尔值) 是否记录猴子补丁。

monkey_patch_modules =

(列表) 要猴子补丁的模块或装饰器列表。

mount_tmp_location = /tmp/

(字符串) 在迁移期间创建和挂载共享的临时路径。

my_ip = <your_ip>

(字符串) 此主机的 IP 地址。

num_shell_tries = 3

(整数) 尝试运行不稳定的 shell 命令的次数。

periodic_fuzzy_delay = 60

(整数) 在启动定期任务调度器时，随机延迟的秒数范围，以减少蜂拥效应。（通过设置为 0 来禁用）

periodic_hooks_interval = 300.0

(浮点数) 执行定期挂钩之间的秒数间隔。当选项“enable_periodic_hooks”设置为 True 时使用。默认值为 300。

periodic_interval = 60

(整数) 运行定期任务之间的秒数。

replica_state_update_interval = 300

(整数) 此值（以秒为单位）确定共享管理器轮询每个副本实例的健康状况（replica_state）的频率。

replication_domain = None

(字符串) 一个字符串，指定后端所属的复制域。此选项需要在支持彼此之间复制的所有后端的配置部分中以相同的方式指定。如果未在组中指定此选项，则表示后端上未启用复制。

report_interval = 10

(整数) 节点之间报告状态到数据存储的秒数。

reserved_share_percentage = 0

(整数) 保留的后端容量百分比。

rootwrap_config = None

(字符串) 用于以 root 身份运行命令的 rootwrap 配置文件路径。

service_down_time = 60

(整数) 上次签入以来服务的最大时间（秒）。

smb_template_config_path = $state_path/smb.conf

(字符串) smb 配置文件的路径。

sql_idle_timeout = 3600

(整数) 闲置 SQL 连接被回收之前的超时时间。

sql_max_retries = 10

(整数) 启动期间打开数据库连接的最大重试次数。（设置 -1 表示无限重试次数）。

sql_retry_interval = 10

(整数) 重新尝试打开 SQL 连接之间的间隔时间。

sqlite_clean_db = clean.sqlite

(字符串) 清理 sqlite 数据库的文件名。

sqlite_db = manila.sqlite

(字符串) 与 sqlite 一起使用的文件名。

sqlite_synchronous = True

(布尔值) 如果传递，则对 sqlite 使用同步模式。

state_path = /var/lib/manila

(字符串) 维护 manila 状态的顶级目录。

storage_availability_zone = nova

(字符串) 此节点的可用区。

tcp_keepalive = True

(布尔值) 为每个服务器套接字设置 TCP_KEEPALIVE 的值 (True/False)。

tcp_keepalive_count = None

(整数) 为每个服务器套接字设置 TCP_KEEPCNT 的值。不支持在 OS X 上。

tcp_keepalive_interval = None

(整数) 为每个服务器套接字设置 TCP_KEEPINTVL（以秒为单位）的值。不支持在 OS X 上。

tcp_keepidle = 600

(整数) 为每个服务器套接字设置 TCP_KEEPIDLE（以秒为单位）的值。不支持在 OS X 上。

until_refresh = 0

(整数) 刷新使用情况之前的预留计数。

use_forwarded_for = False

(布尔值) 将 X-Forwarded-For 视为规范远程地址。仅在您拥有清理代理时才启用此选项。

wsgi_keep_alive = True

(布尔值) 如果为 False，则显式关闭客户端套接字连接。设置为 True 以保持向后兼容性。建议设置为 False。

admin_only_metadata = __affinity_same_host,__affinity_different_host

(列表) 亲和性键默认为确保向后兼容性。使用列表更新应仅由允许使用“update_admin_only_metadata”策略的人员操作的元数据项。

driver_updatable_metadata = None

(列表) 将决定哪些共享元数据可以作为元数据创建/更新操作的一部分传递给共享驱动程序的元数据键。

driver_updatable_subnet_metadata = None

(列表) 将决定哪些 share network_subnet_metadata 可以作为元数据创建/更新操作的一部分传递给共享驱动程序的元数据键。

[coordination]

backend_url = file://$state_path

(字符串) 用于分布式协调的后端 URL。

[healthcheck]

backends =

(列表) 可以执行健康检查并将其报告作为请求的一部分的附加后端。

detailed = False

(布尔值) 在响应中显示更详细的信息

disable_by_file_path = None

(字符串) 检查文件的存在情况，以确定应用程序是否正在端口上运行。由 DisableByFileHealthcheck 插件使用。

disable_by_file_paths =

(列表) 检查基于端口的文件是否存在情况，以确定应用程序是否正在端口上运行。期望一个“port:path”字符串列表。由 DisableByFilesPortsHealthcheck 插件使用。

path = /healthcheck

(字符串) 已弃用：响应 healthcheck 请求的路径。

update_shares_status_on_ensure = True

(布尔值) 定义 manila 是否应该在确保共享时更新共享的状态。
计算配置选项说明

配置选项 = 默认值

描述

[nova]

api_microversion = 2.10

(字符串) 要使用的 Nova API 版本。

endpoint_type = publicURL

(字符串) 与 nova 客户端调用一起使用的端点类型。

region_name = None

(字符串) 连接到 nova 的区域名称。
Ganesha 配置选项说明

配置选项 = 默认值

描述

[DEFAULT]

ganesha_config_dir = /etc/ganesha

(字符串) 存储 Ganesha 配置文件目录。

ganesha_config_path = $ganesha_config_dir/ganesha.conf

(字符串) 主 Ganesha 配置文件的路径。

ganesha_db_path = $state_path/manila-ganesha.db

(字符串) Ganesha 数据库文件的位置。（仅 Ganesha 模块。）

ganesha_export_dir = $ganesha_config_dir/export.d

(字符串) 包含 Ganesha 导出配置的目录的路径。（仅 Ganesha 模块。）

ganesha_export_template_dir = /etc/manila/ganesha-export-templ.d

(String) Ganesha 导出块模板所在的目录路径。（仅 Ganesha 模块。）

ganesha_service_name = ganesha.nfsd

(String) ganesha nfs 服务的名称。
hnas 配置选项的描述

配置选项 = 默认值

描述

[DEFAULT]

hitachi_hnas_driver_helper = manila.share.drivers.hitachi.hnas.ssh.HNASSSHBackend

(String) 用于驱动程序助手的 Python 类。
Quota 配置选项的描述

配置选项 = 默认值

描述

[quota]

max_age = 0

(Integer) 后续使用情况刷新之间的秒数。

max_gigabytes = 10000

(Integer) 每个主机允许的最大卷大小（以 GB 为单位）。

driver = manila.quota.DbQuotaDriver

(String) 用于配额检查的默认驱动程序。

gigabytes = 1000

(Integer) 每个项目允许的共享空间大小（以 GB 为单位）。

share_networks = 10

(Integer) 每个项目允许的共享网络数量。

shares = 50

(Integer) 每个项目允许的共享数量。

snapshot_gigabytes = 1000

(Integer) 每个项目允许的快照空间大小（以 GB 为单位）。

snapshots = 50

(Integer) 每个项目允许的共享快照数量。

share_groups = 50

(Integer) 允许的共享组数量。

share_group_snapshots = 50

(Integer) 允许的共享组快照数量。

reservation_expire = 86400

(Integer) 预留过期前的秒数。

backups = 10

(Integer) 每个项目允许的共享备份数量。

backup_gigabytes = 1000

(Integer) 每个项目允许备份的总存储空间（以 GB 为单位）。

per_share_gigabytes = -1

(Integer) 每个共享允许的最大大小（以 GB 为单位）。

replica_gigabytes = 1000

(Integer) 每个项目允许的副本空间大小（以 GB 为单位）。

share_replicas = 100

(Integer) 每个项目允许的共享副本数量。
Redis 配置选项的描述

配置选项 = 默认值

描述

[matchmaker_redis]

check_timeout = 20000

(Integer) 事务被杀死之前的等待时间（毫秒）。

host = 127.0.0.1

(String) 已弃用：Redis 的主机。已被 [DEFAULT]/transport_url 替换。

password =

(String) 已弃用：Redis 服务器的密码（可选）。已被 [DEFAULT]/transport_url 替换。

port = 6379

(端口号) 已弃用：用于连接到 redis 主机的端口。已被 [DEFAULT]/transport_url 替换。

sentinel_group_name = oslo-messaging-zeromq

(String) Redis 副本集名称。

sentinel_hosts =

(List) 已弃用：Redis Sentinel 主机列表（容错模式），例如 [host:port, host1:port … ]。已被 [DEFAULT]/transport_url 替换。

socket_timeout = 10000

(Integer) 阻塞套接字操作上的超时时间（毫秒）。

wait_timeout = 2000

(Integer) 两次连接尝试之间的等待时间（毫秒）。
SAN 配置选项的描述

配置选项 = 默认值

描述

[DEFAULT]

ssh_conn_timeout = 60

(Integer) 后端服务器 SSH 连接超时时间。

ssh_max_pool_conn = 10

(Integer) SSH 线程池中的最大连接数。

ssh_min_pool_conn = 1

(Integer) SSH 线程池中的最小连接数。
Scheduler 配置选项的描述

配置选项 = 默认值

描述

[DEFAULT]

capacity_weight_multiplier = 1.0

(浮点数) 用于衡量共享容量的乘数。负数表示堆叠而不是分散。

pool_weight_multiplier = 1.0

(浮点数) 用于衡量具有现有共享服务器的池的乘数。负数表示分散而不是堆叠。

scheduler_default_filters = AvailabilityZoneFilter, CapacityFilter, CapabilitiesFilter, DriverFilter, ShareReplicationFilter

(List) 在请求中未指定时，用于过滤主机的过滤器类名称。

scheduler_default_weighers = CapacityWeigher, GoodnessWeigher

(List) 用于衡量主机的称重器类名称。

scheduler_driver = manila.scheduler.drivers.filter.FilterScheduler

(String) 默认调度器驱动程序。

scheduler_host_manager = manila.scheduler.host_manager.HostManager

(String) 要使用的调度器主机管理器类。

scheduler_json_config_location =

(String) 调度器配置 JSON 文件的绝对路径。

scheduler_manager = manila.scheduler.manager.SchedulerManager

(String) 调度器管理器的完整类名。

scheduler_max_attempts = 3

(Integer) 尝试调度共享的最大次数。

scheduler_topic = manila-scheduler

(String) 调度器节点侦听的主题。
Share 配置选项的描述

配置选项 = 默认值

描述

[DEFAULT]

automatic_share_server_cleanup = True

(Boolean) 如果设置为 True，则 Manila 将删除所有未使用的共享服务器超过指定的时间。如果设置为 False，则禁用共享服务器的自动删除。

backlog = 4096

(Integer) 配置套接字时，请求排队的最大数量。

default_share_group_type = None

(String) 要使用的默认共享组类型。

default_share_type = None

(String) 要使用的默认共享类型。

delete_share_server_with_last_share = False

(Boolean) 在删除最后一个共享时是否删除共享服务器。

driver_handles_share_servers = None

(Boolean) Manila 中的共享驱动程序有两种可能的方法。第一种是共享驱动程序能够处理共享服务器，第二种是不能。驱动程序可以支持这两种方法中的任何一种或仅支持其中一种。因此，如果共享驱动程序能够处理共享服务器并且是所需模式，则将此选项设置为 True，否则设置为 False。默认设置为 None，以使此选择具有目的性。

enable_periodic_hooks = False

(Boolean) 是否启用定期钩子。

enable_post_hooks = False

(Boolean) 是否启用后置钩子。

enable_pre_hooks = False

(Boolean) 是否启用前置钩子。

enabled_share_backends = None

(List) 要使用的共享后端名称列表。这些后端名称应由其选项支持唯一的 [CONFIG] 组支持。

enabled_share_protocols = NFS, CIFS

(List) 指定允许创建共享的协议列表。可用值为 ‘(‘NFS’, ‘CIFS’, ‘GLUSTERFS’, ‘HDFS’, ‘CEPHFS’, ‘MAPRFS’)’

executor_thread_pool_size = 64

(Integer) 执行器线程池的大小。

hook_drivers =

(List) 在共享驱动程序操作之前和之后以及定期执行某些附加操作的驱动程序。默认值为 []。

migration_create_delete_share_timeout = 300

(Integer) 在执行共享迁移时创建和删除共享实例的超时时间（秒）。

migration_driver_continue_update_interval = 60

(Integer) 此值（以秒为单位）确定共享管理器将多久轮询驱动程序以在存储后端执行迁移的下一步操作。

migration_ignore_files = lost+found

(List) 在迁移共享时要忽略的文件和文件夹列表。项目应为名称（不包括任何路径）。

migration_readonly_rules_support = True

(Boolean) 已弃用：指定后端是否支持只读访问规则模式。已过时。现在要求所有驱动程序都支持只读访问规则。

migration_wait_access_rules_timeout = 180

(Integer) 使用通用方法迁移共享时，等待后端允许/拒绝访问规则的时间（秒）。

network_config_group = None

(String) Manila 配置文件中查找网络配置选项的配置组的名称。如果未设置，则将使用共享后端的配置组。如果未在提供的组中找到选项，则将使用 ‘DEFAULT’ 组进行选项搜索。

share_manager = manila.share.manager.ShareManager

(String) 共享管理器的完整类名。

share_name_template = share-%s

(String) 用于生成共享名称的模板字符串。

share_snapshot_name_template = share-snapshot-%s

(String) 用于生成共享快照名称的模板字符串。

share_topic = manila-share

(String) 共享节点监听的主题。

suppress_post_hooks_errors = False

(Boolean) 是否抑制后置钩子错误（允许驱动程序的结果通过）或不抑制。

suppress_pre_hooks_errors = False

(Boolean) 是否抑制前置钩子错误（允许驱动程序执行操作）或不抑制。

unmanage_remove_access_rules = False

(Boolean) 如果设置为 True，则 Manila 将拒绝访问并删除共享取消管理时的所有访问规则。如果设置为 False，则不会进行任何更改。

unused_share_server_cleanup_interval = 10

(Integer) 未分配共享服务器的回收时间间隔（分钟）。最小值为 10 分钟，最大值为 60 分钟。回收功能每 10 分钟运行一次，并删除未使用超过 `unused_share_server_cleanup_interval` 选项定义的共享服务器。此值反映了 Manila 在删除共享服务器之前等待其未被利用的最短时间。

use_scheduler_creating_share_from_snapshot = False

(Boolean) 如果设置为 False，则从快照创建共享将在同一主机上执行。如果设置为 True，则将使用调度步骤。
Tegile 共享驱动程序配置选项说明

配置选项 = 默认值

描述

[DEFAULT]

tegile_default_project = None

(String) 在此项目创建共享

tegile_nas_login = None

(String) Tegile NAS 服务器的用户名。

tegile_nas_password = None

(String) Tegile NAS 服务器的密码。

tegile_nas_server = None

(String) Tegile NAS 服务器的主机名或 IP 地址。
WinRM 配置选项说明

配置选项 = 默认值

描述

[DEFAULT]

winrm_cert_key_pem_path = ~/.ssl/key.pem

(String) x509 证书密钥的路径。

winrm_cert_pem_path = ~/.ssl/cert.pem

(String) 用于访问 serviceinstance 的 x509 证书的路径。

winrm_conn_timeout = 60

(Integer) WinRM 连接超时时间。

winrm_operation_timeout = 60

(Integer) WinRM 操作超时时间。

winrm_retry_count = 3

(Integer) WinRM 重试次数。

winrm_retry_interval = 5

(Integer) WinRM 重试间隔（秒）。

winrm_use_cert_based_auth = False

(Boolean) 使用 x509 证书对 service instance 进行身份验证。