]>
Commit | Line | Data |
---|---|---|
7c673cae FG |
1 | ================== |
2 | Create a Cluster | |
3 | ================== | |
4 | ||
5 | The first step in using Ceph with ``ceph-deploy`` is to create a new Ceph | |
6 | cluster. A new Ceph cluster has: | |
7 | ||
8 | - A Ceph configuration file, and | |
9 | - A monitor keyring. | |
10 | ||
11 | The Ceph configuration file consists of at least: | |
12 | ||
9f95a23c | 13 | - Its own file system ID (``fsid``) |
7c673cae FG |
14 | - The initial monitor(s) hostname(s), and |
15 | - The initial monitor(s) and IP address(es). | |
16 | ||
17 | For additional details, see the `Monitor Configuration Reference`_. | |
18 | ||
19 | The ``ceph-deploy`` tool also creates a monitor keyring and populates it with a | |
20 | ``[mon.]`` key. For additional details, see the `Cephx Guide`_. | |
21 | ||
22 | ||
23 | Usage | |
24 | ----- | |
25 | ||
26 | To create a cluster with ``ceph-deploy``, use the ``new`` command and specify | |
27 | the host(s) that will be initial members of the monitor quorum. :: | |
28 | ||
29 | ceph-deploy new {host [host], ...} | |
30 | ||
31 | For example:: | |
32 | ||
33 | ceph-deploy new mon1.foo.com | |
34 | ceph-deploy new mon{1,2,3} | |
35 | ||
36 | The ``ceph-deploy`` utility will use DNS to resolve hostnames to IP | |
37 | addresses. The monitors will be named using the first component of | |
38 | the name (e.g., ``mon1`` above). It will add the specified host names | |
39 | to the Ceph configuration file. For additional details, execute:: | |
40 | ||
41 | ceph-deploy new -h | |
42 | ||
43 | ||
7c673cae FG |
44 | |
45 | .. _Monitor Configuration Reference: ../../configuration/mon-config-ref | |
46 | .. _Cephx Guide: ../../../dev/mon-bootstrap#secret-keys |