From 971165cb88d904b8f9d8c1b98def6e6fe02b1acf Mon Sep 17 00:00:00 2001 From: Badlop Date: Mon, 28 Jul 2008 16:55:01 +0000 Subject: [PATCH] * doc/guide.tex: Document how to get error message when ejabberd crash dumps at start (EJAB-660) * doc/guide.html: Likewise SVN Revision: 1494 --- ChangeLog | 4 ++++ doc/guide.html | 15 +++++++++++++-- doc/guide.tex | 15 +++++++++++++++ 3 files changed, 32 insertions(+), 2 deletions(-) diff --git a/ChangeLog b/ChangeLog index cc7853cd6..d131e2781 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,9 @@ 2008-07-28 Badlop + * doc/guide.tex: Document how to get error message when ejabberd + crash dumps at start (EJAB-660) + * doc/guide.html: Likewise + * src/mod_muc/mod_muc_room.erl: Add 'description' to the mod_muc_room config record; it will be used in ejabberd 2.1.x branch (EJAB-670) diff --git a/doc/guide.html b/doc/guide.html index 735efca64..41fba1cb2 100644 --- a/doc/guide.html +++ b/doc/guide.html @@ -290,7 +290,13 @@ go to the Windows service settings and set ejabberd to be automatically started. Note that the Windows service is a feature still in development, and for example it doesn’t read the file ejabberdctl.cfg.

On a *nix system, if you want ejabberd to be started as daemon at boot time, copy ejabberd.init from the ’bin’ directory to something like /etc/init.d/ejabberd -(depending on your distribution) and call /etc/inid.d/ejabberd start to start it.

The ejabberdctl administration script is included in the bin directory. +(depending on your distribution) and call /etc/inid.d/ejabberd start to start it.

If ejabberd doesn’t start correctly and a crash dump is generated, +there was a severe problem. +You can try starting ejabberd with +the script bin/live.bat in Windows, +or with the command bin/ejabberdctl live in other Operating Systems. +This way you see the error message provided by Erlang +and can identify what is exactly the problem.

The ejabberdctl administration script is included in the bin directory. Please refer to the section 4.1 for details about ejabberdctl, and configurable options to fine tune the Erlang runtime system.

2.2  Installing ejabberd with Operating System specific packages

Some Operating Systems provide a specific ejabberd package adapted to @@ -388,7 +394,12 @@ Node ejabberd@localhost is started. Status: started ejabberd is running ejabberdctl stop -

Please refer to the section 4.1 for details about ejabberdctl, +

If ejabberd doesn’t start correctly and a crash dump is generated, +there was a severe problem. +You can try starting ejabberd with +the command ejabberdctl live +to see the error message provided by Erlang +and can identify what is exactly the problem.

Please refer to the section 4.1 for details about ejabberdctl, and configurable options to fine tune the Erlang runtime system.

2.4.6  Specific Notes for BSD

The command to compile ejabberd in BSD systems is: diff --git a/doc/guide.tex b/doc/guide.tex index e1b00877a..cee425020 100644 --- a/doc/guide.tex +++ b/doc/guide.tex @@ -241,6 +241,14 @@ On a *nix system, if you want ejabberd to be started as daemon at boot time, copy \term{ejabberd.init} from the 'bin' directory to something like \term{/etc/init.d/ejabberd} (depending on your distribution) and call \term{/etc/inid.d/ejabberd start} to start it. +If \term{ejabberd} doesn't start correctly and a crash dump is generated, +there was a severe problem. +You can try starting \term{ejabberd} with +the script \term{bin/live.bat} in Windows, +or with the command \term{bin/ejabberdctl live} in other Operating Systems. +This way you see the error message provided by Erlang +and can identify what is exactly the problem. + The \term{ejabberdctl} administration script is included in the \term{bin} directory. Please refer to the section~\ref{ejabberdctl} for details about \term{ejabberdctl}, and configurable options to fine tune the Erlang runtime system. @@ -396,6 +404,13 @@ ejabberd is running ejabberdctl stop \end{verbatim} +If \term{ejabberd} doesn't start correctly and a crash dump is generated, +there was a severe problem. +You can try starting \term{ejabberd} with +the command \term{ejabberdctl live} +to see the error message provided by Erlang +and can identify what is exactly the problem. + Please refer to the section~\ref{ejabberdctl} for details about \term{ejabberdctl}, and configurable options to fine tune the Erlang runtime system.