1CEPH-OSD(8)                          Ceph                          CEPH-OSD(8)
2
3
4

NAME

6       ceph-osd - ceph object storage daemon
7

SYNOPSIS

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 ] [ --osdspec-affinity ]
11
12

DESCRIPTION

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

OPTIONS

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
93       --osdspec-affinity
94              Set  an  affinity to a certain OSDSpec.  This option can only be
95              used in conjunction with --mkfs.
96

AVAILABILITY

98       ceph-osd is part of Ceph, a massively scalable,  open-source,  distrib‐
99       uted  storage  system.  Please  refer  to  the  Ceph  documentation  at
100       https://docs.ceph.com for more information.
101

SEE ALSO

103       ceph(8), ceph-mds(8), ceph-mon(8), ceph-authtool(8)
104
106       2010-2022, Inktank Storage, Inc. and contributors. Licensed under  Cre‐
107       ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
108
109
110
111
112dev                              Oct 18, 2022                      CEPH-OSD(8)
Impressum