ceph/doc/mgr/hello.rst

hello world
===========

This is a simple module skeleton for documentation purposes.

Enabling
--------

The *hello* module is enabled with::

  ceph mgr module enable hello

To check that it is enabled, run::

  ceph mgr module ls

After editing the module file (found in ``src/pybind/mgr/hello/module.py``), you can see changes by running::

  ceph mgr module disable hello
  ceph mgr module enable hello

or::

  init-ceph restart mgr

To execute the module, run::

  ceph hello

The log is found at::

  build/out/mgr.x.log


Documenting
-----------

After adding a new mgr module/plugin, be sure to add its documentation to ``doc/mgr/plugin_name.rst``.
Also, add a link to your new plugin into ``doc/mgr/index.rst``.