[Doc] Share Migration Ocata Improvements

Bug #1658230 reported by OpenStack Infra on 2017-01-20
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Manila
Medium
Sneha Prasad

Bug Description

https://review.openstack.org/406305
Dear bug triager. This bug was created since a commit was marked with DOCIMPACT.
Your project "openstack/manila" is set up so that we directly report the documentation bugs against it. If this needs changing, the docimpact-group option needs to be added for the project. You can ask the OpenStack infra team (#openstack-infra on freenode) for help if you need to.

commit 53539c0e1d9f6d7abaef2fb31dad84e86d674372
Author: Rodrigo Barbieri <email address hidden>
Date: Thu Nov 24 15:52:03 2016 -0200

    Share Migration Ocata Improvements

    Implemented several improvements to share migration
    according to spec [1].

    Summary of changes:
    - Snapshot restriction in API has been changed to return error only
    when parameter force-host-assisted-migration is True
    - Added preserve_snapshot to API and migration_check_compatibility
    driver interface
    - Changed all driver-assisted API parameters to be mandatory
    - Added validation to prevent 'force_host_assisted_migration' to be
    used alongside driver-assisted parameters
    - Changed "same host" validation to reject only if the combination
    of "host", "new_share_network" and "new_share_type" is the same as
    the source
    - Updated migration driver interfaces to support snapshots
    - Updated zfsonlinux driver, defaulting preserve_snapshots to False
    - Updated dummy driver to support preserve_snapshots

    Spec update with latest changes since [1] merged
    can be found in [2].

    APIImpact
    DocImpact

    [1] I5717e902373d79ed0d55372afdedfaa98134c24e
    [2] If02180ec3b5ae05c9ff18c9f5a054c33f13edcdf

    Change-Id: I764b389816319ed0ac5178cadbf809cb632035b4
    Partially-implements: blueprint ocata-migration-improvements

summary: - Share Migration Ocata Improvements
+ [Doc] Share Migration Ocata Improvements
Changed in manila:
importance: Undecided → Medium
tags: added: low-hanging-fruit
Sneha Prasad (snpd) on 2019-03-30
Changed in manila:
assignee: nobody → Sneha Prasad (snpd)
Sneha Prasad (snpd) wrote :

It appears to me that share_migration.rst has been already modified
accordingly. Is zfs-on-linux-driver.rst or any other file needs to be
modified too?

Goutham Pacha Ravi (gouthamr) wrote :

Hi Sneha,

Thanks for looking at this long-pending issue!

The specification for this feature mentions the documentation that ought to be there [1]. It doesn't have a lot of detail, but some of what it calls out has been added, see Developer Reference [2], Administrator Reference [3].

What seems to be missing is the API reference - https://developer.openstack.org/api-ref/shared-file-system/#share-migration-since-api-v2-5 is woefully out of date. If you're interested in contributing, please take a look at the share migration API and update the API reference in the manila tree. Feel free to ask questions here if you need more direction.

[1] http://specs.openstack.org/openstack/manila-specs/specs/ocata/ocata-migration-improvements.html#id1
[2] https://docs.openstack.org/manila/latest/contributor/share_migration.html
[3] https://docs.openstack.org/manila/latest/admin/shared-file-systems-share-migration.html

Sneha Prasad (snpd) wrote :

Hi Gautham,

I went through the documentation: https://docs.openstack.org/manila/latest/contributor/share_migration.html . Just had one question: What are the things that need to be added to the API reference? The parameter description, or the details about Share Migration driver-assisted interfaces, or is there any wrong info which I need to correct?

Thanks.

To post a comment you must log in.
This report contains Public information  Edit
Everyone can see this information.

Other bug subscribers