Chapter 3. Creating Ceph File Systems

download PDF

3.1. Prerequisites

To use the Ceph File System, you must have:

a working Ceph Storage Cluster
See the Installation Guide for Red Hat Enterprise Linux and Installation Guide for Ubuntu for details.
at least one Ceph Metadata Server
See Installing and Configuring Ceph Metadata Server (MDS) for details.
at least two pools; one for data and one for metadata

When configuring these pools, consider:

  • Using a higher replication level for the metadata pool, as any data loss in this pool can render the whole file system inaccessible.
  • Using storage with lower latency such as Solid-state Drive (SSD) disks for the metadata pool, because this directly affects the observed latency of file system operations on clients.

See the Pools chapter in the Storage Strategies guide for details on pools.

3.2. Creating Ceph File Systems

Before creating the Ceph File System, ensure that you have the ceph-common package installed and if not, install it.

  • On Red Hat Enterprise Linux:

    # yum install ceph-common
  • On Ubuntu:

    $ sudo apt-get install ceph-common

To create a Ceph File System:

ceph fs new <file_system_name> <metadata> <pool>

Specify the name of the new Ceph File System and the metadata and data pools, for example:

$ ceph fs new cephfs cephfs-metadata cephfs_data

Once the file system is created, the Ceph Metadata Server (MDS) enters to the active state:

$ ceph mds stat
e5: 1/1/1 up {0=a=up:active}

After creating the Ceph File System, mount it. See Mounting Ceph File Systems for details.


By default, only one Ceph File System can be created in a cluster. See Section 1.2, “Limitations” for details.

Red Hat logoGithubRedditYoutubeTwitter


Try, buy, & sell


About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.