Commit Graph

217 Commits

Author SHA1 Message Date
Sage Weil
572a942f8f mon: 'auth list' -> 'auth ls'
Signed-off-by: Sage Weil <sage@redhat.com>
2017-07-19 12:33:14 -04:00
Kefu Chai
bd36f13163 doc: fix the links to http://ceph.com/docs
they should point to http://docs.ceph.com/docs/master/.. instead

Fixes: http://tracker.ceph.com/issues/19090
Signed-off-by: Kefu Chai <kchai@redhat.com>
2017-03-15 16:40:07 +08:00
Jason Dillaman
3af83a87be doc: update RBD mirroring instructions for pool demotion/promotion
Signed-off-by: Jason Dillaman <dillaman@redhat.com>
2017-03-08 12:02:27 -05:00
Sage Weil
321f8e66e5 Merge pull request #13400 from shinobu-x/wip-18840
doc: Modify Configuring Cinder section

Reviewed-by: Sage Weil <sage@redhat.com>
2017-02-13 18:40:34 -06:00
Michael Eischer
877245e69e doc: Fixes parameter name in rbd configuration on openstack havana/icehouse
The documentation for using rbd together with openstack havana/icehouse
states that the parameter libvirt_disk_cachemodes should be added to
the nova.conf file. However, this is the only parameter that has no
legacy name with a 'libvirt_' prefix. (See
https://github.com/openstack/nova/blob/icehouse-eol/nova/virt/libvirt/driver.py#L252
for the configuration option)
Thus the configured disk_cachemodes were not applied, defaulting to
no caching.

Fixes: #17978
Signed-off-by: Michael Eischer <michael.eischer@fau.de>
2017-02-13 21:10:56 +01:00
Shinobu Kinjo
fb419b63e1 Doc: Modify Configuring Cinder section
doc/rbd/rbd-openstack.rst: Add ``volume_backend_name`` in description of
cinder.conf

Fixes: http://tracker.ceph.com/issues/18840
Signed-off-by: Shinobu Kinjo <shinobu@redhat.com>
2017-02-14 03:40:35 +09:00
Marc Koderer
6229edfec4 DOC: Mention corresponding section in nova.conf
rbd_user and rbd_secret_uuid are part of the libvirt configuration.

Signed-off-by: Marc Koderer <marc@koderer.com>
2016-12-20 14:52:34 +01:00
Sébastien Han
9af76d2626 doc: update cinder key permissions for mitaka
OpenStack Mitaka introduced the support of RBD snapshots while taking a
snapshot of a Nova instance. For this to work we need to grant write
access to the Glance pool to the Cinder key.

Signed-off-by: Sébastien Han <seb@redhat.com>
2016-12-08 15:21:21 +01:00
Sébastien Han
def903a7ef doc: openstack glance mitaka uses show_multiple_locations
As of the Mitaka release show_image_direct_url is not needed, but
instead show_multiple_locations should be used.
Adding the necessary guidance for Mitaka release.

Signed-off-by: Sébastien Han <seb@redhat.com>
2016-11-17 10:57:36 +01:00
Uday Mullangi
7c7395c1cc doc: Fixing the broken hyperlinks by pointing to correct documentation.
Signed-off-by: umullangi@walmartlabs.com
2016-11-03 14:55:12 +05:30
Jason Dillaman
cb897a4e98 doc: clarify QEMU rbd cache settings
http://tracker.ceph.com/issues/17665
Signed-off-by: Jason Dillaman <dillaman@redhat.com>
2016-10-21 14:55:05 -04:00
Jason Dillaman
4e05cbf7e6 doc: added rbdmap man page to RBD restructured index
Signed-off-by: Jason Dillaman <dillaman@redhat.com>
2016-08-15 14:10:27 -04:00
Jason Dillaman
593558f27b doc: update rbd glance configuration notes
Signed-off-by: Jason Dillaman <dillaman@redhat.com>
2016-08-10 09:48:46 -04:00
Ken Dreyer
8e8d55b797 doc: describe libvirt client logging
Describe how to configure logging and the admin socket for debugging RBD
libvirt clients.

Thanks to Jason Dillman <jdillama@redhat.com> on ceph-devel for this
information.

