Merge "Updates the share extend and shrink documentation"
This commit is contained in:
Zuul
@@ -4,16 +4,15 @@
|
||||
Resize share
|
||||
============
|
||||
|
||||
To change file share size, use the :command:`manila extend` command and
|
||||
the :command:`manila shrink` command. For most drivers it is safe
|
||||
operation. If you want to be sure that your data is safe, you can make
|
||||
a share back up by creating a snapshot of it.
|
||||
For most drivers, resizing the share is safe operation. If you want to be sure
|
||||
that your data is safe, you can make a share back up by creating a snapshot of
|
||||
it.
|
||||
|
||||
You can extend and shrink the share with the :command:`manila extend` and
|
||||
:command:`manila shrink` commands respectively, and specify the share
|
||||
with the new size that does not exceed the quota. For details, see
|
||||
:ref:`Quotas and Limits <shared_file_systems_quotas>`. You also cannot shrink
|
||||
share size to 0 or to a greater value than the current share size.
|
||||
You can extend and shrink the share with the :command:`openstack share resize`
|
||||
command, and specify the share with the new size that does not exceed the
|
||||
quota. For details, see :ref:`Quotas and Limits <shared_file_systems_quotas>`.
|
||||
You also cannot shrink share size to 0 or to a greater value than the current
|
||||
share size.
|
||||
|
||||
.. note::
|
||||
From API version 2.53, extending a replicated share, manila quota system
|
||||
@@ -30,46 +29,44 @@ To extend the share and check the result, run:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ manila extend docs_resize 2
|
||||
$ manila show docs_resize
|
||||
+----------------------+--------------------------------------------------------------------------+
|
||||
| Property | Value |
|
||||
+----------------------+--------------------------------------------------------------------------+
|
||||
| status | available |
|
||||
| share_type_name | my_type |
|
||||
| description | None |
|
||||
| availability_zone | nova |
|
||||
| share_network_id | None |
|
||||
| export_locations | |
|
||||
| | path = 1.0.0.4:/shares/manila_share_b8afc508_8487_442b_b170_ea65b07074a8 |
|
||||
| | preferred = False |
|
||||
| | is_admin_only = False |
|
||||
| | id = 3ffb76f4-92b9-4639-83fd-025bc3e302ff |
|
||||
| | share_instance_id = b8afc508-8487-442b-b170-ea65b07074a8 |
|
||||
| | path = 2.0.0.3:/shares/manila_share_b8afc508_8487_442b_b170_ea65b07074a8 |
|
||||
| | preferred = False |
|
||||
| | is_admin_only = True |
|
||||
| | id = 1f0e263f-370d-47d3-95f6-1be64088b9da |
|
||||
| | share_instance_id = b8afc508-8487-442b-b170-ea65b07074a8 |
|
||||
| share_server_id | None |
|
||||
| share_group_id | None |
|
||||
| host | manila@paris#shares |
|
||||
| access_rules_status | active |
|
||||
| snapshot_id | None |
|
||||
| is_public | False |
|
||||
| task_state | None |
|
||||
| snapshot_support | True |
|
||||
| id | b07dbebe-a328-403c-b402-c8871c89e3d1 |
|
||||
| size | 2 |
|
||||
| name | docs_resize |
|
||||
| share_type | 14ee8575-aac2-44af-8392-d9c9d344f392 |
|
||||
| has_replicas | False |
|
||||
| replication_type | None |
|
||||
| created_at | 2016-03-25T15:33:18.000000 |
|
||||
| share_proto | NFS |
|
||||
| project_id | 907004508ef4447397ce6741a8f037c1 |
|
||||
| metadata | {} |
|
||||
+----------------------+--------------------------------------------------------------------------+
|
||||
$ openstack share resize docs_resize 2
|
||||
$ openstack share show docs_resize
|
||||
+---------------------------------------+---------------------------------------+
|
||||
| Property | Value |
|
||||
+---------------------------------------+---------------------------------------+
|
||||
| id | a3454cf1-bb1d-4e4d-a8e4-a3881c593720 |
|
||||
| size | 2 |
|
||||
| availability_zone | manila-zone-0 |
|
||||
| created_at | 2024-09-26T14:53:18.153832 |
|
||||
| status | extending |
|
||||
| name | docs_resize |
|
||||
| description | None |
|
||||
| project_id | 1f31ee1c3e3c443bbf9aee5684456daa |
|
||||
| snapshot_id | None |
|
||||
| share_network_id | None |
|
||||
| share_proto | NFS |
|
||||
| metadata | {} |
|
||||
| share_type | 303f0a73-711e-4beb-a4f7-a60acc1d588e |
|
||||
| is_public | True |
|
||||
| snapshot_support | True |
|
||||
| task_state | None |
|
||||
| share_type_name | default |
|
||||
| access_rules_status | active |
|
||||
| replication_type | None |
|
||||
| has_replicas | False |
|
||||
| user_id | b47d81c8c8c74ea3a7c13461f30ad5ed |
|
||||
| create_share_from_snapshot_support | True |
|
||||
| revert_to_snapshot_support | False |
|
||||
| share_group_id | None |
|
||||
| source_share_group_snapshot_member_id | None |
|
||||
| mount_snapshot_support | False |
|
||||
| progress | 100% |
|
||||
| is_soft_deleted | False |
|
||||
| scheduled_to_be_deleted_at | None |
|
||||
| source_backup_id | None |
|
||||
| share_server_id | None |
|
||||
| host | host@backend1#poolA |
|
||||
+---------------------------------------+---------------------------------------+
|
||||
|
||||
While shrinking, the share has a ``shrinking`` status. This means that the
|
||||
decrease share size request was issued successfully. To shrink the share and
|
||||
@@ -77,43 +74,41 @@ check the result, run:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
$ manila shrink docs_resize 1
|
||||
$ manila show docs_resize
|
||||
+----------------------+--------------------------------------------------------------------------+
|
||||
| Property | Value |
|
||||
+----------------------+--------------------------------------------------------------------------+
|
||||
| status | available |
|
||||
| share_type_name | my_type |
|
||||
| description | None |
|
||||
| availability_zone | nova |
|
||||
| share_network_id | None |
|
||||
| export_locations | |
|
||||
| | path = 1.0.0.4:/shares/manila_share_b8afc508_8487_442b_b170_ea65b07074a8 |
|
||||
| | preferred = False |
|
||||
| | is_admin_only = False |
|
||||
| | id = 3ffb76f4-92b9-4639-83fd-025bc3e302ff |
|
||||
| | share_instance_id = b8afc508-8487-442b-b170-ea65b07074a8 |
|
||||
| | path = 2.0.0.3:/shares/manila_share_b8afc508_8487_442b_b170_ea65b07074a8 |
|
||||
| | preferred = False |
|
||||
| | is_admin_only = True |
|
||||
| | id = 1f0e263f-370d-47d3-95f6-1be64088b9da |
|
||||
| | share_instance_id = b8afc508-8487-442b-b170-ea65b07074a8 |
|
||||
| share_server_id | None |
|
||||
| share_group_id | None |
|
||||
| host | manila@paris#shares |
|
||||
| access_rules_status | active |
|
||||
| snapshot_id | None |
|
||||
| is_public | False |
|
||||
| task_state | None |
|
||||
| snapshot_support | True |
|
||||
| id | b07dbebe-a328-403c-b402-c8871c89e3d1 |
|
||||
| size | 1 |
|
||||
| name | docs_resize |
|
||||
| share_type | 14ee8575-aac2-44af-8392-d9c9d344f392 |
|
||||
| has_replicas | False |
|
||||
| replication_type | None |
|
||||
| created_at | 2016-03-25T15:33:18.000000 |
|
||||
| share_proto | NFS |
|
||||
| project_id | 907004508ef4447397ce6741a8f037c1 |
|
||||
| metadata | {} |
|
||||
+----------------------+--------------------------------------------------------------------------+
|
||||
$ openstack share resize docs_resize 1
|
||||
$ openstack share show docs_resize
|
||||
+---------------------------------------+---------------------------------------+
|
||||
| Property | Value |
|
||||
+---------------------------------------+---------------------------------------+
|
||||
| id | a3454cf1-bb1d-4e4d-a8e4-a3881c593720 |
|
||||
| size | 1 |
|
||||
| availability_zone | manila-zone-0 |
|
||||
| created_at | 2024-09-26T14:53:18.153832 |
|
||||
| status | shrinking |
|
||||
| name | docs_resize |
|
||||
| description | None |
|
||||
| project_id | 1f31ee1c3e3c443bbf9aee5684456daa |
|
||||
| snapshot_id | None |
|
||||
| share_network_id | None |
|
||||
| share_proto | NFS |
|
||||
| metadata | {'__mount_options': 'fs=cephfs'} |
|
||||
| share_type | 303f0a73-711e-4beb-a4f7-a60acc1d588e |
|
||||
| is_public | True |
|
||||
| snapshot_support | True |
|
||||
| task_state | None |
|
||||
| share_type_name | default |
|
||||
| access_rules_status | active |
|
||||
| replication_type | None |
|
||||
| has_replicas | False |
|
||||
| user_id | b47d81c8c8c74ea3a7c13461f30ad5ed |
|
||||
| create_share_from_snapshot_support | True |
|
||||
| revert_to_snapshot_support | False |
|
||||
| share_group_id | None |
|
||||
| source_share_group_snapshot_member_id | None |
|
||||
| mount_snapshot_support | False |
|
||||
| progress | 100% |
|
||||
| is_soft_deleted | False |
|
||||
| scheduled_to_be_deleted_at | None |
|
||||
| source_backup_id | None |
|
||||
| share_server_id | None |
|
||||
| host | host@backend1#poolA |
|
||||
+---------------------------------------+---------------------------------------+
|
||||
|
||||
Reference in New Issue
Block a user