summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJan Dittberner <jandd@cacert.org>2021-01-02 07:39:08 +0100
committerJan Dittberner <jandd@cacert.org>2021-01-02 07:39:08 +0100
commitb33b9cb9d847b449364cb9cac9a9c45feb8233da (patch)
tree151a470b3eb20aa9db7c8057b24dd494df410f51 /docs
parentd5577492672ea48be71a3111df92cea8d3ca6e1f (diff)
downloadcacert-infradocs-b33b9cb9d847b449364cb9cac9a9c45feb8233da.tar.gz
cacert-infradocs-b33b9cb9d847b449364cb9cac9a9c45feb8233da.tar.xz
cacert-infradocs-b33b9cb9d847b449364cb9cac9a9c45feb8233da.zip
Update documentation for ircserver
- upgrade to 10.7 - document systemd units instead of init scripts - use cacertgit to link to votebot repository
Diffstat (limited to 'docs')
-rw-r--r--docs/systems/ircserver.rst79
1 files changed, 33 insertions, 46 deletions
diff --git a/docs/systems/ircserver.rst b/docs/systems/ircserver.rst
index 7e7ddfb..229cd74 100644
--- a/docs/systems/ircserver.rst
+++ b/docs/systems/ircserver.rst
@@ -108,10 +108,10 @@ Operating System
----------------
.. index::
- single: Debian GNU/Linux; Stretch
- single: Debian GNU/Linux; 9.4
+ single: Debian GNU/Linux; Buster
+ single: Debian GNU/Linux; 10.7
-* Debian GNU/Linux 9.4
+* Debian GNU/Linux 10.7
Services
========
@@ -168,54 +168,43 @@ Running services
single: atheme-services
single: cron
single: exim
+ single: icinga2
single: inspircd
single: kiwiirc
single: nginx
- single: nrpe
single: openssh
single: puppet agent
single: rsyslog
single: votebot
-+--------------------+--------------------+----------------------------------------+
-| Service | Usage | Start mechanism |
-+====================+====================+========================================+
-| atheme-services | IRC services | init script |
-| | | :file:`/etc/init.d/atheme-services` |
-+--------------------+--------------------+----------------------------------------+
-| cron | job scheduler | init script :file:`/etc/init.d/cron` |
-+--------------------+--------------------+----------------------------------------+
-| Exim | SMTP server for | init script |
-| | local mail | :file:`/etc/init.d/exim4` |
-| | submission | |
-+--------------------+--------------------+----------------------------------------+
-| inspircd | IRC daemon | init script |
-| | | :file:`/etc/init.d/inspircd` |
-+--------------------+--------------------+----------------------------------------+
-| kiwiirc | IRC web client | start script |
-| | | :file:`/home/kiwiirc/KiwiIRC/kiwi` |
-| | | started by user kiwiirc |
-+--------------------+--------------------+----------------------------------------+
-| nginx | Reverse proxy for | init script |
-| | kiwiirc | :file:`/etc/init.d/nginx` |
-+--------------------+--------------------+----------------------------------------+
-| Nagios NRPE server | remote monitoring | init script |
-| | service queried by | :file:`/etc/init.d/nagios-nrpe-server` |
-| | :doc:`monitor` | |
-+--------------------+--------------------+----------------------------------------+
-| openssh server | ssh daemon for | init script :file:`/etc/init.d/ssh` |
-| | remote | |
-| | administration | |
-+--------------------+--------------------+----------------------------------------+
-| Puppet agent | configuration | init script |
-| | management agent | :file:`/etc/init.d/puppet` |
-+--------------------+--------------------+----------------------------------------+
-| rsyslog | syslog daemon | init script |
-| | | :file:`/etc/init.d/syslog` |
-+--------------------+--------------------+----------------------------------------+
-| votebot | CAcert vote bot | init script (spring-boot) |
-| | | :file:`/etc/init.d/cacert-votebot` |
-+--------------------+--------------------+----------------------------------------+
++-----------------+---------------------------+------------------------------------------+
+| Service | Usage | Start mechanism |
++=================+===========================+==========================================+
+| atheme-services | IRC services | systemd unit ``atheme-services.service`` |
++-----------------+---------------------------+------------------------------------------+
+| cron | job scheduler | systemd unit ``cron.service`` |
++-----------------+---------------------------+------------------------------------------+
+| Exim | SMTP server for | systemd unit ``exim4.service`` |
+| | local mail submission | |
++-----------------+---------------------------+------------------------------------------+
+| icinga2 | Icinga2 monitoring agent | systemd unit ``icinga2.service`` |
++-----------------+---------------------------+------------------------------------------+
+| inspircd | IRC daemon | systemd unit ``inspircd.service`` |
++-----------------+---------------------------+------------------------------------------+
+| kiwiirc | IRC web client | systemd unit ``kiwiirc.service`` |
++-----------------+---------------------------+------------------------------------------+
+| nginx | Reverse proxy for kiwiirc | systemd unit ``nginx.service`` |
++-----------------+---------------------------+------------------------------------------+
+| openssh server | ssh daemon for | systemd unit ``ssh.service`` |
+| | remote administration | |
++-----------------+---------------------------+------------------------------------------+
+| Puppet agent | configuration | systemd unit ``puppet.service`` |
+| | management agent | |
++-----------------+---------------------------+------------------------------------------+
+| rsyslog | syslog daemon | systemd unit ``rsyslog.service`` |
++-----------------+---------------------------+------------------------------------------+
+| votebot | CAcert vote bot | systemd unit ``cacert-votebot.service`` |
++-----------------+---------------------------+------------------------------------------+
Connected Systems
-----------------
@@ -269,7 +258,7 @@ init.
.. topic:: Votebot
The vote bot is a Java based IRC bot developed at
- https://git.cacert.org/gitweb/?p=cacert-votebot.git and built at
+ :cacertgit:`cacert-votebot` and built at
https://jenkins.cacert.org/job/cacert-votebot/. The bot is started
automatically via its init script.
@@ -284,8 +273,6 @@ local loopback interface and Internet access is provided by an nginx reverse
proxy that also provides https connectivity. NodeJS and npm have been installed
from Debian packages.
-.. todo:: setup init script for kiwiirc
-
Risk assessments on critical packages
-------------------------------------