Template:About Ceph
Ceph Cluster
A ceph cluster is a group of three or more systems that have been clustered together using the ceph storage technology. Ceph requires a minimum of three nodes to create a cluster which in turn establishes a quorum [1].
In QuantaStor, systems must first be Grid members before they can be added to, or create, a Ceph cluster. In the above diagram, the QuantaStor Grid is also the Ceph Cluster. Note that when the Ceph Cluster is initially created there is no storage associated with it (OSDs), only monitors.
Ceph Monitor
The Ceph Monitors form a paxos part-time parliment cluster for the management of cluster membership, configuration information, and state. Paxos is an algorithm (developed by Leslie Lamport in the late 80s) which uses a three-phase consensus protocol to ensure that cluster updates can be done in a fault-tolerant timely fashion even in the event of a node outage or node that is acting improperly. Ceph uses the algorithm so that the membership, configuration and state information is updated safely across the cluster in an efficient manner. Since the algorithm requires a quorum of nodes to agree on any given change an odd number of systems (three or more) are required for any given Ceph cluster deployment.
During initial Ceph cluster creation, QuantaStor will configure the first three systems to have active Ceph Monitor services. Configurations with more than 16 nodes should add at least two additional monitors. On configurations with more than 16 nodes two additional monitors should be setup can this can be done through the QuantaStor WebUI in the Scale-out Block & Object section.
Monitors startup automatically when the system starts. The status and health of monitors is monitored by QuantaStor then displayed in the WebUI. A minimum of two ceph monitors must be online at all times. As an example, in a three node configuration two of the three systems must be online for the storage to be online and available.
When a cluster is initially created, QuantaStor configures the first three systems to have active Ceph Monitor services running.
Ceph Object Storage Daemon / OSD
The Ceph Object Storage Daemon, known as the OSD, is a daemon process that reads and writes data, representing the actual data storage containers. When a client writes data to a Ceph based iSCSI/RBD block device, or via the S3/SWIFT gateway, the data is spread out across the OSDs in the cluster automatically.
QuantaStor Scale-out SAN with Ceph deployments must have at least 3x OSDs per system, making 9x OSDs total the minimum number of Daemons. Each OSD is attached to one XFS-based QuantaStor Storage Pool. QuantaStor requires the use of XFS Storage Pools for use as Ceph OSDs due to extended attribute requirements. Each OSD is also assigned one Journal Device.
Because the creation of OSDs, the underlying Storage Pools for them, and their associated Journal devices is a multi-step process QuantaStor has a Multi-OSD Create configuration dialog which does all of these configuration steps for an entire cluster in a single dialog. This makes it easy to setup even hyper-scale Ceph deployments in minutes.
Ceph Journals and Journal Devices

