.. ditaa::
+--------------+ +----------------+ +-------------+
- | Block Device | | Object Storage | | Ceph FS |
+ | Block Device | | Object Storage | | CephFS |
+--------------+ +----------------+ +-------------+
+--------------+ +----------------+ +-------------+
Device kernel object(s). This is done with the command-line tool ``rbd``.
-.. index:: Ceph FS; Ceph Filesystem; libcephfs; MDS; metadata server; ceph-mds
+.. index:: CephFS; Ceph Filesystem; libcephfs; MDS; metadata server; ceph-mds
.. _arch-cephfs:
Ceph Filesystem
---------------
-The Ceph Filesystem (Ceph FS) provides a POSIX-compliant filesystem as a
+The Ceph Filesystem (CephFS) provides a POSIX-compliant filesystem as a
service that is layered on top of the object-based Ceph Storage Cluster.
-Ceph FS files get mapped to objects that Ceph stores in the Ceph Storage
+CephFS files get mapped to objects that Ceph stores in the Ceph Storage
Cluster. Ceph Clients mount a CephFS filesystem as a kernel object or as
a Filesystem in User Space (FUSE).
+-----------------------+ +------------------------+
+---------------------------------------------------+
- | Ceph FS Library (libcephfs) |
+ | CephFS Library (libcephfs) |
+---------------------------------------------------+
+---------------------------------------------------+
the data means that the Ceph Filesystem can provide high performance services
without taxing the Ceph Storage Cluster.
-Ceph FS separates the metadata from the data, storing the metadata in the MDS,
+CephFS separates the metadata from the data, storing the metadata in the MDS,
and storing the file data in one or more objects in the Ceph Storage Cluster.
The Ceph filesystem aims for POSIX compatibility. ``ceph-mds`` can run as a
single process, or it can be distributed out to multiple physical machines,
-==========================================
- Mount Ceph FS in your File Systems Table
-==========================================
+========================================
+ Mount CephFS in your File Systems Table
+========================================
-If you mount Ceph FS in your file systems table, the Ceph file system will mount
+If you mount CephFS in your file systems table, the Ceph file system will mount
automatically on startup.
Kernel Driver
=============
-To mount Ceph FS in your file systems table as a kernel driver, add the
+To mount CephFS in your file systems table as a kernel driver, add the
following to ``/etc/fstab``::
{ipaddress}:{port}:/ {mount}/{mountpoint} {filesystem-name} [name=username,secret=secretkey|secretfile=/path/to/secretfile],[{mount.options}]
FUSE
====
-To mount Ceph FS in your file systems table as a filesystem in user space, add the
+To mount CephFS in your file systems table as a filesystem in user space, add the
following to ``/etc/fstab``::
#DEVICE PATH TYPE OPTIONS
-=========================
-Mount Ceph FS using FUSE
-=========================
+=======================
+Mount CephFS using FUSE
+=======================
Before mounting a Ceph File System in User Space (FUSE), ensure that the client
host has a copy of the Ceph configuration file and a keyring with CAPS for the
-======================================
- Mount Ceph FS with the Kernel Driver
-======================================
+====================================
+ Mount CephFS with the Kernel Driver
+====================================
To mount the Ceph file system you may use the ``mount`` command if you know the
monitor host IP address(es), or use the ``mount.ceph`` utility to resolve the
**ceph-fuse** is a FUSE (File system in USErspace) client for Ceph
distributed file system. It will mount a ceph file system specified
via the -m option or described by ceph.conf (see below) at the
-specific mount point. See `Mount Ceph FS using FUSE`_ for detailed
+specific mount point. See `Mount CephFS using FUSE`_ for detailed
information.
The file system can be unmounted with::
fusermount(8),
:doc:`ceph <ceph>`\(8)
-.. _Mount Ceph FS using FUSE: ../../../cephfs/fuse/
+.. _Mount CephFS using FUSE: ../../../cephfs/fuse/
Checking MDS Status
===================
-Metadata servers provide metadata services for Ceph FS. Metadata servers have
+Metadata servers provide metadata services for CephFS. Metadata servers have
two sets of states: ``up | down`` and ``active | inactive``. To ensure your
metadata servers are ``up`` and ``active``, execute the following::
`kernel modules`_, or to :abbr:`KVMs (kernel virtual machines)` such as `QEMU`_, and
cloud-based computing systems like `OpenStack`_ and `CloudStack`_ that rely on
libvirt and QEMU to integrate with Ceph block devices. You can use the same cluster
-to operate the `Ceph RADOS Gateway`_, the `Ceph FS filesystem`_, and Ceph block
+to operate the `Ceph RADOS Gateway`_, the `CephFS filesystem`_, and Ceph block
devices simultaneously.
.. important:: To use Ceph Block Devices, you must have access to a running
.. _OpenStack: ../rbd-openstack
.. _CloudStack: ../rbd-cloudstack
.. _Ceph RADOS Gateway: ../../radosgw/
-.. _Ceph FS filesystem: ../../cephfs/
+.. _CephFS filesystem: ../../cephfs/
-=====================
- Ceph FS Quick Start
-=====================
+===================
+ CephFS Quick Start
+===================
-To use the :term:`Ceph FS` Quick Start guide, you must have executed the
+To use the :term:`CephFS` Quick Start guide, you must have executed the
procedures in the `Storage Cluster Quick Start`_ guide first. Execute this quick
start on the Admin Host.
cat ceph.client.admin.keyring
-#. Copy the key of the user who will be using the mounted Ceph FS filesystem.
+#. Copy the key of the user who will be using the mounted CephFS filesystem.
It should look something like this::
[client.admin]
Kernel Driver
=============
-Mount Ceph FS as a kernel driver. ::
+Mount CephFS as a kernel driver. ::
sudo mkdir /mnt/mycephfs
sudo mount -t ceph {ip-address-of-monitor}:6789:/ /mnt/mycephfs
sudo mount -t ceph 192.168.0.1:6789:/ /mnt/mycephfs -o name=admin,secretfile=admin.secret
-.. note:: Mount the Ceph FS filesystem on the admin node,
+.. note:: Mount the CephFS filesystem on the admin node,
not the server node. See `FAQ`_ for details.
Filesystem in User Space (FUSE)
===============================
-Mount Ceph FS as a Filesystem in User Space (FUSE). ::
+Mount CephFS as a Filesystem in User Space (FUSE). ::
sudo mkdir ~/mycephfs
sudo ceph-fuse -m {ip-address-of-monitor}:6789 ~/mycephfs
Additional Information
======================
-See `Ceph FS`_ for additional information. Ceph FS is not quite as stable
+See `CephFS`_ for additional information. CephFS is not quite as stable
as the Ceph Block Device and Ceph Object Storage. See `Troubleshooting`_
if you encounter trouble.
.. _Storage Cluster Quick Start: ../quick-ceph-deploy
-.. _Ceph FS: ../../cephfs/
+.. _CephFS: ../../cephfs/
.. _FAQ: http://wiki.ceph.com/How_Can_I_Give_Ceph_a_Try
.. _Troubleshooting: ../../cephfs/troubleshooting
.. _OS Recommendations: ../os-recommendations