8e9507bf9a
This change moves the .rst files into the main adming-guide-cloud folder now conversion is complete. changes to the project config and to the openstack manuals to stop sync of .xml files are also needed. Change-Id: I498e8d6ac3cb80da413e23b14a0959abd58e7d79 Implements: blueprint reorganise-user-guides
37 lines
1.5 KiB
ReStructuredText
37 lines
1.5 KiB
ReStructuredText
.. _glusterfs_removal:
|
|
|
|
.. highlight: ini
|
|
:linenothreshold: 5
|
|
|
|
===============================================
|
|
Gracefully remove a GlusterFS volume from usage
|
|
===============================================
|
|
|
|
Configuring the ``cinder`` volume service to use GlusterFS involves creating a
|
|
shares file (for example, :file:`/etc/cinder/glusterfs`). This shares file
|
|
lists each GlusterFS volume (with its corresponding storage server) that
|
|
the ``cinder`` volume service can use for back end storage.
|
|
|
|
To remove a GlusterFS volume from usage as a back end, delete the volume's
|
|
corresponding entry from the shares file. After doing so, restart the Block
|
|
Storage services.
|
|
|
|
To restart the Block Storage services on CentOS, Fedora, openSUSE,
|
|
Red Hat Enterprise Linux, or SUSE Linux Enterprise, run::
|
|
|
|
# for i in api scheduler volume; do service openstack-cinder-$i restart; done
|
|
|
|
To restart the Block Storage services on Ubuntu or Debian, run::
|
|
|
|
# for i in api scheduler volume; do service cinder-${i} restart; done
|
|
|
|
Restarting the Block Storage services will prevent the ``cinder`` volume
|
|
service from exporting the deleted GlusterFS volume. This will prevent any
|
|
instances from mounting the volume from that point onwards.
|
|
|
|
However, the removed GlusterFS volume might still be mounted on an instance
|
|
at this point. Typically, this is the case when the volume was already
|
|
mounted while its entry was deleted from the shares file.
|
|
Whenever this occurs, you will have to unmount the volume as normal after
|
|
the Block Storage services are restarted.
|