MKCEPHFS(8) Ceph MKCEPHFS(8)NAMEmkcephfs - create a ceph file system
SYNOPSISmkcephfs [ -c ceph.conf ] [ --mkbtrfs ] [ -a, --all-hosts [ -k
/path/to/admin.keyring ] ]
DESCRIPTIONmkcephfs is used to create an empty Ceph file system, possibly spanning
multiple hosts. The ceph.conf file describes the composition of the
entire Ceph cluster, including which hosts are participating, which
daemons run where, and which paths are used to store file system data
or metadata.
The mkcephfs tool can be used in two ways. If -a is used, it will use
ssh and scp to connect to remote hosts on your behalf and do the setup
of the entire cluster. This is the easiest solution, but can also be
inconvenient (if you don't have ssh to connect without prompting for
passwords) or slow (if you have a large cluster).
Alternatively, you can run each setup phase manually. First, you need
to prepare a monmap that will be shared by each node:
# prepare
master# mkdir /tmp/foo
master# mkcephfs-c /etc/ceph/ceph.conf \
--prepare-monmap -d /tmp/foo
Share the /tmp/foo directory with other nodes in whatever way is conve‐
nient for you. On each OSD and MDS node:
osdnode# mkcephfs--init-local-daemons osd -d /tmp/foo
mdsnode# mkcephfs--init-local-daemons mds -d /tmp/foo
Collect the contents of the /tmp/foo directories back onto a single
node, and then:
master# mkcephfs--prepare-mon -d /tmp/foo
Finally, distribute /tmp/foo to all monitor nodes and, on each of those
nodes:
monnode# mkcephfs--init-local-daemons mon -d /tmp/foo
OPTIONS-a, --allhosts
Performs the necessary initialization steps on all hosts in the
cluster, executing commands via SSH.
-c ceph.conf, --conf=ceph.conf
Use the given conf file instead of the default
/etc/ceph/ceph.conf.
-k /path/to/keyring
When -a is used, we can specify a location to copy the
client.admin keyring, which is used to administer the cluster.
The default is /etc/ceph/keyring (or whatever is specified in
the config file).
--mkbtrfs
Create and mount the any btrfs file systems specified in the
ceph.conf for OSD data storage using mkfs.btrfs. The "btrfs
devs" and (if it differs from "osd data") "btrfs path" options
must be defined.
--no-copy-conf
By default, mkcephfs with -a will copy the new configuration to
/etc/ceph/ceph.conf on each node in the cluster. This option
disables that behavior.
SUBCOMMANDS
The sub-commands performed during cluster setup can be run individually
with
--prepare-monmap -d dir -c ceph.conf
Create an initial monmap with a random fsid/uuid and store it
and the ceph.conf in dir.
--init-local-daemons type -d dir
Initialize any daemons of type type on the local host using the
monmap in dir. For types osd and mds, the resulting authentica‐
tion keys will be placed in dir. For type mon, the initial data
files generated by --prepare-mon (below) are expected in dir.
--prepare-mon -d dir
Prepare the initial monitor data based on the monmap, OSD, and
MDS authentication keys collected in dir, and put the result in
dir.
AVAILABILITYmkcephfs is part of the Ceph distributed file system. Please refer to
the Ceph wiki at http://ceph.newdream.net/wiki for more information.
SEE ALSOceph(8), monmaptool(8), osdmaptool(8), crushtool(8)COPYRIGHT
2011, New Dream Network
dev October 17, 2011 MKCEPHFS(8)