blob: 951757c78179569db138c0cf093e23bf1daee30b (
plain)
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
|
==========================
Kernel Module Operations
==========================
.. index:: Ceph Block Device; kernel module
.. important:: To use kernel module operations, you must have a running Ceph cluster.
Get a List of Images
====================
To mount a block device image, first return a list of the images. ::
rbd list
Map a Block Device
==================
Use ``rbd`` to map an image name to a kernel module. You must specify the
image name, the pool name, and the user name. ``rbd`` will load RBD kernel
module on your behalf if it's not already loaded. ::
sudo rbd map {pool-name}/{image-name} --id {user-name}
For example::
sudo rbd map rbd/myimage --id admin
If you use `cephx`_ authentication, you must also specify a secret. It may come
from a keyring or a file containing the secret. ::
sudo rbd map rbd/myimage --id admin --keyring /path/to/keyring
sudo rbd map rbd/myimage --id admin --keyfile /path/to/file
Show Mapped Block Devices
=========================
To show block device images mapped to kernel modules with the ``rbd`` command,
specify the ``showmapped`` option. ::
rbd showmapped
Unmapping a Block Device
========================
To unmap a block device image with the ``rbd`` command, specify the ``unmap``
option and the device name (i.e., by convention the same as the block device
image name). ::
sudo rbd unmap /dev/rbd/{poolname}/{imagename}
For example::
sudo rbd unmap /dev/rbd/rbd/foo
.. _cephx: ../../rados/operations/user-management/
|
