From: Loic Dachary Date: Thu, 16 Oct 2014 06:26:16 +0000 (-0700) Subject: doc: update injectargs syntax X-Git-Tag: v0.88~44^2~1 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=a566610aaa82d65b48e300559e5435df4a939ca8;p=ceph.git doc: update injectargs syntax Modify the examples to use the simpler syntax, not involving -- or grouping with quotes. Signed-off-by: Loic Dachary --- diff --git a/doc/rados/configuration/ceph-conf.rst b/doc/rados/configuration/ceph-conf.rst index e9725bf848b7..cca254de2697 100644 --- a/doc/rados/configuration/ceph-conf.rst +++ b/doc/rados/configuration/ceph-conf.rst @@ -426,19 +426,19 @@ useful for increasing/decreasing logging output, enabling/disabling debug settings, and even for runtime optimization. The following reflects runtime configuration usage:: - ceph {daemon-type} tell {id or *} injectargs '--{name} {value} [--{name} {value}]' + ceph tell {daemon-type}.{id or *} injectargs --{name} {value} [--{name} {value}] Replace ``{daemon-type}`` with one of ``osd``, ``mon`` or ``mds``. You may apply the runtime setting to all daemons of a particular type with ``*``, or specify a specific daemon's ID (i.e., its number or letter). For example, to increase debug logging for a ``ceph-osd`` daemon named ``osd.0``, execute the following:: - ceph osd tell 0 injectargs '--debug-osd 20 --debug-ms 1' + ceph tell osd.0 injectargs --debug-osd 20 --debug-ms 1 In your ``ceph.conf`` file, you may use spaces when specifying a setting name. When specifying a setting name on the command line, ensure that you use an underscore or hyphen (``_`` or ``-``) between -terms (e.g., ``debug osd`` becomes ``debug-osd``). +terms (e.g., ``debug osd`` becomes ``--debug-osd``). Viewing a Configuration at Runtime diff --git a/doc/rados/operations/control.rst b/doc/rados/operations/control.rst index 0e7237e8fc7b..495cc82bf526 100644 --- a/doc/rados/operations/control.rst +++ b/doc/rados/operations/control.rst @@ -292,11 +292,11 @@ MDS Subsystem Change configuration parameters on a running mds. :: - ceph mds tell {mds-id} injectargs '--{switch} {value} [--{switch} {value}]' + ceph tell mds.{mds-id} injectargs --{switch} {value} [--{switch} {value}] Example:: - ceph mds tell 0 injectargs '--debug_ms 1 --debug_mds 10' + ceph tell mds.0 injectargs --debug_ms 1 --debug_mds 10 Enables debug messages. :: diff --git a/doc/rados/operations/crush-map.rst b/doc/rados/operations/crush-map.rst index 55658d62c59b..d871f620191e 100644 --- a/doc/rados/operations/crush-map.rst +++ b/doc/rados/operations/crush-map.rst @@ -1079,7 +1079,7 @@ the default as of v0.73). To make this warning go away, you have two options: For the change to take effect, you will need to restart the monitors, or apply the option to running monitors with:: - ceph -- tell mon.\* injectargs --no-mon-warn-on-legacy-crush-tunables + ceph tell mon.\* injectargs --no-mon-warn-on-legacy-crush-tunables A few important points diff --git a/doc/rados/operations/monitoring.rst b/doc/rados/operations/monitoring.rst index 25c9837e5b6c..c269e99bf89d 100644 --- a/doc/rados/operations/monitoring.rst +++ b/doc/rados/operations/monitoring.rst @@ -277,7 +277,7 @@ The admin socket command enables you to show and set your configuration at runtime. See `Viewing a Configuration at Runtime`_ for details. Additionally, you can set configuration values at runtime directly (i.e., the -admin socket bypasses the monitor, unlike ``ceph {daemon-type} tell {id} +admin socket bypasses the monitor, unlike ``ceph tell {daemon-type}.{id} injectargs``, which relies on the monitor but doesn't require you to login directly to the host in question ). diff --git a/doc/rados/troubleshooting/log-and-debug.rst b/doc/rados/troubleshooting/log-and-debug.rst index faac6b35914d..4a332a9001dd 100644 --- a/doc/rados/troubleshooting/log-and-debug.rst +++ b/doc/rados/troubleshooting/log-and-debug.rst @@ -40,14 +40,14 @@ in to a host with a running daemon and execute the following:: To activate Ceph's debugging output (*i.e.*, ``dout()``) at runtime, use the ``ceph tell`` command to inject arguments into the runtime configuration:: - ceph tell {daemon-type}.{daemon id or *} injectargs '--{name} {value} [--{name} {value}]' + ceph tell {daemon-type}.{daemon id or *} injectargs --{name} {value} [--{name} {value}] Replace ``{daemon-type}`` with one of ``osd``, ``mon`` or ``mds``. You may apply the runtime setting to all daemons of a particular type with ``*``, or specify a specific daemon's ID (i.e., its number or letter). For example, to increase debug logging for a ``ceph-osd`` daemon named ``osd.0``, execute the following:: - ceph tell osd.0 injectargs '--debug-osd 0/5' + ceph tell osd.0 injectargs --debug-osd 0/5 The ``ceph tell`` command goes through the monitors. If you cannot bind to the monitor, you can still make the change by logging into the host of the daemon diff --git a/doc/rados/troubleshooting/troubleshooting-mon.rst b/doc/rados/troubleshooting/troubleshooting-mon.rst index d0807b7b4cea..c753de3ca249 100644 --- a/doc/rados/troubleshooting/troubleshooting-mon.rst +++ b/doc/rados/troubleshooting/troubleshooting-mon.rst @@ -438,11 +438,11 @@ You have quorum Either inject the debug option into the monitor you want to debug:: - ceph tell mon.FOO injectargs '--debug_mon 10/10' + ceph tell mon.FOO injectargs --debug_mon 10/10 or into all monitors at once:: - ceph tell mon.* injectargs '--debug_mon 10/10' + ceph tell mon.* injectargs --debug_mon 10/10 No quourm