summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorwrobell <wrobell@riseup.net>2026-06-16 20:17:41 +0100
committerNguyễn Gia Phong <cnx@loang.net>2026-07-26 15:23:19 +0900
commitce8df300216b308720903e6da9e01d246143b47f (patch)
tree6184790b895796fd3621bf753daddc4471449ee3 /doc
parent47b41dced835020f803dc56f52e949c94d2f7061 (diff)
services: Add epmd-service-type.
Add Erlang Port Mapper Daemon (epmd) service. Run the service on localhost by default. * gnu/services/high-availability.scm (<epmd-configuration>): New record. (epmd-service-type): New variable. * gnu/tests/high-availability.scm (run-epmd-test): New procedure. (%epmd-os, %tests-epmd): New variables. * doc/gnu.texi (High Availability Services): Document it. Merges: https://codeberg.org/guix/guix/pulls/9607 References: https://www.rabbitmq.com/blog/2024/12/18/epmd-public-exposure References: https://erlef.org/blog/eef/epmd-public-exposure Signed-off-by: Nguyễn Gia Phong <cnx@loang.net>
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi54
1 files changed, 49 insertions, 5 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 0db590aa5f7..12eca80ed3c 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -37746,16 +37746,60 @@ Extra configuration parameters as a list of strings.
37746@node High Availability Services 37746@node High Availability Services
37747@subsection High Availability Services 37747@subsection High Availability Services
37748 37748
37749@cindex Message broker 37749The @code{(gnu services high-availability)} module provides services for
37750@cindex Message streaming 37750Erlang Port Mapper Daemon (epmd) and RabbitMQ broker.
37751The @code{(gnu services high-availability)} module provides RabbitMQ 37751
37752message broker service. 37752@anchor{epmd}
37753@subsubheading Erlang Port Mapper Daemon (epmd)
37754
37755@defvar epmd-service-type
37756Service type for the
37757@uref{https://www.erlang.org/doc/apps/erts/epmd_cmd.html,Erlang Port Mapper
37758Daemon (epmd)}.
37759The value for this service type is a @code{<epmd-configuration>} record.
37760
37761Below is an example configuration:
37762
37763@lisp
37764(service epmd-service-type)
37765@end lisp
37766@end defvar
37767
37768@c %start of fragment
37769
37770@deftp {Data Type} epmd-configuration
37771Available @code{epmd-configuration} fields are:
37772
37773@table @asis
37774@item @code{user} (default: @code{"epmd"}) (type: string)
37775The user running epmd.
37776
37777@item @code{group} (default: @code{"epmd"}) (type: string)
37778The user group running epmd.
37779
37780@item @code{address} (default: @code{("127.0.0.1" "::1")}) (type: list-of-strings)
37781List of addresses for epmd to listen on. Set it to false (@code{#f}) to
37782listen on all available addresses. Note that epmd cannot start on
37783@code{"0.0.0.0"} address.
37784
37785@item @code{port} (default: @code{4369}) (type: integer)
37786Default port for epmd to listen on.
37787
37788@end table
37789
37790@end deftp
37791
37792
37793@c %end of fragment
37753 37794
37754@anchor{RabbitMQ} 37795@anchor{RabbitMQ}
37755@subsubheading RabbitMQ 37796@subsubheading RabbitMQ
37756 37797
37798@cindex Message broker
37799@cindex Message streaming
37800
37757@defvar rabbitmq-service-type 37801@defvar rabbitmq-service-type
37758Service type for the @uref{https://www.rabbitmq.com/,RabbitMQ} web server. 37802Service type for the @uref{https://www.rabbitmq.com/,RabbitMQ} server.
37759The value for this service type is a @code{<rabbitmq-configuration>} record. 37803The value for this service type is a @code{<rabbitmq-configuration>} record.
37760 37804
37761A simple example configuration is given below. 37805A simple example configuration is given below.