On Thu, Sep 17, 2009 at 10:03:33PM +0100, Guido Trotter wrote: > > 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.
LGTM, thanks a lot Guido! iustin
