More documentation on omrelp/imrelp #51
Description
Please provide a complete example, somewhere, of how to set up remote logging using RELP.
The documentation is somewhat piecemeal as it comes to the omrelp and imrelp modules. Documentation found on the web indicates that RELP is now the standard, yet there is nothing in the rsyslog docs themselves that indicates this. In particular, there is no obvious clarification whether omrelp is required on the sending/client side of remote logging if imrelp is being used on the server side.
Also, I see that my distro (devuan) does not install librelp0 by default. Since this library is, per rsyslog docs, a requirement for using omrelp and imrelp, clearly RELP cannot be enabled by default, at least on my distro. By carefully tracking down these various pieces of information, I conclude that to use readmode=2 of the imrelp module (reliably, if at all?) one needs to install librelp0 and explicitly configure omrelp and imrelp on the respective servers. (Can the paragraph mode even be used on the server, reliably or otherwise, if the sender is not using omrelp? Seems to me not, but without deep source code inspection, I am not entirely certain.)
It would be gratifying for the documentation to completely and holistically clarify this because I am not entirely sure I have arrived at the correct conclusion. A complete example illustrating the action on each side would be helpful, though maybe not necessary if the documentation were thorough enough.