Baguette/infrastructure-doc
3
1
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

minor netlibre doc expansion

Browse Source
This commit is contained in:
Philippe Pittoli 2024-11-24 09:57:48 +01:00
parent e15f41c1c9
commit e32c4ec8e9
1 changed files with 21 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
man/netlibre.8
View File

@ -60,6 +60,18 @@ The deployment was done on two machines:
(custom) (custom)
.Nd the dns manager daemon .Nd the dns manager daemon
.br .br
.Nm mailer
(custom)
.Nd a simple executable to send template mails
.br
.Nm watchdog scripts
(custom)
.Nd to sync directories between primary and secondary NS
.br
.Nm smtp server
(such as OpenSMTPd)
.Nd to send registration and password recovery emails
.br
.Nm inotifywait .Nm inotifywait
.Nd wait for changes on the file system (used for domain sync) .Nd wait for changes on the file system (used for domain sync)
.br .br
@ -81,12 +93,16 @@ This tool prevents powerdns to start since it works on the same port (53).
.SUBTITLE run powerdns .SUBTITLE run powerdns
.cmd ubuntu $ systemctl restart pdns .cmd ubuntu $ systemctl restart pdns
.cmd alpine $ service pdns restart .cmd alpine $ service pdns restart
NOTE : powerdns documentation on alpine is basically just a lot of SQL files in /usr/share/doc/pdns/
.SUBTITLE install inotify-tools .SUBTITLE install inotify-tools
.cmd ubuntu $ apt install inotify-tools .cmd ubuntu $ apt install inotify-tools
.cmd alpine $ apk add inotify-tools .cmd alpine $ apk add inotify-tools
NOTE : powerdns documentation on alpine is basically just a lot of SQL files in /usr/share/doc/pdns/ .SUBTITLE install an smtp server
.cmd alpine $ apk add opensmtpd
Actual configuration of the smtp (+SPF, DKIM, etc.) should be taken care of.
An example of OpenSMTPd configuration is in this repository (infrastructure-doc).
.TITLE TESTING TOOLS .TITLE TESTING TOOLS
.SUBTITLE testing port 53 .SUBTITLE testing port 53
@ -104,6 +120,7 @@ NOTE : powerdns documentation on alpine is basically just a lot of SQL files in
Well, there isn't much configuration since both powerdns instances just run "as is" with the bind backend that is filled on-the-fly. Well, there isn't much configuration since both powerdns instances just run "as is" with the bind backend that is filled on-the-fly.
.SUBTITLE watchdogs in a few words .SUBTITLE watchdogs in a few words
A watchdog is (in this context) a command watching a directory.
These commands should run either on the primary or secondary name server. These commands should run either on the primary or secondary name server.
They are distributed with They are distributed with
.cmdname dnsmanagerd .cmdname dnsmanagerd
@ -129,4 +146,7 @@ directly?
.\" writes bind9 files in a temporary directory before being sent to /var/powerdns. .\" writes bind9 files in a temporary directory before being sent to /var/powerdns.
.\" This enables to first load old zones (they are still served as before) then to update them on-the-fly once the users make changes on the new website. .\" This enables to first load old zones (they are still served as before) then to update them on-the-fly once the users make changes on the new website.
TODO: expand the documentation
.TITLE LIMITATIONS .TITLE LIMITATIONS
TODO: expand the documentation