Xena 系列发布说明¶
13.2.0-15¶
错误修复¶
更改了在 shares api 中未处理的共享类型时引发的错误和状态码
使 CephFS 驱动程序中的快照名称更短，以避免 Ceph 集群截断子卷名称并使快照无法访问的限制。
NetApp 驱动程序 bug #1982808：修复了问题，防止存储系统在副本提升后正确清理未使用的 SnapMirror 快照，从而大大增加了 ONTAP 卷中快照占用的空间。
状态为 error_deleting 的共享副本现在将在定期更新期间跳过。
共享服务器后端详细信息设置函数添加了数据库记录，而没有检查现有条目。这会导致给定共享服务器 ID 和键的重复记录。通过更新现有记录（如果存在）或创建新记录来修复它。有关更多详细信息，请参阅 launchpad bug 2024658。
“manage”API 现在验证“provider_location”和“share_id”字段的格式，并适当地处理错误。预期这些字段包含字符串值。
当数据库上进行了更新时，
updated_at字段已正确设置为共享和快照访问规则。
CephFS 驱动程序使用 RemoveExport DBUS API 调用来调用 NFS/Ganesha 服务，当用户删除访问规则或删除共享时。如果此调用失败，驱动程序现在会提供失败日志，并继续清理。在此更改之前，如果服务失败了 DBUS 命令来删除导出，共享删除可能会失败。这将使共享处于“error_deleting”状态，需要管理员干预。有关更多信息，请参阅 bug #2035572。
NetApp 驱动程序 bug #2069125：修复了 NetApp ONTAP 驱动程序在 ZAPI 工作流中的问题，即当 vserver 网络接口未配置 kerberos 时，某些 vserver 帐户无法为共享添加访问规则。
bug #2025649：修复了共享服务器 API 错误消息。
13.2.0¶
新特性¶
由 Infinidat 驱动程序创建的共享的特殊 .snapshot 目录现在可以通过配置选项控制：infinidat_snapdir_accessible 和 infinidat_snapdir_visible。默认情况下，每个共享允许访问其自身的 .snapshot 目录，其中包含每个快照的文件和目录。要限制对 .snapshot 目录的访问，应将 infinidat_snapdir_accessible 设置为 False。 infinidat_snapdir_visible 选项控制 .snapshot 目录的可见性。默认情况下，.snapshot 目录是隐藏的。要使客户端可见 .snapshot 目录，应将此选项设置为 True。
错误修复¶
Launchpad bug 1968891 已修复。调度器在扩展共享时将使用大小增加而不是共享大小来计算 provisioned_ratio。
为 CephFS NFS 驱动程序创建的导出中添加了文件系统信息。这修复了使用多个文件系统部署 Manila 时出现的不一致性。
Infinidat 驱动程序 bug #1992443：修复了 Infinidat 驱动程序中的一个问题，以支持主机辅助迁移。 snapdir_visible 文件系统属性必须禁用才能隐藏客户端上的 .snapshot 目录。但是，可以使用 infinidat_snapdir_visible 配置选项更改此行为。
修复了一个问题，该问题导致 CephFS 驱动程序覆盖共享中的权限。在 一个 bugfix 之后，Ceph 的共享幂等创建行为发生了变化。如果共享模式在 Manila 外部被修改，或者当共享已经创建时，Manila 中 cephfs_volume_mode 的配置值发生更改，这些共享的模式将在 Manila 尝试使用幂等创建来确保该共享存在时发生更改，从而可能破坏客户端。CephFS 驱动程序现在将不再向后端发送创建调用来确保共享存在。有关更多详细信息，请参阅 Bug #2002394
13.1.0¶
错误修复¶
Infinidat 驱动程序 bug #1986653：修复了 Infinidat 驱动程序，以使用 Manila 共享服务与存储后端之间的 TLS/SSL 通信。管理员可以将 infinidat_use_ssl 和 infinidat_suppress_ssl_warnings 选项设置为 True 或 False，以启用或禁用这些功能。
Infinidat 驱动程序 bug #1989283：将驱动程序版本升级到 1.1，其中添加了 SSL 支持。有关启用 SSL 的更多详细信息，请查看 Infinidat 驱动程序文档。
13.0.4¶
安全问题¶
SSH 实用程序模块不再将用户名和密码记录为调试信息。
错误修复¶
GET /shares/{share_id} API 现在对无法访问的资源返回 HTTP 404（未找到）。有关更多信息，请参阅 bug 1901210。
NetApp OnTap 驱动程序 Bug #1915237：修复了 manila 共享迁移中的加密兼容性检查。
添加了一个检查，当将安全服务与共享网络关联时，两个资源必须具有相同的 project_id。如果不是，则会引发 HTTP Bad Request。
修复了一个问题，该问题导致 Manila 返回所有项目共享副本，即使用户不是管理员。现在，当用户不是管理员时，将仅显示项目视角的副本。有关更多详细信息，请参阅 Launchpad Bug #1922243
CephFS 驱动程序不再未能删除从未应用或从后端存储中丢失的访问规则。有关更多详细信息，请参阅 LP #1971530。
在共享网络创建 API 期间，如果共享网络或共享网络子网数据库创建失败，manila 会引发异常。但是，配额不会回滚，并且仅在配额预留超时（等待 conf.reservation_expire 秒）后才能使用。通过在任何数据库创建 API 失败时立即回滚配额来修复。
Goodness_function 期望整数或浮点数，否则引发 parseException。这会导致诸如 “(share.share_proto == ‘CIFS’) ? 100 : 50” 之类的示例在评估期间失败。通过添加对字符串评估的支持来修复它。
部署者现在可以指定
[glance]endpoint_type配置选项（默认情况下为publicURL以保持向后兼容性），以便 Manila 使用 Glance 端点而不是公共端点（请参阅 bug 1991396）。
13.0.3¶
错误修复¶
修复了 ONTAP AFF 平台在创建共享时强制卷具有高效数据保存的问题，即使指定了相反的情况。有关更多详细信息，请参阅 launchpad bug #1929421
13.0.2¶
已知问题¶
用户指定的调度器提示，例如“same_host”和“different_host”，作为共享元数据存储，键分别为“__affinity_same_host”和“__affinity_different_host”。除非通过 RBAC 策略防止，否则这些可以被用户操作或删除，就像所有元数据一样。在未来的版本中，该服务将限制删除或操作这些特定元数据项。
错误修复¶
修复了在快照创建期间，数据库错误被错误处理的死代码的问题。有关更多详细信息，请参阅 Launchpad bug 1475351。
13.0.1¶
错误修复¶
NetApp cDOT 驱动程序使用
netapp_server_port进行自定义端口配置在重构后被意外忽略。此选项现在应正确读取。有关更多详细信息，请参阅 Launchpad bug 1945365。
当
cephfs_ganesha_server_ip未设置时，当前主机名用作此配置选项的默认值。驱动程序将此值视为 IP 地址并尝试对其进行验证。CEPH NFS 驱动程序将不再将主机名视为 IP 地址并尝试对其进行验证。
13.0.0¶
新功能¶
添加了 Pure Storage FlashBlade 驱动程序。驱动程序支持 NFS 协议。共享操作包括创建、删除、调整大小、快照和还原到快照。
“reserved_share_from_snapshot_percentage”后端配置选项允许 Manila 考虑从快照创建的共享的不同预留百分比。如果未设置此配置选项，则从快照创建的共享将使用“reserved_share_percentage”中设置的预留百分比值。这对于希望为非快照/常规共享和快照共享保留相同预留百分比的用户来说很有用。
添加了共享服务器迁移增强功能。支持非破坏性迁移的共享后端能够在没有网络更改的情况下执行此操作，如果后端驱动程序支持重用 IP 地址。
向 manila 的调度器添加了 AffinityFilter 和 AntiAffinityFilter。这些硬亲和性和反亲和性过滤器需要用户在请求有效负载中将亲和/反亲和共享 ID 指定到字段“share.scheduler_hints.same_host”或“share.scheduler_hints.different_host”。这些提示存储为共享元数据。在共享迁移期间填充过滤器属性，因此将应用过滤器来迁移 manila 共享。
NetApp ONTAP 驱动程序现在支持版本 >= 9.10 的集群的非破坏性共享服务器迁移。
NetApp 驱动程序一直使用 FlexVol ONTAP 卷。该驱动程序不支持将 FlexVol 卷扩展到超过 100 TiB，这是这些容器旨在处理的理论限制。ONTAP 的 Flexgroup 卷消除了这些限制。因此，添加了对 NetApp 驱动程序中以 FlexGroup 形式配置共享的支持。
通过新的选项
netapp_enable_flexgroup启用 FlexGroup 配置，这将使驱动程序报告单个池，该池代表所有聚合。FlexGroup 共享将驻留在哪个聚合上由 ONTAP 决定。如果管理员希望通过 Manila 调度器控制该选择，则可以使用配置选项netapp_flexgroup_pools来调整存储池布局。启用 FlexGroup 时，默认情况下继续启用 FlexVol 池。为了仅使用 FlexGroup，必须将新的选项
netapp_flexgroup_pool_only设置为 True。现在，每个 NetApp 池都会报告功能：netapp_flexgroup，告知驻留在那里共享的类型（FlexGroup 或 FlexVol）。
允许使用 FlexGroup 共享进行以下操作（DHSS True/False 和 NFS/CIFS）
创建/删除共享；
缩小/扩展共享；
创建/删除快照；
还原到快照；
管理/取消管理快照；
从快照创建；
复制；
管理/取消管理共享；
FlexGroup 功能需要 ONTAP 版本 9.8 或更高版本。使用多个非活动副本的复制需要 ONTAP 9.9.1 或更高版本。
NetApp ONTAP 驱动程序：添加了对 readable 复制的支持。该驱动程序将继续支持 dr 类型。
升级说明¶
要将 AffinityFilter 和 AntiAffinityFilter 添加到活动部署，必须将它们的引用添加到 setup.cfg 中的 manila.scheduler.filters 部分，并且必须在 manila.conf 中启用它们。
与后端交互的 Ceph 驱动程序不再需要 MON 写入权限。因此，可以减少驱动程序用户（使用
cephfs_auth_id配置）的功能。有关所需的权限，请参阅 管理员文档。
在 Ussuri 之前进行的弃用已执行，对
manila.conf的影响如下在 [DEFAULT] 部分中已弃用的
memcached_servers选项无效且已被删除。在 [DEFAULT] 部分中已弃用的
share_usage_audit_period选项无效且已被删除。在 [DEFAULT] 中已弃用的
nova_api_microversion选项已被删除。请改用 [nova] 部分中的“api_microversion”。在 [DEFAULT]、[nova]、[cinder] 和 [neutron] 部分中已弃用的
ca_certificates_file选项无效且已被删除。在 [DEFAULT] 部分中已弃用的
nova_ca_certificates_file选项无效且已被删除。在 [DEFAULT] 部分中已弃用的
cinder_ca_certificates_file选项无效且已被删除。在 [DEFAULT]、[nova]、[cinder] 和 [neutron[ 部分中已弃用的
api_insecure选项无效且已被删除。在 [DEFAULT] 部分中已弃用的
nova_api_insecure选项无效且已被删除。在 [DEFAULT] 部分中已弃用的
cinder_api_insecure选项无效且已被删除。已弃用的
migration_tmp_location选项不再被识别。请改用mount_tmp_location。不再可以在 [DEFAULT] 部分设置
network_api_class选项。请在后端部分中设置它。不再可以在 [DEFAULT] 部分设置
neutron_url选项。请在 [neutron] 部分中使用“url”选项。不再可以在 [DEFAULT] 部分设置
neutron_url_timeout选项。请在 [neutron] 部分中使用“url_timeout”选项。neutron 的
auth_strategy选项不再可以在 [DEFAULT] 部分设置。请在 [neutron] 部分设置。neutron 的
neutron_physical_net_name选项不再可以在 [DEFAULT] 部分设置。请在 [neutron] 部分设置。neutron 的
neutron_net_id选项不再可以在 [DEFAULT] 部分设置。请在 [neutron] 部分设置。neutron 的
neutron_subnet_id选项不再可以在 [DEFAULT] 部分设置。请在 [neutron] 部分设置。standalone_network_plugin_gateway 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
standalone_network_plugin_mask 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
standalone_network_plugin_type 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
standalone_network_plugin_segmentation_id 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
standalone_network_plugin_allowed_ip_ranges 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
standalone_network_plugin_mtu 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
已弃用的
migration_readonly_rules_support选项不再被识别。现在所有 manila 后端都需要支持只读访问规则。已弃用的 Dell-EMC PowerMax
vmax_server_container选项不再被识别。请使用powermax_server_container代替。已弃用的 Dell-EMC PowerMax
vmax_share_data_pools选项不再被识别。请使用powermax_share_data_pools代替。已弃用的 Dell-EMC PowerMax
vmax_ethernet_ports选项不再被识别。请使用powermax_ethernet_ports代替。已弃用的 Dell-EMC Unity
emc_nas_server_pool选项不再被识别。请使用unity_server_meta_pool代替。已弃用的 Dell-EMC Unity
emc_nas_pool_names选项不再被识别。请使用unity_share_data_pools代替。已弃用的 Dell-EMC Unity
emc_interface_ports选项不再被识别。请使用unity_ethernet_ports代替。已弃用的 Dell-EMC Unity
emc_nas_server_container选项无效并且已被移除。已弃用的 Dell-EMC VNX
emc_nas_server_container选项已被移除。请使用vnx_server_container代替。已弃用的 Dell-EMC VNX
emc_nas_pool_names选项已被移除。请使用vnx_share_data_pools代替。已弃用的 Dell-EMC VNX
emc_interface_ports选项已被移除。请使用vnx_ethernet_ports代替。已弃用的 GlusterFS
glusterfs_native_server_password选项已被移除。请使用glusterfs_server_password代替。已弃用的 GlusterFS
glusterfs_native_path_to_private_key选项已被移除。请使用glusterfs_path_to_private_key代替。已弃用的 GlusterFS
glusterfs_targets选项已被移除。请使用glusterfs_servers代替。已弃用的 Hitachi HNAS
hds_hnas_driver_helper选项已被移除。请使用hitachi_hnas_driver_helper代替。已弃用的 Hitachi HNAS
hds_hnas_ip选项已被移除。请使用hitachi_hnas_ip代替。已弃用的 Hitachi HNAS
hds_hnas_user选项已被移除。请使用hitachi_hnas_user代替。已弃用的 Hitachi HNAS
hds_hnas_password选项已被移除。请使用hitachi_hnas_password代替。已弃用的 Hitachi HNAS
hds_hnas_evs_id选项已被移除。请使用hitachi_evs_id代替。已弃用的 Hitachi HNAS
hds_hnas_file_system_name选项已被移除。请使用hitachi_hnas_file_system_name代替。已弃用的 Hitachi HNAS
hds_hnas_cluster_admin_ip0选项已被移除。请使用hitachi_hnas_cluster_admin_ip0代替。已弃用的 Hitachi HNAS
hds_hnas_stalled_job_timeout选项已被移除。请使用hitachi_hnas_stalled_job_timeout代替。已弃用的 Hitachi HNAS
hds_hnas_driver_helper选项已被移除。请使用hitachi_hnas_driver_helper代替。已弃用的 Hitachi HNAS
hds_hnas_allow_cifs_snapshot_while_mounted选项已被移除。请使用hitachi_allow_cifs_snapshot_while_mounted代替。已弃用的 HPE 3PAR
hp3par_api_url选项已被移除。请使用hpe3par_api_url代替。已弃用的 HPE 3PAR
hp3par_username选项已被移除。请使用hpe3par_username代替。已弃用的 HPE 3PAR
hp3par_password选项已被移除。请使用hpe3par_password代替。已弃用的 HPE 3PAR
hp3par_san_ip选项已被移除。请使用hpe3par_san_ip代替。已弃用的 HPE 3PAR
hp3par_san_login选项已被移除。请使用hpe3par_san_login代替。已弃用的 HPE 3PAR
hp3par_san_password选项已被移除。请使用hpe3par_san_password代替。已弃用的 HPE 3PAR
hp3par_san_ssh_port选项已被移除。请使用hpe3par_san_ssh_port代替。已弃用的 HPE 3PAR
hp3par_fpg选项已被移除。请使用hpe3par_fpg代替。已弃用的 HPE 3PAR
hp3par_fstore_per_share选项已被移除。请使用hpe3par_fstore_per_share代替。已弃用的 HPE 3PAR
hp3par_debug选项已被移除。请使用hpe3par_debug代替。已弃用的 HPE 3PAR
hp3par_cifs_admin_access_username选项已被移除。请使用hpe3par_cifs_admin_access_username代替。已弃用的 HPE 3PAR
hp3par_cifs_admin_access_password选项已被移除。请使用hpe3par_cifs_admin_access_password代替。已弃用的 HPE 3PAR
hp3par_cifs_admin_access_domain选项已被移除。请使用hpe3par_cifs_admin_access_domain代替。已弃用的 HPE 3PAR
hp3par_share_mount_path选项已被移除。请使用hpe3par_share_mount_path代替。已弃用的 IBM GPFS
knfs_export_options选项无效并且已被移除。已弃用的 Netapp
netapp_nas_server_hostname选项已被移除。请使用netapp_server_hostname代替。已弃用的 Netapp
netapp_nas_transport_type选项已被移除。请使用netapp_transport_type代替。已弃用的 Netapp
netapp_nas_login选项已被移除。请使用netapp_login代替。已弃用的 Netapp
netapp_nas_password选项已被移除。请使用netapp_password代替。已弃用的 Netapp
netapp_nas_volume_name_template选项已被移除。请使用netapp_volume_name_template代替。已弃用的 Netapp
netapp_root_volume_name选项已被移除。请使用netapp_root_volume代替。已弃用的 Nexenta
nexenta_host选项已被移除。请使用nexenta_nas_host代替。enable_pre_hooks 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
enable_post_hooks 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
enable_periodic_hooks 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
enable_pre_hooks_errors 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
enable_post_hooks_errors 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
periodic_hooks_interval 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
hook_drivers 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
automatic_share_server_cleanup 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
unused_share_server_cleanup_interval 选项不再可以在 [DEFAULT] 部分设置。请在后端部分设置。
cinder_cross_az_attach 选项不再可以在 [DEFAULT] 部分设置。请在 [CINDER] 部分使用
cross_az_attach代替。cinder_http_retries 选项不再可以在 [DEFAULT] 部分设置。请在 [CINDER] 部分使用
http_retries代替。
弃用说明¶
定义默认配额和配额功能行为的配置选项现在必须在新的
[quota]部分配置，而不是[DEFAULT]部分。 [DEFAULT] 部分中的现有选项已被弃用，将在未来的版本中移除。本版本中已更改的选项是[quota]/shares- 之前为[DEFAULT]/shares_quota[quota]/snapshots- 之前为[DEFAULT]/snapshots_quota[quota]/gigabytes- 之前为[DEFAULT]/quota_gigabytes[quota]/per_share_gigabytes- 之前为[DEFAULT]/quota_per_share_gigabytes[quota]/snapshot_gigabytes- 之前为[DEFAULT]/quota_snapshot_gigabytes[quota]/share_networks- 之前为[DEFAULT]/quota_share_networks[quota]/share_groups- 之前为[DEFAULT]/quota_share_groups[quota]/share_group_snapshots- 之前为[DEFAULT]/quota_share_group_snapshots[quota]/share_replicas- 之前为[DEFAULT]/quota_share_replicas[quota]/replica_gigabytes- 之前为[DEFAULT]/quota_replica_gigabytes[quota]/until_refresh- 之前为[DEFAULT]/until_refresh[quota]/reservation_expire之前为[DEFAULT]/reservation_expire[quota]/driver- 之前为[DEFAULT]/quota_driver[quota]/max_age- 之前为[DEFAULT]/max_age
在 manila CephFS 驱动程序（Native 和 NFS Ganesha）中，创建共享组快照功能不再受支持，因为 CephFS 主线中不再支持子卷组快照功能（现有的组快照仍然可以列出和删除）。
错误修复¶
通过确保在创建 RPC 消费者之前正确初始化，解决了服务重启时的 RPC 处理问题。有关更多详细信息，请参阅 bug 1271568。
Launchpad bug 1855391 已修复。扩展共享的操作将通过调度器进行，如果没有可用的共享后端主机，则共享将回滚到可用状态并创建一个用户消息。
修复了 bug #1881865，为数据库层添加了通用的模糊匹配逻辑。此逻辑应用于查询共享快照列表，这将大大提高分页模糊查询的速度。
对于某些驱动程序，为了创建具有特定协议的共享，事先添加安全服务到共享网络是强制性的。如果忘记了这一步，共享将会出错。从现在开始，Manila 不允许在指定的协议需要特定的安全服务类型但该类型未与共享网络关联时创建共享。
OpenStack Compute (nova)、OpenStack Image (glance)、OpenStack Volume (cinder) 和 OpenStack Networking (neutron) 服务的服务客户端加载时的身份验证错误现在得到了更好的处理。
修复了 bug #1922075。修复了 glusterfs 驱动程序从快照创建实例时，“gluster volume set nfs.rpc-auth-reject ‘*’” 失败的问题。
修复了共享网络列表的查询逻辑，将“created_since”、“created_before”搜索选项放入数据库以提高查询速度，并整合了数据库查询接口。
mgr-commands 现在被定向到 mgr-daemon 而不是 mon-daemon，在 CephFS 驱动程序中。
修复了共享副本周期性任务中的 NotFound 错误。正在处理的副本的父共享可能已经被删除。
修复了 periodic_share_replica_update()，使其跳过活动副本，类似于 periodic_share_replica_snapshot_update()。目的是检查非活动副本，这些副本可能处于“in_sync”、“out_of_sync”或“error”状态。
数据库对象中的只读关系已被正确标记，以避免 sqlalchemy 弃用消息充斥日志文件。
更正了尝试从不支持此操作的共享创建快照时的错误消息。该消息说共享后端没有这样的支持，但事实并非总是如此。原始共享不支持快照，因为它是在没有设置
snapshot_supportextra-spec 的共享类型下创建的，无论使用的后端本身是否支持快照。
修复了一个问题，导致具有复制支持的迁移共享没有设置 replica_state 为 active 的共享实例。现在，当共享支持复制时，迁移完成后，目标共享实例的副本状态将立即设置为 active。有关更多详细信息，请参阅 bug 1927060
按共享类型“extra_specs”作为 key=value 过滤共享现在返回预期的输出。
为了解决 Ceph Nautilus 中缺少 mon-mgr 目标的问题，在此更改中添加了 Ceph 版本检查。通过此更改，Ceph Nautilus 用户可以使用其存储后端与 OpenStack manila Wallaby 版本配合使用。
Infinidat 驱动程序已修复，可以正确处理单个 IP 地址 (/32)。有关更多详细信息，请参阅 bug 1934345。
NetApp 驱动程序：修复了 ONTAP 9.8 及更早版本中，对于作用域帐户用户，删除副本操作无法正常工作，但返回成功消息的问题。有关更多详细信息，请参阅 launchpad bug #1934889
将 Dell manila 驱动程序的 cifs 值从字符串更改为列表。修复了 bug 1940072
新的用户消息现在会在尝试创建没有指定共享类型的共享时提醒用户，无论是通过请求体还是通过设置默认共享类型。有关更多详细信息，请参阅 bug #1870280
