File: share-network-subnet-operations.rst

package info (click to toggle)
manila 1%3A11.0.0-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 18,432 kB
  • sloc: python: 210,959; sh: 1,959; pascal: 817; makefile: 63
file content (128 lines) | stat: -rw-r--r-- 9,818 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
.. _share_network_subnet:

=======================================
Create and manage share network subnets
=======================================

.. contents:: :local:

A share network subnet stores network information to create and manage shares.
To create and manage your share network subnets, you can use ``manila`` client
commands. You can create multiple subnets in a share network, and if you do
not specify an availability zone, the subnet you are creating will be
considered default by the Shared File Systems service. The default subnet
spans all availability zones. You cannot have more than one default subnet
per share network.


.. important::

   In order to use share networks, the share type you choose must have the
   extra specification ``driver_handles_share_servers`` set to True.

Create a subnet in an existing share network
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#. Create a subnet related to the given share network

   .. code-block:: console

      $ manila share-network-subnet-create \
         sharenetwork1 \
         --availability-zone manila-zone-0 \
         --neutron-net-id a27160ca-5595-4c62-bf54-a04fb7b14316 \
         --neutron-subnet-id f043f4b0-c05e-493f-bbe9-99689e2187d2
      +--------------------+--------------------------------------+
      | Property           | Value                                |
      +--------------------+--------------------------------------+
      | id                 | be3ae5ad-a22c-494f-840e-5e3526e34e0f |
      | availability_zone  | manila-zone-0                        |
      | share_network_id   | 35f44d3c-8888-429e-b8c7-8a29dead6e5b |
      | share_network_name | sharenetwork1                        |
      | created_at         | 2019-10-09T04:54:48.000000           |
      | segmentation_id    | None                                 |
      | neutron_subnet_id  | f043f4b0-c05e-493f-bbe9-99689e2187d2 |
      | updated_at         | None                                 |
      | neutron_net_id     | a27160ca-5595-4c62-bf54-a04fb7b14316 |
      | ip_version         | None                                 |
      | cidr               | None                                 |
      | network_type       | None                                 |
      | mtu                | None                                 |
      | gateway            | None                                 |
      +--------------------+--------------------------------------+


#. Show the share network to verify if the created subnet is attached

   .. code-block:: console

      $ manila share-network-show sharenetwork1
      +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
      | Property              | Value                                                                                                                                                                                                                                                                                                                                                                                        |
      +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
      | id                    | 35f44d3c-8888-429e-b8c7-8a29dead6e5b                                                                                                                                                                                                                                                                                                                                                         |
      | name                  | sharenetwork1                                                                                                                                                                                                                                                                                                                                                                                |
      | project_id            | 8c2962a4832743469a336f7c179f7d34                                                                                                                                                                                                                                                                                                                                                             |
      | created_at            | 2019-10-09T04:19:31.000000                                                                                                                                                                                                                                                                                                                                                                   |
      | updated_at            | None                                                                                                                                                                                                                                                                                                                                                                                         |
      | description           | Share Network created for demo purposes                                                                                                                                                                                                                                                                                                                                                      |
      | share_network_subnets | [{'id': 'be3ae5ad-a22c-494f-840e-5e3526e34e0f', 'availability_zone': 'manila-zone-0', 'created_at': '2019-10-09T04:54:48.000000', 'updated_at': None, 'segmentation_id': None, 'neutron_net_id': 'a27160ca-5595-4c62-bf54-a04fb7b14316', 'neutron_subnet_id': 'f043f4b0-c05e-493f-bbe9-99689e2187d2', 'ip_version': None, 'cidr': None, 'network_type': None, 'mtu': None, 'gateway': None}] |
      +-----------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+


Show a share network subnet
~~~~~~~~~~~~~~~~~~~~~~~~~~~

#. Show an existent subnet in a given share network

   .. code-block:: console

      $ manila share-network-subnet-show \
         sharenetwork1 \
         be3ae5ad-a22c-494f-840e-5e3526e34e0f
      +--------------------+--------------------------------------+
      | Property           | Value                                |
      +--------------------+--------------------------------------+
      | id                 | be3ae5ad-a22c-494f-840e-5e3526e34e0f |
      | availability_zone  | manila-zone-0                        |
      | share_network_id   | 35f44d3c-8888-429e-b8c7-8a29dead6e5b |
      | share_network_name | sharenetwork1                        |
      | created_at         | 2019-10-09T04:54:48.000000           |
      | segmentation_id    | None                                 |
      | neutron_subnet_id  | f043f4b0-c05e-493f-bbe9-99689e2187d2 |
      | updated_at         | None                                 |
      | neutron_net_id     | a27160ca-5595-4c62-bf54-a04fb7b14316 |
      | ip_version         | None                                 |
      | cidr               | None                                 |
      | network_type       | None                                 |
      | mtu                | None                                 |
      | gateway            | None                                 |
      +--------------------+--------------------------------------+

Delete a share network subnet
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#. Delete a specific share network subnet

   .. code-block:: console

      $ manila share-network-subnet-delete \
         sharenetwork1 \
         be3ae5ad-a22c-494f-840e-5e3526e34e0f

#. Verify that it has been deleted

   .. code-block:: console

      $ manila share-network-show sharenetwork1
      +-----------------------+-----------------------------------------+
      | Property              | Value                                   |
      +-----------------------+-----------------------------------------+
      | id                    | 35f44d3c-8888-429e-b8c7-8a29dead6e5b    |
      | name                  | sharenetwork1                           |
      | project_id            | 8c2962a4832743469a336f7c179f7d34        |
      | created_at            | 2019-10-09T04:19:31.000000              |
      | updated_at            | None                                    |
      | description           | Share Network created for demo purposes |
      | share_network_subnets | []                                      |
      +-----------------------+-----------------------------------------+