Component Startup
=================

.. note::

   All project executables are installed with a version suffix not mentioned here in the documentation.
   E.g. :program:`rsb-host-monitor` actually needs to be called as ``rsb-host-monitor2.0``.

To start all components of the monitoring pipeline, follow these steps (assuming that :ref:`RSB <rsb:rsb>` has been configured properly):

#. Start the timeseries database backend:

   InfluxDB

      .. code-block:: bash

         $prefix/opt/influxdb/influxdb -config=/path/to/influxdb-config.toml

   Graphite

      #. Start the :program:`carbon` daemon:

         .. code-block:: bash

            $GRAPHITE_ROOT/bin/carbon-cache.py --nodaemon

      #. Start the webapp:

         .. code-block:: bash

            $GRAPHITE_ROOT/bin/run-graphite-devel-server.py --port=${PORT}

         Decide on a port you want to use.

#. Start one :ref:`rsb-host-monitor` instance per computer.
   Pass the intended :term:`measurement cycle time` to the :option:`--cycle <rsb-host-monitor -c>` option.
   A typical call might be:

   .. code-block:: bash

      rsb-host-monitor --cycle 5000

#. Start :ref:`rsb-process-monitor` instances.
   Depending on how you automate your application startup, you can opt to start one instance per process or use a single instance fir multiple processes on a host.
   The processes to monitor are specified via positional arguments or the :option:`--pid <rsb-process-monitor --pid>` option.
   A typical call might be:

   .. code-block:: bash

      rsb-process-monitor --cycle 5000  -s -r -i -f -u -n a_name $PID

#. Start a single :ref:`rsbperfmon-db-adapter` instance.
   A typical call will be:

   .. code-block:: bash

      rsbperfmon-db-adapter -a -b {graphite|influxdb}

   Use the appropriate backend for the :option:`-b <rsbperfmon-db-adapter -b>` option.
   Additional flags for the connection to the backend might be required.

#. Start the Grafana Dashboard server:

   .. code-block:: bash

      $GRAFANA_PREFIX/bin/grafana-server -config=your-config.ini -homepath=$GRAFANA_PREFIX

   This assumes that ``GRAFANA_PREFIX`` points to the directory containing the Grafana installation.

#. Open the Grafana dashboard in your browser and select one of the previously imported dashboards configuration (see :ref:`configuration-grafana`).