Signed-off-by: Ken Dreyer <kdreyer@redhat.com>
2016-08-04 12:30:24 -06:00
runsisi
9ec13bb344 doc: fix typo for rbd-mirroring
Signed-off-by: runsisi <runsisi@zte.com.cn>
2016-06-13 10:05:11 +08:00
Mykola Golub
4381e341c4 doc: update mirroring guide to include pool/image status commands
Fixes: http://tracker.ceph.com/issues/15746
Signed-off-by: Mykola Golub <mgolub@mirantis.com>
2016-05-14 20:06:46 +03:00
Mykola Golub
ddd6345f8f doc: fixup: "rbd-mirror daemon" instead of "rbd-daemon"
Signed-off-by: Mykola Golub <mgolub@mirantis.com>
2016-05-12 11:11:55 +03:00
luokexue
6d69636ee9 doc: Fixes all "Qemu" to "QEMU"
Signed-off-by: luokexue <luo.kexue@zte.com.cn>
2016-04-16 11:42:19 +08:00
Sage Weil
61c4c1c99b doc: list ext4 last
Signed-off-by: Sage Weil <sage@redhat.com>
2016-04-12 08:48:25 -04:00
John Wilkins
45219e0e2a Fixed ceph-common install.
Fixes: #15438

Signed-off-by: John Wilkins <jowilkin@redhat.com>
2016-04-11 09:54:02 -07:00
Sage Weil
cd3385b59f Merge pull request #8308 from wido/cloudstack-docs
doc: Updated CloudStack RBD documentation
2016-03-28 08:28:45 -04:00
scienceluo
b3930c51ff Fixes headline different font size and type 2016-03-28 14:10:28 +08:00
Wido den Hollander
a4e63b5182 doc: Updated CloudStack RBD documentation
Signed-off-by: Wido den Hollander <wido@42on.com>
2016-03-25 12:06:37 +01:00
Jason Dillaman
9d2d090e5c doc: initial draft of RBD mirroring admin documentation
Fixes: #15041

Signed-off-by: Jason Dillaman <dillaman@redhat.com>
2016-03-16 17:51:43 -04:00
RustShen
5fe3ff3f09 Modifications to rbd-openstack.rst
Original configuration is not working

'enabled_backends' should be changed accordingly

Signed-off-by: RustShen <rustinpeace@163.com>

Update rbd-openstack.rst
2016-03-10 14:31:34 +08:00
Yehua
777564c870 doc:adding "--allow-shrink" in decreasing the size of the rbd block to distinguish from the increasing option
In the original file, the increasing and decreaing of the size of the rbd block shares the same option:
    "rbd resize --size 2048 foo".
However, it is not proper, as the "--allow-shrink" needs to be added while decreasing the size of the rbd block.
As a result, it is necessary to make a distinguish between these two options as follows:
    "rbd resize --size 2048 foo (to increase)"
    "rbd resize --size 2048 foo --allow-shrink (to decrease)"

Signed-off-by: Yehua <chen.yehua@h3c.com>
2015-12-23 13:13:04 +08:00
Nilamdyuti Goswami
c36d73eedb doc: Modified a note section in rbd-snapshot doc.
Elaborates the note section a bit more as to why stopping I/O before
taking a snapshot is recommended and how to do it.

Signed-off-by: Nilamdyuti Goswami <ngoswami@redhat.com>
2015-12-13 01:23:30 +05:30
Yunchuan Wen
2c7cc532a8 add rbd-nbd man page reference
Signed-off-by: Yunchuan Wen <yunchuan.wen@kylin-cloud.com>
2015-12-02 11:29:30 +08:00
Ilya Dryomov
3fbcf5e265 doc: krbd supports clones since 3.10
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-07-31 19:50:58 +03:00
Ilya Dryomov
76989cc4ae doc: use spec syntax in rbd docs
Use spec syntax instead of --pool, --image and --snap to hopefully push
people towards the former.

Signed-off-by: Ilya Dryomov <idryomov@gmail.com>
2015-07-27 12:22:04 +03:00
Josh Durgin
3203efd1fc Merge pull request #4848 from leseb/doc-openstack-kilo
doc: update openstack and rgw keystone

Reviewed-by: Abhishek Lekshmanan <abhishek.lekshmanan@gmail.com>
Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2015-06-19 07:14:05 -07:00
Loic Dachary
67343f614f Merge pull request #5011 from robin974/master
doc: Fixes a missing dot

Reviewed-by: Loic Dachary <ldachary@redhat.com>
2015-06-18 17:14:41 +02:00
robin974
f105fdc255 doc: Fixes a missing dot
Fixes: #12072

Signed-off-by: Robin Tang <robintang974@gmail.com>
2015-06-18 16:43:45 +02:00
Jean-Rémi Deveaux
b10adf6a4f doc: Unify ID format
Fixes: #12071

Signed-off-by: Jean-Rémi Deveaux <jeanremi.deveaux@gmail.com>
2015-06-18 16:26:08 +02:00
Sébastien Han
d38cd63d26 doc: update openstack and rgw keystone
Update the OpenStack doc with more options, recommendations and best
practices.
Update the Keystone configuration for the Kilo release with Rados
Gateway.

