Red Hat Bugzilla – Bug 768257
Man Page : Document client IP addressing / FQDN requirements
Last modified: 2012-06-20 09:28:24 EDT
This bug is created as a clone of upstream ticket:
Currently ipa-client-install man page states about IP addressing / hostname only that:
The hostname of this server (FQDN). If specified, the hostname
will be set and the system configuration will be updated to per-
sist over reboot. By default a nodename result from uname(2) is
But if one runs ipa-client-install without --hostname on a client-to-be using using dynamic IP / hostname from corporate DHCP/DNS without MAC binding then eventually the client's IP address and hostname will change causing issues on the client, e.g., with Kerberos.
Manual page should clearly state that a static hostname for clients is needed.
Fixed upstream. Man pages now contain a special section about hostname requirements.
Following text has been added in man page of ipa-client-install for hostname
Client must use a static hostname. If the machine hostname changes for example due to a dynamic hostname assignment by a DHCP server,
client enrollment to IPA server breaks and user then would not be able to perform Kerberos authentication.
--hostname option may be used to specify a static hostname that is set in machine system configuration and persist over reboot.
In man page of ipa-client-install, hostname switch description is changed but in ipa-client-install's help text it is still the same.
hostname switch description from ipa-client-install's help text
The hostname of this server (FQDN). If specified, the
hostname will be set and the system configuration will
be updated to persist over reboot. By default a
nodename result from uname(2) is used.
Here is above description word "server" should be changed with "machine" which has been done in man page.
based on comments, setting bug status to Assigned
Fixed upstream - "server" was replaced with "machine".
Technical note added. If any revisions are required, please edit the "Technical Notes" field
accordingly. All revisions will be proofread by the Engineering Content Services team.
No documentation needed.
Now, ipa-client-install's help text also contains "machine" instead of "server" .
[root@dhcp201-121 ~]# rpm -q ipa-server ipa-client
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.
For information on the advisory, and where to find the updated
files, follow the link below.
If the solution does not work for you, open a new bug report.