pve-storage-rbd.adoc

   1 [[ceph_rados_block_devices]]
   2 Ceph RADOS Block Devices (RBD)
   3 ------------------------------
   4 ifdef::wiki[]
   5 :pve-toplevel:
   6 :title: Storage: RBD
   7 endif::wiki[]
   8
   9 Storage pool type: `rbd`
  10
  11 http://ceph.com[Ceph] is a distributed object store and file system
  12 designed to provide excellent performance, reliability and
  13 scalability. RADOS block devices implement a feature rich block level
  14 storage, and you get the following advantages:
  15
  16 * thin provisioning
  17 * resizable volumes
  18 * distributed and redundant (striped over multiple OSDs)
  19 * full snapshot and clone capabilities
  20 * self healing
  21 * no single point of failure
  22 * scalable to the exabyte level
  23 * kernel and user space implementation available
  24
  25 NOTE: For smaller deployments, it is also possible to run Ceph
  26 services directly on your {pve} nodes. Recent hardware has plenty
  27 of CPU power and RAM, so running storage services and VMs on same node
  28 is possible.
  29
  30 [[storage_rbd_config]]
  31 Configuration
  32 ~~~~~~~~~~~~~
  33
  34 This backend supports the common storage properties `nodes`,
  35 `disable`, `content`, and the following `rbd` specific properties:
  36
  37 monhost::
  38
  39 List of monitor daemon IPs.
  40
  41 pool::
  42
  43 Ceph pool name.
  44
  45 username::
  46
  47 RBD user Id.
  48
  49 krbd::
  50
  51 Access rbd through krbd kernel module. This is required if you want to
  52 use the storage for containers.
  53
  54 .Configuration Example (`/etc/pve/storage.cfg`)
  55 ----
  56 rbd: ceph3
  57         monhost 10.1.1.20 10.1.1.21 10.1.1.22
  58         pool ceph3
  59         content images
  60         username admin
  61 ----
  62
  63 TIP: You can use the `rbd` utility to do low-level management tasks.
  64
  65 Authentication
  66 ~~~~~~~~~~~~~~
  67
  68 If you use `cephx` authentication, you need to copy the keyfile from
  69 Ceph to Proxmox VE host.
  70
  71 Create the directory `/etc/pve/priv/ceph` with
  72
  73  mkdir /etc/pve/priv/ceph
  74
  75 Then copy the keyring
  76
  77  scp <cephserver>:/etc/ceph/ceph.client.admin.keyring /etc/pve/priv/ceph/<STORAGE_ID>.keyring
  78
  79 The keyring must be named to match your `<STORAGE_ID>`. Copying the
  80 keyring generally requires root privileges.
  81
  82 Storage Features
  83 ~~~~~~~~~~~~~~~~
  84
  85 The `rbd` backend is a block level storage, and implements full
  86 snapshot and clone functionality.
  87
  88 .Storage features for backend `rbd`
  89 [width="100%",cols="m,m,3*d",options="header"]
  90 |==============================================================================
  91 |Content types  |Image formats  |Shared |Snapshots |Clones
  92 |images rootdir |raw            |yes    |yes       |yes
  93 |==============================================================================
  94
  95 ifdef::wiki[]
  96
  97 See Also
  98 ~~~~~~~~
  99
 100 * link:/wiki/Storage[Storage]
 101
 102 endif::wiki[]
 103