install_evs.rst 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748
  1. Installing pagure's EventSource server
  2. ======================================
  3. Eventsource or Server Sent Events are messages sent from a server to a web
  4. browser. It allows one to refresh a page "live", ie, without the need to reload
  5. it entirely.
  6. Configure your system
  7. ---------------------
  8. The eventsource server is easy to set-up.
  9. * Install the required dependencies
  10. ::
  11. python-redis
  12. python-trollius
  13. python-trollius-redis
  14. .. note:: We ship a systemd unit file for pagure_milter but we welcome patches
  15. for scripts for other init systems.
  16. * Install the files of the SSE server as follow:
  17. +----------------------------------------+-----------------------------------------------------+
  18. | Source | Destination |
  19. +========================================+=====================================================+
  20. | ``ev-server/pagure-stream-server.py`` | ``/usr/libexec/pagure-ev/pagure-stream-server.py`` |
  21. +----------------------------------------+-----------------------------------------------------+
  22. | ``ev-server/pagure_ev.service`` | ``/etc/systemd/system/pagure_ev.service`` |
  23. +----------------------------------------+-----------------------------------------------------+
  24. The first file is the script of the SSE server itself.
  25. The second file is the systemd service file.
  26. * Finally, activate the service and ensure it's started upon boot:
  27. ::
  28. systemctl enable redis
  29. systemctl start redis
  30. systemctl enable pagure_ev
  31. systemctl start pagure_ev