Erlang epmd官方文档中文翻译

本文含epmd简介及官方文档之翻译，文档地址 http://erlang.org/doc/man/epmd.html
翻译时的版本 R19.1

中英文水平都不咋地，不通顺处海涵，就酱。

简介

Erlang分布式系统中节点是通过节点名字互相连接的，节点名字为NAME@IP_ADDRESS格式。

epmd是分布式erlang中比较重要的模块。集群中每台机器都有一个epmd进程，这些进程端口号都用同一个端口号（默认4396端口）。所有节点启动的时候都会连接到本机对应的epmd进程，它记录了本机所有相关的节点。远程节点知道IP_ADDRESS就可以连接到远程epmd，再通过epmd可以根据节点名字NAME获取对应节点的实际网络地址，完成节点间互联。

翻译

epmd - Erlang Port Mapper Daemon

命令：
epmd [-d|-debug] [DbgExtra...] [-port No] [-daemon] [-relaxed_command_check]
启动epmd
epmd [-d|-debug] [-port No] [-names|-kill|-stop Name]
与正在运行的epmd交互

epmd相当于存在于分布式erlang系统中所有的主机上的一个域名服务器。每个Erlang节点启动的时候都会有一个节点名字，并且从宿主操作系统内核获得一个地址。节点名字和地址会发送给本地的epmd进程。在TCP/IP环境中，这个地址由ip地址和端口号组成。节点名字是一个atom，格式为Name@Host。epmd进程的作用就是记录节点名字对应哪个地址并进行映射。

TCP/IP环境的epmd进程其实只记录节点名字的Name部分，Host（@后面的部分）在连接epmd进程的时候就隐含在了节点名字里面。因此，erlang网络需要一个稳定的不出错的TCP名字服务才能正常运行。

启动epmd：
  在使用erl命令启动分布式节点的时候，如果没有epmd在运行，则会自动启动一个epmd。自动启动的话，需要用到一些环境变量来修改epmd进程的运行参数。详见下文中的 环境变量 一段。

如果没有指定-daemon参数，epmd会像一个普通程序一样运行在控制终端。一般来说，它应该作为daemon进程启动。

常规的启动参数在下文 常规参数 中详细说明。

DbgExtra参数在下文 DbgExtra 参数中详细说明。

与正在运行的epmd交互：
  与运行中的epmd交互最初是用来debug的。各类请求在下文 交互参数 中详细说明。

Regular 参数

这些参数是用在启动epmd的时候用到的。一般来说epmd是在使用erl命令时自动启动的（如果之前没启动过），但是也可以在开机的时候启动。

-address List
  让epmd仅监听逗号分隔的IP地址列表和回环地址（回环地址是默认添加到列表后面的，如果没有特别申明的话）。也可以通过设置环境变量ERL_EPMD_ADDRESS来控制，详见下文 环境变量 部分。

-port No
  让epmd监听指定的TCP端口，而不是默认的4369端口。也可以通过设置环境变量ERL_EPMD_PORT来控制，详见下文 环境变量 部分。

-d | -debug
  启用debug输出。-d参数指定得越多，就会有越多的debug输出（不能超出特定上限）。这个参数在epmd不作为daemon进程启动的时候非常有用。

-daemon
  以后台运行方式启动epmd。如果支持syslog日志且正确配置的话，日志会写入syslog中。如果epmd守护进程在开机的时候启动，这个参数一定会用到。使用erl命令自动启动epmd时也会用到。

-relaxed_command_check
  启用relaxed command checking（通常是为了向后兼容）。会有如下影响：
    如果启用该参数，epmd进程能在本地被类似epmd -kill参数杀死，不管有没有活跃的节点注册。而正常来说，epmd -kill命令只能杀死节点数据库为空的进程。
    epmd -stop命令（以及能通过erl_interface/ei指定的其他信号）正常来说是被无视的，因为它可能导致两个同名节点同时存在。节点只需要关闭与epmd的连接就能注销，所以stop命令仅仅debug的时候被用到。
启用relaxed command checking可以强制注销活跃的节点。
Relaxed command checking参数也能通过在启动前修改环境变量ERL_EPMD_RELAXED_COMMAND_CHECK控制。

DbgExtra 参数

这些参数仅用于debug或测试环境下的epmd客户端。他们不能在正常环境中使用。
-packet_timeout Seconds
  设置epmd超时关闭连接的超时时间。默认60秒。

-delay_accept Seconds
  可以在epmd收到连接请求和接受连接中间插入延时，来模拟繁忙的服务器。

-delay_write Seconds
  在回复消息发送前插入延时，同样也可以模拟繁忙的服务器。

交互参数

这些参数让epmd命令在交互模式下运行，发送查询到运行中的epmd实例并显示结果。交互的epmd都运行在本地节点上，参数-port可以用来选择不同的epmd实例，如果在多个端口上有epmd运行的话。

-port No
  与在指定TCP端口号（默认4369）监听的epmd通讯。可以通过ERL_EPMD_PORT环境变量设置，详见 环境变量 部分。

-names
  列出当前epmd上注册的节点名字。

-kill
  杀掉当前epmd。
  只有在epmd -names显示一个空数据库或者-relaxed_command_check启用的时候kill才会生效。
  要注意，-relaxed_command_check是在启动epmd进程的时候指定的，它能让进程在有活跃节点连接的时候接收kill指令。在互动模式下使用epmd命令-relaxed_command_check参数是无效的。没指定这个参数的话，在有活跃节点注册的情况下，只能通过信号或其他操作系统层面的方式去杀死它。

-stop Name
  从epmd数据库中强制注销一个活跃节点。
  这个命令只能在-relaxed_command_check参数指定的情况下才能生效。
  互动模式下无法设置-relaxed_command_check。

环境变量

ERL_EPMD_ADDRESS
  能被设置成逗号分隔的ip地址列表，如果设置了，epmd进程只会监听指定的ip地址和回环地址（没指定的话回环地址默认添加到列表后面）。默认的行为是监听所有ip地址。

ERL_EPMD_PORT
  能指定epmd使用的端口号。默认端口号在大多数情况下都适用。不同的端口号可以使一台机器上有多个epmd实例。集群上的所有节点必须使用相同的epmd端口号。

ERL_EPMD_RELAXED_COMMAND_CHECK
  如果在启动之前设置了，epmd启动时会指定-relaxed_command_check参数。因此，如果这个参数在启动Erlang虚拟机之前设置，自动启动的epmd能没限制地接收-kill和-stop命令。

日志

在一些操作系统中，如果epmd作为守护进程运行，错误日志会用syslog记录。要编辑/etc/syslog.conf文件并增加一条记录：

  !epmd
  *.*<TABs>/var/log/epmd.log

<TABs>处需有至少一个制表符。空白格默认无视。

访问限制

  epmd进程可以接收本地消息，也可以接收来自远程主机的消息。不过如果消息来自远程主机，只有查询命令会起作用并回复。如果收到远程主机发送过来的节点名字注册消息，会引发错误。这类消息会被认为是不怀好意的，连接会马上断开。

 

  下面这些远程查询可以被接收：

    端口查询，查询指定名字的节点监听的是哪个端口。

    名字列表，查询在进程上注册的所有节点名字。

 

  要更严格地限制访问权限的话，需要用到防火墙软件。