ceph/doc/mgr/orchestrator_cli.rst
John Spray d903240eed mgr: add Orchestrator.available method + CLI
The CLI `status` method tells you what backend
is selected, and also gives the backend
an opportunity to complain if something
seems wrong with its configuration.

Signed-off-by: John Spray <john.spray@redhat.com>
2018-08-06 16:22:30 +01:00

62 lines
1.2 KiB
ReStructuredText

.. _orchestrator-cli-module:
================
Orchestrator CLI
================
This module provides a command line interface (CLI) to orchestrator
modules (ceph-mgr modules which interface with external orchestation services)
Configuration
=============
You can select the orchestrator module to use with the ``set backend`` command:
::
ceph orchestrator set backend <module>
For example, to enable the Rook orchestrator module and use it with the CLI:
::
ceph mgr module enable orchestrator_cli
ceph mgr module enable rook
ceph orchestrator set backend rook
You can then check backend is properly configured:
::
ceph orchestrator status
Usage
=====
Print a list of discovered devices, grouped by node and optionally
filtered to a particular node:
::
orchestrator device ls [node]
Query the status of a particular service (mon, osd, mds, rgw). For OSDs
the id is the numeric OSD ID, for MDS services it is the filesystem name:
::
orchestrator service status <type> <id>
Create a service. For an OSD, the "what" is <node>:<device>, where the
device naming should match what was reported in ``device ls``. For an MDS
service, the "what" is the filesystem name:
::
orchestrator service add <type> <what>