Signed-off-by: Sébastien Han <seb@redhat.com>
2015-06-16 11:22:14 +02:00
Josh Durgin
db7ab8ba36 doc: add rbd cache settings to nova.conf
To actually get the benefit of writeback caching, qemu must be
aware of it so it pases flushes to rbd.  Since hammer rbd caching
is enabled by default, so add the nova option to make qemu aware
of it.

Signed-off-by: Josh Durgin <jdurgin@redhat.com>
2015-05-15 17:39:04 -07:00
Lee Revell
39d0d53ef6 doc: Clarify the requirement that the cinder user's key must be present on the compute nodes
Signed-off-by: Lee Revell <rlrevell@gmail.com>
2015-03-23 15:37:29 -04:00
Boris Ranto
46b45e3fc2 doc: fix python-ceph refs in docs
Signed-off-by: Boris Ranto <branto@redhat.com>
2015-02-24 18:30:18 -08:00
Frank Yu
b9be97f715 Doc: Fix the typo in doc/rbd/rados-rbd-cmds.rst
Fix the typo in doc/rbd/rados-rbd-cmds.rst, also add explanation/example
when creating an image without specifying pool.

Signed-off-by: Frank Yu <flyxiaoyu@gmail.com>
2015-01-21 16:47:41 +08:00
Josh Durgin
ac93c28522 Merge pull request #3396 from leseb/doc-openstack-fix-glance
doc: Fix OpenStack Glance configuration

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2015-01-19 08:38:37 -08:00
Frank Yu
4bd0894cc7 Doc: rbd-snapshot: Fix the typo
Signed-off-by: Frank Yu <flyxiaoyu@gmail.com>
2015-01-19 20:19:25 +08:00
Sébastien Han
d29aef5eb9 doc: Fix OpenStack Glance configuration
Glance has not completely moved to 'store' yet so we need to configure
the store in the DEFAULT section as well.

Fixes: #10478

Signed-off-by: Sébastien Han <sebastien.han@enovance.com>
2015-01-18 22:55:57 +01:00
Frank Yu
7c664fadff Doc: Fix the indentation in doc/rbd/rbd-snapshot.rst 2015-01-13 18:27:08 +08:00
John Wilkins
56dae09b9c doc: Reformatting on rbd replay doc.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-12-02 11:23:55 -08:00
John Wilkins
b8f6b5f77c doc: Added rbd-replay-many and restructured index.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-12-02 11:23:29 -08:00
Adam Crume
70e1a5dcbb doc: Document RBD Replay
Signed-off-by: Adam Crume <adamcrume@gmail.com>
2014-12-01 20:45:58 -08:00
Sébastien Han
35ae591404 doc: update the OpenStack glance configuration
Juno is now using a section for configuring the stores, so let's use it.
Put spaces between flag and value for clarity and readibility.

Signed-off-by: Sébastien Han <sebastien.han@enovance.com>
2014-11-14 09:21:09 +01:00
Josh Durgin
7695a61e89 Merge pull request #2892 from leseb/doc-juno-client-socket
doc: enable RBD cache and socket on OpenStack deployments

Reviewed-by: Josh Durgin <jdurgin@redhat.com>
2014-11-12 21:57:06 +01:00
Ken Dreyer
731ea68bfb doc: correct spelling of "fqdn"
The "fqdn" (fully-qualified domain name) was misspelled in a couple
places as fgdn". Use the correct spelling.

Signed-off-by: Ken Dreyer <kdreyer@redhat.com>
2014-11-12 09:53:43 -07:00
Sébastien Han
40994c918a doc: enable RBD cache and socket on OpenStack deployments
Enabling the RBD cache improves sequential IOs and the socket helps a
lot while troubleshooting. These 2 items are considered as best
practice for OpenStack deployments with Ceph.

Signed-off-by: Sébastien Han <sebastien.han@enovance.com>
2014-11-12 10:19:44 +01:00
John Wilkins
72fc262a09 doc: Update for OpenStack Juno.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-11-03 14:04:33 -08:00
Sébastien Han
c96fe592f2 doc: update RBD for Juno
This commit introduces some updates for the OpenStack Juno release. New
flags have been added, many trailing spaces were removed and a new
recommendation for Glance cache management has been added too.

Signed-off-by: Sébastien Han <sebastien.han@enovance.com>
2014-10-30 11:59:14 +01:00
Josh Durgin
a9f302da08 Merge remote-tracking branch 'origin/wip-rbd-readahead'
Reviewed-by: Josh Durgin <josh.durgin@inktank.com>

