]> git.proxmox.com Git - ceph.git/blobdiff - ceph/doc/ceph-volume/lvm/zap.rst
update sources to v12.2.3
[ceph.git] / ceph / doc / ceph-volume / lvm / zap.rst
index 8d42a9089d8940f13ae5eb34f75604316d0383f9..2236ad4efbc44323bf9b918ff38c9da64c0f8177 100644 (file)
@@ -3,13 +3,16 @@
 ``zap``
 =======
 
-This subcommand is used to zap lvs or partitions that have been used
+This subcommand is used to zap lvs, partitions or raw devices that have been used
 by ceph OSDs so that they may be reused. If given a path to a logical
 volume it must be in the format of vg/lv. Any filesystems present
 on the given lv or partition will be removed and all data will be purged.
 
 .. note:: The lv or partition will be kept intact.
 
+.. note:: If the logical volume, raw device or partition is being used for any ceph related
+          mount points they will be unmounted.
+
 Zapping a logical volume::
 
       ceph-volume lvm zap {vg name/lv name}
@@ -17,3 +20,13 @@ Zapping a logical volume::
 Zapping a partition::
 
       ceph-volume lvm zap /dev/sdc1
+
+If you are zapping a raw device or partition and would like any vgs or lvs created
+from that device removed use the ``--destroy`` flag. A common use case is to simply
+deploy OSDs using a whole raw device. If you do so and then wish to reuse that device for
+another OSD you must use the ``--destroy`` flag when zapping so that the vgs and lvs that
+ceph-volume created on the raw device will be removed.
+
+Zapping a raw device and destroying any vgs or lvs present::
+
+      ceph-volume lvm zap /dev/sdc --destroy