diff options
Diffstat (limited to 'doc/guide.html')
| -rw-r--r-- | doc/guide.html | 21 |
1 files changed, 13 insertions, 8 deletions
diff --git a/doc/guide.html b/doc/guide.html index b6e54c610..5119b47f0 100644 --- a/doc/guide.html +++ b/doc/guide.html @@ -2776,7 +2776,8 @@ all the environment variables and command line parameters.</P><P>The environment </DD><DT CLASS="dt-description"><B><TT>ERL_CRASH_DUMP</TT></B></DT><DD CLASS="dd-description"> Path to the file where crash reports will be dumped. </DD><DT CLASS="dt-description"><B><TT>ERL_INETRC</TT></B></DT><DD CLASS="dd-description"> - Indicates which IP name resolution to use. It is required if using <TT>-sname</TT>. + Indicates which IP name resolution to use. + If using <TT>-sname</TT>, specify either this option or <TT>-kernel inetrc filepath</TT>. </DD><DT CLASS="dt-description"><B><TT>ERL_MAX_PORTS</TT></B></DT><DD CLASS="dd-description"> Maximum number of simultaneously open Erlang ports. </DD><DT CLASS="dt-description"><B><TT>ERL_MAX_ETS_TABLES</TT></B></DT><DD CLASS="dd-description"> @@ -2791,7 +2792,10 @@ all the environment variables and command line parameters.</P><P>The environment The Erlang node will be fully identified. This is only useful if you plan to setup an <TT>ejabberd</TT> cluster with nodes in different networks. </DD><DT CLASS="dt-description"><B><TT>-kernel inetrc "/etc/ejabberd/inetrc"</TT></B></DT><DD CLASS="dd-description"> - Indicates which IP name resolution to use. It is required if using <TT>-sname</TT>. + Indicates which IP name resolution to use. + If using <TT>-sname</TT>, specify either this option or <TT>ERL_INETRC</TT>. +</DD><DT CLASS="dt-description"><B><TT>-kernel inet_dist_listen_min 4200 inet_dist_listen_min 4210</TT></B></DT><DD CLASS="dd-description"> + Define the first and last ports that <TT>epmd</TT> (section <A HREF="#epmd">5.2</A>) can listen to. </DD><DT CLASS="dt-description"><B><TT>-detached</TT></B></DT><DD CLASS="dd-description"> Starts the Erlang system detached from the system console. Useful for running daemons and backgrounds processes. @@ -2912,8 +2916,8 @@ you must follow these instructions: <TR><TD ALIGN=left NOWRAP>5222</TD><TD ALIGN=left NOWRAP>Standard port for Jabber/XMPP client connections, plain or STARTTLS.</TD></TR> <TR><TD ALIGN=left NOWRAP>5223</TD><TD ALIGN=left NOWRAP>Standard port for Jabber client connections using the old SSL method.</TD></TR> <TR><TD ALIGN=left NOWRAP>5269</TD><TD ALIGN=left NOWRAP>Standard port for Jabber/XMPP server connections.</TD></TR> -<TR><TD ALIGN=left NOWRAP>4369</TD><TD ALIGN=left NOWRAP>Port used by EPMD for communication between Erlang nodes.</TD></TR> -<TR><TD ALIGN=left NOWRAP>port range</TD><TD ALIGN=left NOWRAP>Used for connections between Erlang nodes. This range is configurable.</TD></TR> +<TR><TD ALIGN=left NOWRAP>4369</TD><TD ALIGN=left NOWRAP>EPMD (section <A HREF="#epmd">5.2</A>) listens for Erlang node name requests.</TD></TR> +<TR><TD ALIGN=left NOWRAP>port range</TD><TD ALIGN=left NOWRAP>Used for connections between Erlang nodes. This range is configurable (see section <A HREF="#epmd">5.2</A>).</TD></TR> </TABLE> <DIV CLASS="center"><HR WIDTH="80%" SIZE=2></DIV></DIV></BLOCKQUOTE><!--TOC section epmd --> <H2 CLASS="section"><!--SEC ANCHOR --><A NAME="htoc66">5.2</A>  epmd </H2><!--SEC END --><P> @@ -2928,8 +2932,8 @@ To communicate with <TT>ejabberd</TT>, the script <TT>ejabberdctl</TT> starts a and connects to the Erlang node that holds <TT>ejabberd</TT>. In order for this communication to work, <TT>epmd</TT> must be running and listening for name requests in the port 4369. -You should block the port 4369 in the firewall, -so only the programs in your machine can access it.</P><P>If you build a cluster of several <TT>ejabberd</TT> instances, +You should block the port 4369 in the firewall in such a way that +only the programs in your machine can access it.</P><P>If you build a cluster of several <TT>ejabberd</TT> instances, each <TT>ejabberd</TT> instance is called an <TT>ejabberd</TT> node. Those <TT>ejabberd</TT> nodes use a special Erlang communication method to build the cluster, and EPMD is again needed listening in the port 4369. @@ -2937,8 +2941,9 @@ So, if you plan to build a cluster of <TT>ejabberd</TT> nodes you must open the port 4369 for the machines involved in the cluster. Remember to block the port so Internet doesn’t have access to it.</P><P>Once an Erlang node solved the node name of another Erlang node using EPMD and port 4369, the nodes communicate directly. -The ports used in this case are random. -You can limit the range of ports when starting Erlang with a command-line parameter, for example: +The ports used in this case by default are random, +but can be configured in the file <TT>ejabberdctl.cfg</TT>. +The Erlang command-line parameter used internally is, for example: </P><PRE CLASS="verbatim">erl ... -kernel inet_dist_listen_min 4370 inet_dist_listen_max 4375 </PRE><!--TOC section Erlang Cookie--> <H2 CLASS="section"><!--SEC ANCHOR --><A NAME="htoc67">5.3</A>  Erlang Cookie</H2><!--SEC END --><P> |