OS Manuals

/usr/bin/ceph

Common utilities to mount and interact with a Ceph storage cluster

From ceph-fips-19-common 19.2.7-r4 (enterprise-packages), captured 2026-11-08 by running ceph --help (exit 1). permalink

Error initializing cluster client: ObjectNotFound('RADOS object not found (error calling conf_read_file)')

 General usage:
 ==============
usage: ceph [-h] [-c CEPHCONF] [-i INPUT_FILE] [-o OUTPUT_FILE] [--setuser SETUSER]
            [--setgroup SETGROUP] [--id CLIENT_ID] [--name CLIENT_NAME] [--cluster CLUSTER]
            [--admin-daemon ADMIN_SOCKET] [-s] [-w] [--watch-debug] [--watch-info] [--watch-sec]
            [--watch-warn] [--watch-error] [-W WATCH_CHANNEL] [--version] [--verbose] [--concise]
            [--daemon-output-file DAEMON_OUTPUT_FILE]
            [-f {json,json-pretty,xml,xml-pretty,plain,yaml}] [--connect-timeout CLUSTER_TIMEOUT]
            [--block] [--period PERIOD]

Ceph administration tool

options:
  -h, --help            request mon help
  -c CEPHCONF, --conf CEPHCONF
                        ceph configuration file
  -i INPUT_FILE, --in-file INPUT_FILE
                        input file, or "-" for stdin
  -o OUTPUT_FILE, --out-file OUTPUT_FILE
                        output file, or "-" for stdout
  --setuser SETUSER     set user file permission
  --setgroup SETGROUP   set group file permission
  --id CLIENT_ID, --user CLIENT_ID
                        client id for authentication
  --name CLIENT_NAME, -n CLIENT_NAME
                        client name for authentication
  --cluster CLUSTER     cluster name
  --admin-daemon ADMIN_SOCKET
                        submit admin-socket command (e.g. "help" fora list of available commands)
  -s, --status          show cluster status
  -w, --watch           watch live cluster changes
  --watch-debug         watch debug events
  --watch-info          watch info events
  --watch-sec           watch security events
  --watch-warn          watch warn events
  --watch-error         watch error events
  -W WATCH_CHANNEL, --watch-channel WATCH_CHANNEL
                        watch live cluster changes on a specific channel (e.g., cluster, audit,
                        cephadm, or '*' for all)
  --version, -v         display version
  --verbose             make verbose
  --concise             make less verbose
  --daemon-output-file DAEMON_OUTPUT_FILE
                        output file location local to the daemon for JSON produced by tell
                        commands
  -f {json,json-pretty,xml,xml-pretty,plain,yaml}, --format {json,json-pretty,xml,xml-pretty,plain,yaml}
                        Note: yaml is only valid for orch commands
  --connect-timeout CLUSTER_TIMEOUT
                        set a timeout for connecting to the cluster
  --block               block until completion (scrub and deep-scrub only)
  --period PERIOD, -p PERIOD
                        polling period, default 1.0 second (for polling commands only)

 Local commands:
 ===============

ping <mon.id>           Send simple presence/life test to a mon
                        <mon.id> may be 'mon.*' for all mons
daemon {type.id|path} <cmd>
                        Same as --admin-daemon, but auto-find admin socket
daemonperf {type.id | path} [stat-pats] [priority] [<interval>] [<count>]
daemonperf {type.id | path} list|ls [stat-pats] [priority]
                        Get selected perf stats from daemon/admin socket
                        Optional shell-glob comma-delim match string stat-pats
                        Optional selection priority (can abbreviate name):
                         critical, interesting, useful, noninteresting, debug
                        List shows a table of all available stats
                        Run <count> times (default forever),
                         once per <interval> seconds (default 1)
Options (27)
OptionDescriptionSource
-h, --helprequest mon helphelp
--setuser SETUSERwill apply the appropriate user ownership to the file specified by the option '-o'.help + man
--setgroup SETGROUPwill apply the appropriate group ownership to the file specified by the option '-o'.help + man
--cluster CLUSTERName of the Ceph cluster.help + man
--admin-daemon ADMIN_SOCKETsubmit admin-socket command (e.g. "help" fora list of available commands)help + man
-s, --statusShow cluster status.help + man
-w, --watchWatch live cluster changes on the default 'cluster' channelhelp + man
--watch-debugWatch debug events.help + man
--watch-infoWatch info events.help + man
--watch-secWatch security events.help + man
--watch-warnWatch warning events.help + man
--watch-errorWatch error events.help + man
--version, -vDisplay version.help + man
--verboseMake verbose.help + man
--conciseMake less verbose.help + man
--daemon-output-file DAEMON_OUTPUT_FILEWhen using --format=json|json-pretty, you may specify a file name on the host running the daemon to stream output to.help + man
--connect-timeout CLUSTER_TIMEOUTSet a timeout for connecting to the cluster.help + man
--blockblock until completion (scrub and deep-scrub only)help + man
-i, --in-file infilewill specify an input file to be passed along as a payload with the command to the monitor cluster. (in the manual page but not in --help)man
-o, --out-file outfilewill write any payload returned by the monitor cluster with its reply to outfile. (in the manual page but not in --help)man
-c, --conf ceph.confUse ceph.conf configuration file instead of the default /etc/ceph/ceph.conf to determine monitor addresses during startup. (in the manual page but not in --help)man
--id, --user CLIENT_IDClient id for authentication. (in the manual page but not in --help)man
--name, -n CLIENT_NAMEClient name for authentication. (in the manual page but not in --help)man
--admin-socket ADMIN_SOCKET_NOPEYou probably mean --admin-daemon (in the manual page but not in --help)man
-W, --watch-channelWatch live cluster changes on any channel (cluster, audit, cephadm, or for all) (in the manual page but not in --help)man
-f, --format jsonFormat of output. (in the manual page but not in --help)man
--no-increasing (in the manual page but not in --help)man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.