doc: Minor improvements to Ceph FS landing page.

Signed-off-by: John Wilkins <john.wilkins@inktank.com>
This commit is contained in:
John Wilkins 2013-05-17 15:56:59 -07:00
parent 69e2cbef6a
commit decf342c26

View File

@ -2,23 +2,82 @@
Ceph FS
=========
The Ceph FS file system is a POSIX-compliant file system that uses a RADOS
cluster to store its data. Ceph FS uses the same RADOS object storage device
system as RADOS block devices and RADOS object stores such as the RADOS gateway
with its S3 and Swift APIs, or native bindings. Using Ceph FS requires at least
one metadata server in your ``ceph.conf`` configuration file.
The :term:`Ceph FS` file system is a POSIX-compliant file system that uses a
Ceph Storage Cluster to store its data. Ceph FS uses the same Ceph Storage
Cluster system as Ceph Block Devices, Ceph Object Storage with its S3 and Swift
APIs, or native bindings (librados).
.. ditaa::
+-----------------------+ +------------------------+
| CephFS Kernel Object | | CephFS FUSE |
+-----------------------+ +------------------------+
+---------------------------------------------------+
| Ceph FS Library (libcephfs) |
+---------------------------------------------------+
+---------------------------------------------------+
| Ceph Storage Cluster Protocol (librados) |
+---------------------------------------------------+
+---------------+ +---------------+ +---------------+
| OSDs | | MDSs | | Monitors |
+---------------+ +---------------+ +---------------+
Using Ceph FS requires at least one :term:`Ceph Metadata Server` in your
Ceph Storage Cluster.
.. raw:: html
<style type="text/css">div.body h3{margin:5px 0px 0px 0px;}</style>
<table cellpadding="10"><colgroup><col width="33%"><col width="33%"><col width="33%"></colgroup><tbody valign="top"><tr><td><h3>Step 1: Metadata Server</h3>
To run Ceph FS, you must have a running Ceph Storage Cluster with at least
one :term:`Ceph Metadata Server` running.
.. toctree::
:maxdepth: 1
Mount Ceph FS<kernel>
Mount Ceph FS as FUSE <fuse>
Mount Ceph FS in fstab <fstab>
Using Ceph with Hadoop <hadoop>
Add/Remove MDS <../../rados/deployment/ceph-deploy-mds>
MDS Configuration <mds-config-ref>
Journaler Configuration <journaler>
Manpage ceph-mds <../../man/8/ceph-mds>
.. raw:: html
</td><td><h3>Step 2: Mount Ceph FS</h3>
Once you have a healthy Ceph Storage Cluster with at least
one Ceph Metadata Server, you may mount your Ceph FS filesystem.
Ensure that you client has network connectivity and the proper
authentication keyring.
.. toctree::
:maxdepth: 1
Mount Ceph FS <kernel>
Mount Ceph FS as FUSE <fuse>
Mount Ceph FS in fstab <fstab>
Manpage cephfs <../../man/8/cephfs>
Manpage ceph-fuse <../../man/8/ceph-fuse>
Manpage ceph-mds <../../man/8/ceph-mds>
Manpage mount.ceph <../../man/8/mount.ceph>
.. raw:: html
</td><td><h3>Additional Details</h3>
.. toctree::
:maxdepth: 1
Using Ceph with Hadoop <hadoop>
libcephfs <../../api/libcephfs-java/>
.. raw:: html
</td></tr></tbody></table>