Create a Cluster

The first step in using Ceph with ceph-deploy is to create a new Cephcluster. A new Ceph cluster has:

  • A Ceph configuration file, and

  • A monitor keyring.

The Ceph configuration file consists of at least:

  • Its own file system ID (fsid)

  • The initial monitor(s) hostname(s), and

  • The initial monitor(s) and IP address(es).

For additional details, see the Monitor Configuration Reference.

The ceph-deploy tool also creates a monitor keyring and populates it with a[mon.] key. For additional details, see the Cephx Guide.

Usage

To create a cluster with ceph-deploy, use the new command and specifythe host(s) that will be initial members of the monitor quorum.

  1. ceph-deploy new {host [host], ...}

For example:

  1. ceph-deploy new mon1.foo.com
  2. ceph-deploy new mon{1,2,3}

The ceph-deploy utility will use DNS to resolve hostnames to IPaddresses. The monitors will be named using the first component ofthe name (e.g., mon1 above). It will add the specified host namesto the Ceph configuration file. For additional details, execute:

  1. ceph-deploy new -h