Conflicts:
	src/client/Fh.h
2014-10-16 14:33:42 -07:00
Wido den Hollander
3184a20733 doc: A couple of fixes to the CloudStack documentation 2014-10-01 17:02:29 +02:00
Adam Crume
ad45d8c454 librbd: Add read-ahead
Signed-off-by: Adam Crume <adamcrume@gmail.com>
2014-09-17 12:02:03 -07:00
Adam Crume
4809418752 doc: Change listed RBD cache defaults to actual defaults
Signed-off-by: Adam Crume <adamcrume@gmail.com>
2014-09-17 12:00:28 -07:00
John Wilkins
7dbf750fc5 doc: Updated authentication notes. Fixed syntax error.
Signed-off-by: John Wilkins <jowilki@redhat.com>
2014-09-11 10:50:22 -07:00
John Wilkins
d5777c4215 doc: Fixed broken links and clarified terms for new authentication docs.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-09-08 14:04:33 -07:00
John Wilkins
e2de11a844 doc: Minor cleanup.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-09-08 13:24:52 -07:00
John Wilkins
591a179540 doc: Added more robust usage example for uid and conf for QEMU.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-09-08 11:58:09 -07:00
John Wilkins
335c1f745e doc: Added rbd-replay-prep and rbd-replay manpages to block device TOC.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-08-28 18:07:51 -07:00
John Wilkins
bd6ba10042 doc: Clean up formatting, usage and removed duplicate section.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-07-09 17:18:03 -07:00
John Wilkins
7e3ad1a6fc Merge pull request #1905 from leseb/doc-rbd-icehouse
doc: rbd icehouse updated. Need to remove duplicate section.

Reviewed-by: John Wilkins <john.wilkins@inktank.com>
2014-07-09 16:27:52 -07:00
Abhishek Lekshmanan
e23ed9b7dc doc: fix a few typos in rbd docs
Signed-off-by: Abhishek Lekshmanan <abhishek.lekshmanan@gmail.com>
2014-07-09 10:58:59 +05:30
Sébastien Han
2eab1c1540 Update RBD doc for OpenStack
Some updates from Icehouse, best practice configurations and
explanations.

Signed-off-by: Sébastien Han <sebastien.han@enovance.com>

Conflicts:
	doc/rbd/rbd-openstack.rst
