Chapter 8. manila test
Chapter 8. manila test The manila test applies to OpenStack products or components that implement features for the OpenStack Shared File System Storage service. The test uses Tempest Framework integrated with the Red Hat OpenStack Services on OpenShift (RHOSO) to test both operational and functional features. The manila test verifies the functionality of the manila driver that you are certifying by running selected feature tests. The following feature groups are currently tested: Section 8.1, "manila-shr" (required) Section 8.2, "manila-shr-managed" (optional) Section 8.3, "manila-shr-shrink" (optional) Section 8.4, "manila-shr-extend" (required) Section 8.5, "manila-snap" (optional) Section 8.6, "manila-snap-managed" (optional) Section 8.7, "manila-shr-frm-snap" (optional) Section 8.8, "manila-snap-revert" (optional) Section 8.9, "manila-snap-mount" (optional) Section 8.10, "manila-shr-replicas" (optional) Section 8.11, "manila-shr-groups" (required) Section 8.12, "manila-svr-managed" (only for DHSS=True, optional) Manila testing must include the tests defined in the test plan, covering the required tests and any implemented additional features. Note If you are certifying a backend that supports multiple driver modes indicated by the attribute "driver_handles_share_servers", abbreviated as DHSS, set to true or false, or multiple storage protocols such as Network File System (NFS) and Common Internet File System (CIFS), you must adjust the test configuration to submit one test result per combination of driver mode and supported protocols. For example, if the driver being certified supports both NFS and CIFS, and both DHSS=True and DHSS=False, you must submit separate certification tests for each combination: DHSS=True with NFS. DHSS=False with NFS. DHSS=True with CIFS. DHSS=False with CIFS. Prerequisites When deploying the Control plane, ensure that you provide at least two instances of the shared file system backend driver you intend to certify. Note Having more than one hardware storage is not required; configuring both manila backends to use the same hardware array is supported. Ensure you configure the separate manila backends on separate "manila-share" pods. Multi-backend configuration on a single pod was supported in earlier releases of RHOSP, but is no longer supported in RHOSO. The rhoso-cert tooling will automatically detect and set some test configurations, however, manual adjustments may still be required to ensure that the features being tested are appropriately configured. These configurations should be specified in a file named tempest-conf-overrides . Note When defining custom configuration options, avoid setting options that could mask test failures, such as share.suppress_errors_in_cleanup . In the current RHOSO version, all manila tests are executed, including both required and optional tests such as replication, managing snapshots, and so on. The optional tests may fail if your driver does not support those features. This is acceptable and does not impact the overall certification process. When certifying a DHSS=True back end, ensure the following: When testing with NFS, ensure that the manila service is configured with NeutronNetworkPlugin or its derivative. The use of StandaloneNetworkPlugin is discouraged. When testing with CIFS, the use of NeutronNetworkPlugin may be complicated if the authentication server (typically an active directory server) is external to the cloud. You may use StandaloneNetworkPlugin in such a case to represent the datacenter's storage networking. Create an accounts.yaml file for the rhcert tooling to use. This is essential to avoid cleanup errors in tempest tests. 8.1. manila-shr The manila-shr test checks the base file operations with either the NFS or CIFS protocols. This test also covers the base operations with or without the "driver handles share servers" (DHSS) feature enabled. It tests the APIs to create, delete, update, and retrieve core manila resources like share types, availability zones, storage pool statistics, limits, quotas, metadata, API versioning, access rules, user messages, security services, share networks, share actions, and share instances. 8.2. manila-shr-managed The manila-shr-managed test checks the driver's ability to abandon existing shares and adopt them back into manila. 8.3. manila-shr-shrink The manila-shr-shrink test checks the driver's capability to shrink manila shares. 8.4. manila-shr-extend The manila-shr-extend test checks the driver's capability to extend manila shares. 8.5. manila-snap A snapshot allows users to capture the contents of a share at a point in time. Users have the option to restore the data in place, clone the snapshot into a new share, or control access to the snapshot via access rules and mount the snapshot directly as a read-only filesystem. The plugin or driver functionalities that are tested as part of manila_snapshot test are: Creating snapshots Altering snapshot status Deleting or force delete snapshots Interacting with share snapshot instances Deleting shares with existing snapshots Creating larger shares with a snapshot of a smaller size Creating shares from snapshot within a different share network Deleting snapshot with incorrect share id Creating snapshot with incorrect snapshot id Listing shares by snapshot id Listing and renaming snapshots Adding and manipulating snapshot metadata 8.6. manila-snap-managed The manila-snap-managed test checks the driver's capability to abandon existing snapshots and adopt them back into Manila. 8.7. manila-shr-frm-snap The manila-shr-frm-snap test checks the driver's capability to create new shares from existing snapshots. 8.8. manila-snap-revert The manila-snap-revert test checks the driver's capability to revert a share to its latest snapshot. 8.9. manila-snap-mount The manila-snap-mount test checks the driver's capability to create snapshots that can directly be mounted as read-only filesystems. 8.10. manila-shr-replicas The manila-shr-replicas test checks the driver's capability to create replicas of a share across availability zones and perform actions on a replica such as promotion, forced syncing, deletion, and taking snapshots. 8.11. manila-shr-groups The manila-shr-groups test checks the driver's capability to create share group types and share groups, including the ability to create shares within these groups. It also tests the ability to update groups, delete groups, and take group snapshots. The ability of the driver to take consistent snapshots of the group must be configured. 8.12. manila-svr-managed The manila-svr-managed test checks the driver's capability to abandon a share server that was created within manila and adopt it again. It also tests the ability to abandon all the shares exported on the share server and adopt them back.