Ocata 系列发布说明¶
4.0.2¶
错误修复¶
更改了通用驱动程序中永久同步挂载的逻辑,以从 /etc/mtab 中选择新挂载的共享,并将其插入 /etc/fstab。添加了相应的永久卸载挂载功能。
修复了 NetApp ONTAP 驱动程序,以处理还原到复制和迁移的快照。
修复了当区域设置不是 POSIX 和 en_US.UTF-8 时,translate_string_size_to_float 方法在逗号小数分隔符而不是句点小数分隔符时可能失败的问题。
修复了安全组和安全组规则 - neutronclient 映射的创建
NetApp ONTAP 驱动程序已修复,在从现有快照创建共享时,会遵守请求的共享大小。
非管理员用户可以在查询中以“all-tenants”标志调用 GET /share-networks 和 GET /security-services API,但是,该标志将被忽略,并且仅提供属于该项目的资源。此 API 更改是为了修复 manila 客户端项目中的 bug 1721787。
Quobyte 驱动程序现在可以处理来自 Quobyte API 版本 1.4+ 的更新后的错误代码。
删除了令人困惑的 manila.db.sqlalchemy 模型消息,这些消息指示
share_type、host、share_server_id、share_network_id、available_zone的已弃用属性。这些属性在 API 中作为共享的属性公开,实际上并非如此被弃用。
当使用 driver_handles_share_servers 驱动程序时,在 manila-share 服务启动后重置 tap 设备。
使用 Oslo 的日志记录功能安全地输出 Manila 的配置选项。
4.0.1¶
升级说明¶
添加了
emc_ssl_cert_verify和emc_ssl_cert_path选项用于 VNX SSL 验证。有关更多详细信息,请参阅 OpenStack 官方文档。
错误修复¶
修复了 share 模型中的
task_state字段在实际完成 share 迁移之前被设置为migration_success的问题。
NetApp ONTAP 驱动程序已修复,以确保 CIFS share 上的“安全风格”始终为“ntfs”。
NetApp cDOT DHSS=True 驱动程序已修复,以确保不会假定 share 服务器仅在分段(VLAN)网络上配置。
NetApp DHSS=True 驱动程序现在在 tenant 网络上使用指定网关创建静态路由。此错误修复的潜在受益者是部署者/用户,其 CIFS 安全服务(例如 Active Directory)不是 tenant 网络的一部分,但可以通过 tenant 网络网关访问路由。
修复了 NetApp 驱动程序,以报告“首选”导出位置元数据的正确值,在无法确定是否存在任何“首选”导出位置时。
NetApp 驱动程序已修复,以确保在驱动程序优化的 share 迁移期间 share 类型更改将导致根据请求的 extra-specs 校正 share 属性。
修复了 VNX 驱动程序中删除 share 服务器的问题。VNX 驱动程序未能检测到 share 服务器的 NFS 接口,因此跳过了 NFS 接口的分离和删除。
修复了 Dell EMC Unity 驱动程序中的一个错误,该错误导致从快照创建的 share 包含原始 share 的数据,而不是快照的数据。
4.0.0¶
序言¶
share 迁移功能得到了改进,以在可能的情况下迁移快照,并提供更确定的用户体验。
新特性¶
添加了详细的 API,以通过 quota-sets 资源显示用户和 tenant 特定的使用情况。
为了确保 share 和可读副本的只读规则语义,已经进行了改进。在以管理上下文调用时,share 实例和 share 副本 API 将在详细的 JSON 响应中返回
cast_rules_to_readonly作为附加字段。
添加了可选的 create_share_from_snapshot_support extra spec,此前该 spec 已经被过载的 snapshot_support extra spec 暗示。
添加了
purge子命令到manila-manage db命令,以便管理员能够清除软删除的行。
添加了 share_type 以过滤 scheduler-stats/pools API 的结果。
添加了 Hitachi HNAS 驱动程序的 admin 网络支持
添加了 share 迁移 API 的 ‘preserve_snapshots’ 参数。
新的微状态(‘applying’,‘denying’)出现在 access rules 列表 API 的 ‘state’ 字段中。这些过渡状态表示在异步处理应用或拒绝 access rule 时的状态。
无论 share 或其任何副本的 ‘access_rules_status’ 如何,都可以添加 access rules。
添加了 Hitachi HNAS 驱动程序的 manage/unmanage snapshot 支持。
添加了 HNAS 驱动程序的 Mountable Snapshots 支持。
添加了 Hitachi NAS 驱动程序的 Revert-to-snapshot 功能。
添加了 GPFS 驱动程序的 manila manage/unmanage 功能支持。现有的 fileset 应该是独立的 fileset,并且不应该在 fileset 路径上具有任何 NFS 导出。有了这个先决条件,现有的 GPFS fileset 可以置于 Manila 管理之下。
添加了 tooz 库的支持。
允许配置 share manager 服务的 file/分布式锁定。
添加了 MapR-FS 的 share 后端驱动程序。
驱动程序辅助迁移支持已添加到 NetApp cDOT 驱动程序,以有效地且无中断地在 Vserver 内迁移 share,确保数据、快照和元数据。
NetApp cDOT 驱动程序现在包含报告给 manila 调度器的每个 pool 的集群节点利用率指标。这些值旨在包含在调度程序使用的 filter & goodness 函数中,因此 cDOT 驱动程序现在也向调度程序报告这些函数,每个 pool 一个。
添加了 QNAP ES 系列存储系统的 Manila share 驱动程序。
添加了 manila 的 mountable snapshots 功能。现在可以允许和拒绝创建支持此功能的 share 类型快照的访问。
添加了 LVM 驱动程序的 mountable snapshots 支持。
添加了常规和复制 share 的 revert-to-snapshot 功能。
添加了 LVM 驱动程序的 revert-to-snapshot 支持。
添加了对 NetApp Data ONTAP 驱动程序的 share revert-to-snapshot 的支持。
Dell EMC Unity 驱动程序已弃用选项 emc_nas_server_container。驱动程序将自动选择存储处理器以平衡 nas 服务器的负载。
Dell EMC Unity 驱动程序得到了增强,以便为每个 VLAN 在 Unity 中使用不同的 tenant。这样,不同 VLAN 中的 nas 服务器可以具有隔离的 IP 地址空间。
Dell EMC Unity 驱动程序得到了增强,以根据网络 MTU 选择系统上的适当端口来创建接口。
Manila 中支持 VMAX。
已知问题¶
3parclient 版本高达 4.2.1 始终只返回 1 个 VFS IP 地址。这可能会导致 3PAR 驱动程序在验证 manila.conf 中配置的 VFS IP 地址时启动失败。
Share groups 替换了 Ocata 中的实验性 consistency groups 功能。share groups 的 API 具有默认基于角色的访问控制策略,设置为“!”。这意味着在升级到 Ocata 版本时,这些 API 默认情况下未启用。相应地修改 policy.json 以启用这些 API。您可以将这些策略设置为“rule:default”以允许所有 tenant 访问,或设置为“rule:admin_api”以仅将访问权限限制为具有这些权限的 tenant。
升级说明¶
snapshot_support extra spec 现在是可选的,在创建 share 类型时没有设置默认值。
添加了新的配置选项到 Hitachi HNAS 驱动程序以允许配置 Admin 网络支持。
所有 share 迁移驱动程序辅助 API 参数现在都是必需的。
对 share 迁移 API 的改进已通过 ZFSOnLinux 驱动程序中存在的驱动程序辅助迁移支持进行限定。但是,此驱动程序当前不支持在迁移时保留快照。
在参数 force-host-assisted-migration 为 True 时,share 迁移 API 中的快照限制已更改为仅返回错误。
弃用了
service_instance_network_helper_type选项以供删除。此选项不再用于任何内容,因为 nova networking 不再受支持。
与 “consistency_group” 和 “cgsnapshot” API 相关的策略已从 manila 中删除。这些策略可以从 “policy.json” 中删除。
如果使用具有 HNAS 后端的现有 share 类型,请设置 ‘mount_snapshot_support’ extra-spec 以允许创建支持 mountable snapshots 的 share。此修改不会影响此类类型的现有 share。
需要在 manila.conf 中添加新的选项来指定协调后端 URL(例如,分布式锁定管理器 (DLM) 后端或基于文件的锁定位置)。配置确定用于锁定/协调的 tooz 驱动程序。
EMCShareDriver 已移动到 dell_emc 目录。manila.conf 中的 share_driver 条目需要更改为 manila.share.drivers.dell_emc.driver.EMCShareDriver。供应商名称已更改为“Dell EMC”。
由于遗留 nova networking 在 Newton 中已被弃用,并且不再在 Ocata 的常规部署中受支持,因此从 service instance 模块中删除了 nova net 支持。
删除了 share_networks API 和 ShareNetwork DB 模型中的
nova_net_id的支持。还删除了 nova 网络插件本身以及相应的 manila.conf 选项。
对于 Dell EMC Unity Manila 驱动程序,将 emc_nas_pool_names 替换为 unity_share_data_pools,将 emc_nas_server_pool 替换为 unity_server_meta_pool,将 emc_interface_ports 替换为 unity_ethernet_ports。
对于 Dell EMC VNX Manila 驱动程序,将 emc_nas_pool_names 替换为 vnx_share_data_pools,将 emc_interface_ports 替换为 vnx_ethernet_ports,将 emc_nas_server_container 替换为 vnx_server_container。
弃用说明¶
宣布在 mitaka 版本中弃用 manila v1 API。API 的 versions 响应已修复,表明此版本已被弃用。如果您正在使用 v1 API,请考虑切换到 v2 API 以利用新功能。v2 API 支持 ‘microversions’。v2 API 上的任何端点都可以通过 HTTP 标头 ‘X-OpenStack-Manila-API-Version’ 请求,并提供一个值 ‘2.x’,其中 ‘2’ 是主版本,‘x’ 是次版本(或 ‘micro’)版本。为了继续利用 v1 API 的一部分功能,您可以使用 microverison ‘2.0’ 的 v2 API,其行为与 v1 API 相同。
对于 API microversions 低于 2.30 的实验性 share 迁移 API,已删除支持。
对于 Dell EMC Unity Manila 驱动程序,选项 emc_nas_pool_names、emc_nas_server_pool、emc_interface_ports、emc_nas_server_container 已被弃用。
对于 Dell EMC VNX Manila 驱动程序,选项 emc_nas_pool_names、emc_interface_ports、emc_nas_server_container 已被弃用。
关键问题¶
当以非管理员权限调用 /shares 和 /share-replicas API 时,JSON 响应中不再返回 “host” 字段。依赖此字段的应用程序需要进行相应更新。此字段的值是特权信息,并且请求上下文必须指定管理员权限才能使用这些 API 来显示 “host” 字段。GET /shares API 中 “host” 作为筛选键的使用受策略 “list_by_host” 控制。此策略默认为 “rule:admin_api”。
错误修复¶
修复了在验证 manila.conf 中提供的 share 服务器 IP 地址与数组上设置的 IP 地址时,3PAR 驱动程序启动失败的问题。
添加了检查以验证不能在指定驱动程序辅助迁移选项时强制主机辅助迁移。
share 迁移 API 只能在至少一个参数(host、share-network、share-type)预计会更改时调用。
当在创建 neutron 端口时指定 host_id 但未激活 port_binding 扩展时,会引发异常。
NetApp cDOT 驱动程序现在显式地过滤掉报告给 manila 调度器的 root aggregates,如果驱动程序使用集群凭据运行。
修复了一个 bug,share manager 在同时向给定 share 添加多个 access rules 时会丢失 access rule 更新。
与其让所有现有的 access rules 在更新期间发生错误时过渡到 ‘error’ 状态,只有在更新期间处于过渡状态(‘applying’,‘denying’)的规则才会过渡到 ‘error’ 状态。此更改预计将有助于识别需要用户解决的任何“坏”规则。
处理允许和拒绝 share 访问的 share action API 现在首先执行策略检查以授权调用这些 API。
与之前一样,当 share 被复制(或正在迁移)时,必须使 share 的所有副本(或迁移实例)处于有效状态,才能允许或拒绝访问 share(在允许的情况下)。API 中执行此检查的修复程序。
修复了主机辅助 share 迁移期间 share 仍然具有读/写访问规则的问题。
为驱动程序辅助 share 迁移请求迁移完成时添加了缺失的 ‘migration_completing’ 任务状态。
在 Generic 驱动程序中,当 share 被缩小后,backing volume 的大小大于 share 的大小。因此,此驱动程序中的 share 扩展逻辑已更改为仅在 backing volume 的大小小于新扩展 share 的大小时才扩展 backing volume。
添加了在 CEPHFS 后端启动时验证后端是否可访问的检查。
修复了 ZFSonLinux 子 share 从快照继承 access rules 的问题。之前继承了,现在没有,如预期。现在,从快照创建的每个 share 将不会继承 access rules。
修复了在 LVM 和 Generic 驱动程序上从快照创建 share 时,不再与源 share 共享相同文件系统句柄的问题。原因是与 Ubuntu launchpad bug https://bugs.launchpad.net/ubuntu/+source/linux/+bug/1071733 中描述的原因相同
更改了 NetApp cDOT 驱动程序在运行 DHSS=True 时,以维护 IPSpaces 和广播域之间的 1-1 关系。
修复了在 Generic 驱动程序上扩展和缩小 share 时使用的不正确的 exportfs 命令。
修复了 GPFS CES 以允许向 share 添加第一个 access rule。
修复了 GPFS CES 以允许删除没有 access rules 的 share。
修复了 GPFS CES 以允许删除失败的 access rule,当没有成功的 access rules 时。
修复了 GPFS KNFS 生成 NFS 服务器 allow/deny 命令时,当 gpfs_nfs_server_list 中有多个服务器时,用于一个服务器的远程 ssh 登录前缀不会被传递到后续服务器的命令的问题。
修复了 GPFS KNFS deny access,以便在可以验证访问不存在时不会失败。
修复了删除 share 时 share 元数据记录未被软删除的错误。
修复了在使用 LVM 驱动程序将 share 恢复到快照时,存在 share 的 access rules 导致失败的问题。
share 不能在成为 share groups 的成员时被迁移。
修复了使用通用 share 驱动程序接口创建 share group 快照的默认方法,通过进行此方法的正确调用。之前,一些依赖于 ‘snapshot’ 对象中的某些特定数据的驱动程序无法获取这些数据而失败。
错误状态的快照访问规则不再导致其他规则也进入错误状态。
修复了为 `mount_snapshot_support=False` 的共享创建快照导出位置的问题。
与迁移目标相关的导出位置在迁移完成之前不再显示。
为便于未来移植“共享组”功能的错误修复,向 ‘share_groups’ DB 模型添加了 ‘consistent_snapshot_support’ 属性。
修复了 HNAS 驱动在未先将其更改为只读的情况下创建 NFS 共享快照的问题。
修复了可挂载快照的驱动程序辅助共享迁移中的错误。
Windows 驱动程序中关于共享创建的问题已修复。
根据 Ocata 版本中添加的新内容,修复了 HNAS 驱动程序版本。
容器驱动程序。通过添加共享外部锁修复了共享和共享服务器删除的并发问题。
修复了 Hitachi HNAS 驱动程序在管理快照时未检查后端导出的问题。
通过首先停用 QoS,修复了华为驱动程序中 QoS 状态为 ‘idle’ 时 QoS 删除失败的问题。
HNAS 驱动程序正确处理对已管理 CIFS 共享上现有访问规则的规则更新。
修复了 HNAS 驱动程序在管理快照时由于后端并发引起的错误。
共享复制工作流由 share-manager 服务在 tooz 库的帮助下协调,而不是 oslo_concurrency。这允许部署者配置分布式锁管理,如果多个 manila-share 服务在不同节点上运行。
在 Dell EMC Unity 后端上无法创建小于 3 GB 的共享。如果用户创建小于 3 GB 的共享,将在 Unity 系统上为其分配 3 GB 文件系统。
其他说明¶
从 Generic 驱动程序中删除了伪造的一致性组支持。它仅为测试目的而添加,现在已多余。