It is important to note that, in ceph, writes are never cached. This is good because it ensures that every write is written to stable media (the disk devices) before Ceph acknowledges to a client that the write is complete. This prevents corruption in the event of a power outage because data that is being written out is only complete once it is on stable media. The cluster will work around the bad node until it comes back online and re-synchronizes with the cluster.
The trade-off to never caching is a loss of write performance. HDDs are slow due to rotational latency and seek times for spinning disk are high. The solution is to log every write to fast persistent solid state media (SSD, NVMe, X Point, NVDIMM, etc), called a journal device.
Using a fast journal device allows Ceph to initially write data to the journal, returning a "write complete" to the client much faster, even though the data has not yet been written to the slower HDDs. By retaining the data on the journal until it can be written to the HDDs, the data can be recovered automatically in the event of a power outage. Ceph retains a copy of the data in RAM and uses that to write lazily to the HDD. This means that the journal device is only used as a write log and will never be read from unless a recovery scenario is encountered.
Because the journal device will encounter high, sustained write-pressure, Datacenter grade or Enterprise grade SSDs must be used for Ceph journal devices. Desktop SSD devices are fast for a few seconds, but their write performance drops significantly. Additionally they wear out very quickly. As a result OSNEXUS will not certify the use of desktop SSDs in any production deployment of any kind. By example, we tested with a popular desktop SSD device which produces 600MB/sec but performance quickly dropped to just 30MB/sec after just a few seconds of sustained write load.
QuantaStor's WebUI will allow any block device in the Physical Disks section to be selected as a Journal Device, but only Enterprise SSD, NVMe or PCI SSD devices with high performance and write-endurance should be used.
Once selected to be a Journal Device, QuantaStor will automatically partition it up into 8 journal partitions. One journal is required for each Object Storage Daemon (OSD), meaning each Journal Device can support up to 8 OSDs. For a system with 20x OSDs one would want at least 3x SSDs, but in reality the use of additional SSDs would be recommended in order to ensure even distribution of load across Journal Devices.
A hardware RAID controller can be used to combine multiple SSDs (using RAID5) to make a high-performance fault-tolerant journal. We recommend using PCI SSD, NVMe devices, or multiple SSDs in RAID5 or a pair in RAID1. A dedicated RAID controller can also be used to create a RAID5 based SSD journal devices to further boost performance. Again, each of these logical or physical devices are sliced up into 8x journal partitions so that up to 8x OSDs can be supported per Journal Device.
Placement Group / PG
Ceph uses Placement Groups to implement mirroring (or erasure coding) of data across OSDs according to the configured replica count for a given Ceph Pool.
The user specifies how many copies of the data must be maintained by the Ceph Pool during creation to ensure a level of high-availability and fault-tolerance, usually 2 copies when using hardware RAID or 3 copies when no disk-level RAID is present. Ceph in turn creates a series of Placement Groups as directed by QuantaStor to be associated with the Ceph Pool.
One way to think of the placement groups is as logical mini-mirrors in a RAID10 configuration. Each placement group is either a two-way, three-way or 4-way mirror across 2, 3, or 4 OSDs respectively. Because the number of OSDs will grow over the life of the cluster, QuantaStor allocates a large number of PGs for each Ceph Pool to evenly distribute data across the OSDs and accommodate future expansion as OSDs are added. In this way Ceph can very efficiently re-organize and re-balance PGs to mirror across new OSDs as they are added.
The PG count stays fixed as OSDs are added but a maintenance command can be run to increase the PG count for a Ceph Pool if the PG count gets low relative to the number of OSDs in the Pool. In general the PG count should be roughly 10x to 100x higher than the OSD count for a given Ceph Pool.
Similar to RAID10 technology, a PG can become degraded if one or more copies is offline. Ceph is designed to keep running in a degraded state when copies are lost, so whole systems can go offline without any disruption to clients accessing the cluster. Ceph also automatically repairs and updates the offline PGs once the offline OSDs come back online online and if the offline system doesn't come back online in a reasonable amount of time the cluster will auto heal itself by adjusting the PGs, swapping out the offline OSDs with good online OSDs. In this way a cluster will automatically heal a Ceph Pool back to 100% automatically (ie, return to full/complete copy count).
Also, if an OSD is explicitly removed, the PGs referencing it are re-balanced and re-organized across the remaining OSDs to recover the system back to 100% health on the remaining OSDs.
Object Storage Group (QuantaStor specific)
S3/SWIFT object storage gateways require the creation and management of several Ceph Pools, which together represent a region+zone for the storage of objects and buckets. QuantaStor groups all the Ceph Pools used to manage a given object storage configuration into a Object Storage Group. QuantaStor also automatically deploys and manages Ceph S3/SWIFT Object Gateways on all systems in the cluster that were selected as gateway nodes when the Object Storage Group was created. Additional gateways can be deployed on new or existing nodes at any time.
Note that Object Storage Groups are a QuantaStor construct so you won't find documentation about it in general Ceph documentation.
User Object Access Entries
Access to object storage via S3 and SWIFT requires a Access Key and a Secret Key just like with Amazon S3 storage. Each User Object Access Entry is a Access Key + Secret Key pair which is associated with a Ceph Cluster and Object Storage Group. You must allocate at least one User Object Access Entry to read/write buckets and objects to an Object Storage Group via the Ceph S3/SWIFT Gateway.
Ceph CRUSH Maps and Resource Domains
Ceph supports the ability to organize placement groups, which provide data mirroring across OSDs, so that high-availability and fault-tolerance can be maintained even in the event of a rack or site outage. By defining failure-domains, such as a Rack of systems, a Site, or Building, a map can be created so that Placement Groups are intelligently laid out to ensure high-availability despite the outage of one or more failure-domains, depending on the level of redundancy.
This intelligent map is called the Ceph CRUSH map, standing for Controlled, Scalable, Decentralized Placement of Replicated Data, and it defines how to mirror data in the Ceph cluster to ensure optimal performance and availability.
Creating CRUSH maps manually can be a complex process, so QuantaStor creates and configures CRUSH maps automatically, saving a large degree of administrative overhead. To facilitate automatic CRUSH map management, detail regarding where each QuantaStor system is deployed must be provided. This is done by creating a tree of Resource Domains via the WebUI (or via CLI/REST APIs) to organize the systems in a given QuantaStor Grid into Racks, Sites, and Buildings. QuantaStor uses this information to automatically generate an optimal CRUSH map when pools are provisioned, ensuring optimal performance and high-availability.
Custom CRUSH map changes can still be made to adjust the map after the pool(s) are created and OSNEXUS provides consulting services to meet special requirements. Resource Domains are a QuantaStor construct so you will not find mention of them in general Ceph documentation, but they map closely to the CRUSH bucket hierarchy.