Single-node deployment

  • Uses MicroCeph
  • Works on a workstation or VM
  • Suitable for testing and development

These installation instructions use MicroCeph - Ceph in a snap. MicroCeph is a pure upstream Ceph distribution designed for small scale and edge deployments, which can be installed and maintained with minimal knowledge and effort.

You will need a multi-core processor and at least 8GiB of memory and 100GB of disk space. MicroCeph has been tested on x86-based physical and virtual machines running Ubuntu 22.04 LTS.

  1. To get started, install the MicroCeph snap with the following command on each node to be used in the cluster: 

    sudo snap install microceph

  2. Then bootstrap the cluster:

    sudo microceph cluster bootstrap

  3. Check the cluster status with the following command:

    sudo microceph.ceph status

    Here you should see that there is a single node in the cluster.

  4. To use MicroCeph as a single node, the default CRUSH rules need to be modified: 

    sudo microceph.ceph osd crush rule rm replicated_rule
    sudo microceph.ceph osd crush rule create-replicated single default osd

  5. Next, add some disks that will be used as OSDs:

    sudo microceph disk add /dev/sd[x] --wipe

    Repeat for each disk you would like to use as an OSD on that node, and additionally on the other nodes in the cluster. Cluster status can be verified using: 

    sudo microceph.ceph status
    sudo microceph.ceph osd status