The install guide asks the user to use the fqdn in the hostname, but doesn't explain why. This has been asked multiple times, so adding an explanation there.
Signed-off-by: Guido Trotter <[email protected]> --- doc/install.rst | 18 ++++++++++++++++++ 1 files changed, 18 insertions(+), 0 deletions(-) diff --git a/doc/install.rst b/doc/install.rst index 304922b..347371f 100644 --- a/doc/install.rst +++ b/doc/install.rst @@ -106,6 +106,24 @@ and not just *node1*. need to run the command ``/etc/init.d/hostname.sh start`` after changing the file). +.. admonition:: Why a fully qualified host name + + Although most distributions use only the short name in the /etc/hostname + file, we still think Ganeti nodes should use the full name. The reason for + this is that calling 'hostname --fqdn' requires the resolver library to work + and is a 'guess' via heuristics at what is your domain name. Since Ganeti + can be used among other things to host DNS servers, we don't want to depend + on them as much as possible, and we'd rather have the uname() syscall return + the full node name. + + We haven't ever found any breakage in using a full hostname on a Linux + system, and anyway we recommend to have only a minimal installation on + Ganeti nodes, and to use instances (or other dedicated machines) to run the + rest of your network services. By doing this you can change change the + /etc/hostname file to contain an fqdn without the fear of breaking anything + unrelated. + + Installing Xen ++++++++++++++ -- 1.5.6.5
