1CEPH-OSD(8) Ceph CEPH-OSD(8)
2
3
4
6 ceph-osd - ceph object storage daemon
7
9 ceph-osd -i osdnum [ --osd-data datapath ] [ --osd-journal
10 journal ] [ --mkfs ] [ --mkjournal ] [--flush-journal] [--check-allows-journal] [--check-wants-journal] [--check-needs-journal] [ --mkkey ]
11
12
14 ceph-osd is the object storage daemon for the Ceph distributed file
15 system. It is responsible for storing objects on a local file system
16 and providing access to them over the network.
17
18 The datapath argument should be a directory on a xfs file system where
19 the object data resides. The journal is optional, and is only useful
20 performance-wise when it resides on a different disk than datapath with
21 low latency (ideally, an NVRAM device).
22
24 -f, --foreground
25 Foreground: do not daemonize after startup (run in foreground).
26 Do not generate a pid file. Useful when run via ceph-run(8).
27
28 -d Debug mode: like -f, but also send all log output to stderr.
29
30 --setuser userorgid
31 Set uid after starting. If a username is specified, the user
32 record is looked up to get a uid and a gid, and the gid is also
33 set as well, unless --setgroup is also specified.
34
35 --setgroup grouporgid
36 Set gid after starting. If a group name is specified the group
37 record is looked up to get a gid.
38
39 --osd-data osddata
40 Use object store at osddata.
41
42 --osd-journal journal
43 Journal updates to journal.
44
45 --check-wants-journal
46 Check whether a journal is desired.
47
48 --check-allows-journal
49 Check whether a journal is allowed.
50
51 --check-needs-journal
52 Check whether a journal is required.
53
54 --mkfs Create an empty object repository. This also initializes the
55 journal (if one is defined).
56
57 --mkkey
58 Generate a new secret key. This is normally used in combination
59 with --mkfs as it is more convenient than generating a key by
60 hand with ceph-authtool(8).
61
62 --mkjournal
63 Create a new journal file to match an existing object reposi‐
64 tory. This is useful if the journal device or file is wiped out
65 due to a disk or file system failure.
66
67 --flush-journal
68 Flush the journal to permanent store. This runs in the fore‐
69 ground so you know when it's completed. This can be useful if
70 you want to resize the journal or need to otherwise destroy it:
71 this guarantees you won't lose data.
72
73 --get-cluster-fsid
74 Print the cluster fsid (uuid) and exit.
75
76 --get-osd-fsid
77 Print the OSD's fsid and exit. The OSD's uuid is generated at
78 --mkfs time and is thus unique to a particular instantiation of
79 this OSD.
80
81 --get-journal-fsid
82 Print the journal's uuid. The journal fsid is set to match the
83 OSD fsid at --mkfs time.
84
85 -c ceph.conf, --conf=ceph.conf
86 Use ceph.conf configuration file instead of the default
87 /etc/ceph/ceph.conf for runtime configuration options.
88
89 -m monaddress[:port]
90 Connect to specified monitor (instead of looking through
91 ceph.conf).
92
94 ceph-osd is part of Ceph, a massively scalable, open-source, distrib‐
95 uted storage system. Please refer to the Ceph documentation at
96 http://ceph.com/docs for more information.
97
99 ceph(8), ceph-mds(8), ceph-mon(8), ceph-authtool(8)
100
102 2010-2019, Inktank Storage, Inc. and contributors. Licensed under Cre‐
103 ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
104
105
106
107
108dev Dec 10, 2019 CEPH-OSD(8)