SMB file services

You can access CephFS using the SMB protocol through the SMB suite and samba-container images that are managed by Ceph. The SMB manager module provides an interface for deploying and controlling clusters of SMB services and managing SMB shares.

With the SMB module, a cluster acts as a logical management unit that corresponds to one or more managed SMB services. A cluster can implement high-availability mechanisms or operate without them.

CephFS provides two types of management commands for SMB.

Imperative commands: Imperative commands provide direct instructions to create, print, or remove SMB clusters and shares. These commands allow users to manage resources through explicit commands.
Declarative commands: Declarative commands enable users to define and apply resource configurations in JSON or YAML format, allowing for consistent management of SMB clusters and shares.

Note: Ceph managed SMB supports only SMB2 and SMB3 versions of the protocol. SMB1 (CIFS) is not supported.

For more information about SMB protocol on CephFS see, SMB cluster and share management.