2014-06-12 15:32:25 +02:00
Ilya Dryomov
22bc886ac5 doc: fix 'rbd map' example
Looks like 'foo' is a leftover, see commit ea9fc87d89 ("doc: Removed
foo.  Apparently myimage was added and foo not removed.").

Signed-off-by: Ilya Dryomov <ilya.dryomov@inktank.com>
2014-06-03 14:32:21 +04:00
Josh Durgin
d71839a6cf doc: clarify openstack cow sentence
Missing subject, and now applies to disks in general.

Signed-off-by: Josh Durgin <josh.durgin@inktank.com>
2014-05-19 15:25:37 -07:00
Josh Durgin
0f7f1e842b doc: note cinder multi-backend restriction
Signed-off-by: Josh Durgin <josh.durgin@inktank.com>
2014-05-19 15:24:53 -07:00
Josh Durgin
e92f2d9fe0 doc: link to ephemeral rbd patches
These are necessary for using ephemeral rbd with Havana and Icehouse.

Signed-off-by: Josh Durgin <josh.durgin@inktank.com>
2014-05-19 15:14:29 -07:00
John Wilkins
03e3ccdd05 doc: Restored glance_api_version=2 setting.
Fixes: #8347

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-05-19 11:18:44 -07:00
John Wilkins
48337e0c7b doc: Omitted glance_api_version=2 to fix creating images from volumes.
Fixes: #8347
2014-05-13 23:20:36 -07:00
John Wilkins
17930a1e86 doc: Changed example to use virtio and put key usage into one line.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-05-13 23:18:50 -07:00
Ilya Dryomov
0c2b0fb8da doc: 'rbd showmapped' doesn't need privileges
No need to run 'rbd showmapped' with sudo.

Signed-off-by: Ilya Dryomov <ilya.dryomov@inktank.com>
2014-04-23 13:33:43 +04:00
Ilya Dryomov
4238ffdc49 doc: do not mention modprobe in rbd docs
rbd binary will load rbd.ko itself, with appropriate options.  Loading
it by hand with default options is undesirable.

Signed-off-by: Ilya Dryomov <ilya.dryomov@inktank.com>
2014-04-23 13:33:43 +04:00
Wido den Hollander
99d74eef82 doc: Add additional information over CloudStack and RBD 2014-04-11 13:59:31 +02:00
Wido den Hollander
a7057e1069 doc: Improve CloudStack RBD documentation 2014-03-04 22:24:36 +01:00
Florian Haas
9292cc215a doc: highlight that "raw" is the only useful RBD format for QEMU
Explain why people should be using the "raw" image format for RBD
volumes created for use by QEMU: using any other format adds only
overhead, but no extra value (since RBDs are also CoW and
thin-provisioned), plus the Qcow2 storage driver is not migration safe
when caching is enabled, whereas the RBD driver is.

Also, fix a minor glitch in the example qemu-img commands ("-f rbd"
and "-O rbd" should really be "-f raw" and "-O raw").

Finally, drop the "-f" option altogether on qemu-img commands where it
makes no sense (info and resize).

Signed-off-by: Florian Haas <florian@hastexo.com>
2014-02-11 00:30:07 +01:00
Wido den Hollander
03da035f76 docs: Typo in CloudStack user creation 2014-01-29 12:16:05 +01:00
Wido den Hollander
f0f4b8df81 docs: Improve CloudStack documentation.
Add a section about creating a CephX user for CloudStack.
2014-01-29 11:08:08 +01:00
John Wilkins
efb4cf6480 doc: Removed extraneous comment from snapshot text.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2014-01-09 10:26:28 -08:00
Sébastien Han
8b0b32bd1b doc: Add OpenStack Havana documentation
New features appeared during the Havana cycle.
This patch offers a general update of the doc.

Signed-off-by: Sébastien Han <sebastien.han@enovance.com>
2013-12-26 09:55:03 -08:00
rallred
0de0efa936 RBD Documentation and Example fixes for --image-format
- RBD Documentation, --image-format wrongly specified as --format in examples
 - RBD Documentation, better describe image format, to differentiate from --format

Reviewed-by: Josh Durgin <josh.durgin@inktank.com>
2013-11-18 18:12:38 -08:00
John Wilkins
a2090baf36 doc: Removed the Folsom reference.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-30 17:53:37 -07:00
John Wilkins
c9aa708ac5 doc: Restored show_image_direct and added a link to older versions.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-30 17:44:24 -07:00
John Wilkins
8193bad873 doc: Removed nova-volume, early Ceph references and Folsom references.
fixes: 5006

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-30 17:21:14 -07:00
Andrew Woodward
533626c7e0 Add Redhat init script option
Resolves: 6127
Signed-off-by: Andrew Woodward <awoodward@mirantis.com>
2013-10-17 17:23:04 -07:00
John Wilkins
cdd851b984 doc: Moved installation portion to the installation section.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-11 15:03:34 -07:00
John Wilkins
1dff92ba88 doc: Moved installation portion to the installation section.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-10-11 15:02:38 -07:00
Loic Dachary
768fb0a2a2 doc: fix openstack rbd installation command
This cannot work because client.volumes.key is not a command

   ssh {your-compute-host} client.volumes.key

replace with a tee to allow for copy/paste as well as using the

   cat client.volumes.key

in the following lines.

Signed-off-by: Loic Dachary <loic@dachary.org>
2013-10-08 12:07:00 +02:00
Travis Rhoden
6ebb486304 doc: Update syntax for rbd children
The docs were incorrectly usins 'rbd snap children' when the actual
command is 'rbd children'.

Signed-off-by: Travis Rhoden <trhoden@gmail.com>
2013-07-19 15:49:49 -04:00
John Wilkins
0d3517b2ed doc: Added index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:58:29 -07:00
John Wilkins
fb07f9df3d doc: Added index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:58:04 -07:00
John Wilkins
fd423fce43 doc: Added index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:57:48 -07:00
John Wilkins
8a5b276022 doc: Added index tag.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:57:31 -07:00
John Wilkins
d5dbc2f22b doc: Updated usage and index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:57:15 -07:00
John Wilkins
ceba9537a2 doc: Updated usage and index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:56:58 -07:00
John Wilkins
81d4f9d9e0 doc: Added introductory section. Updated usage. Index tags.
fixes: #3220

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:56:39 -07:00
John Wilkins
0b604fb441 doc: Index tags.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-06-14 16:54:52 -07:00
John Wilkins
eb35d739ae doc: Updated title to reflect glossary usage.
Signed-off-by: John Wilkins <john.wilkins@inktank.com>
2013-05-30 20:26:03 -07:00
Josh Durgin
e9c32b97aa doc: note openstack changes for Grizzly
These are just for the cinder configuration, nothing else changed.

Signed-off-by: Josh Durgin <josh.durgin@inktank.com>
2013-05-30 14:17:35 -07:00