Blame doc/install_pagure_logcom.rst

Pierre-Yves Chibon 45a893
Installing pagure-logcom
Pierre-Yves Chibon 45a893
========================
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
pagure-logcom is the service that updates the log table in the database
Pierre-Yves Chibon 45a893
for every commit made to the main branch of a repository allowing to build
Pierre-Yves Chibon 45a893
the calendar heatmap presented on every user's page.
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
Configure your system
Pierre-Yves Chibon 45a893
---------------------
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
* Install the required dependencies
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
::
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
    python-redis
Pierre-Yves Chibon 45a893
    python-trollius
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
.. note:: We ship a systemd unit file for pagure_logcom but we welcome patches
Pierre-Yves Chibon 45a893
        for scripts for other init systems.
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
* Install the files of pagure-loadjon as follow:
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
+-----------------------------------------------+-------------------------------------------------------+
Pierre-Yves Chibon 45a893
|              Source                           |                   Destination                         |
Pierre-Yves Chibon 45a893
+===============================================+=======================================================+
Pierre-Yves Chibon 45a893
| ``pagure-logcom/pagure_logcom_server.py``     | ``/usr/libexec/pagure-logcom/pagure_logcom_server.py``|
Pierre-Yves Chibon 45a893
+--------------------------------------------------+----------------------------------------------------+
Pierre-Yves Chibon 45a893
| ``pagure-logcom/pagure_logcom.service``       | ``/etc/systemd/system/pagure_logcom.service``         |
Pierre-Yves Chibon 45a893
+-----------------------------------------------+-------------------------------------------------------+
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
The first file is the pagure-logcom service itself, triggered by the git
Pierre-Yves Chibon 45a893
hook (shipped with pagure itself) and logging the commits into the database.
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
The second file is the systemd service file.
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
* Activate the service and ensure it's started upon boot:
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
::
Pierre-Yves Chibon 45a893
Pierre-Yves Chibon 45a893
    systemctl enable redis
Pierre-Yves Chibon 45a893
    systemctl start redis
Pierre-Yves Chibon 45a893
    systemctl enable pagure_logcom
Pierre-Yves Chibon 45a893
    systemctl start pagure_logcom