```{index} /etc/hosts, localhost.localdomain, ошибки, внешние ссылки
```

# Ошибка "Invalid hostname, localhost.localdomain must not be used"

Ошибка возникает из-за нарушения рекомендаций по формату записей для
`localhost` и IP/имени текущего хоста в `/etc/hosts`.

Рекомендации приведены здесь:
[Host name and DNS requirements for IdM](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/installing_identity_management/preparing-the-system-for-ipa-server-installation_installing-identity-management#host-name-and-dns-requirements-for-ipa_preparing-the-system-for-ipa-server-installation)
--- в конце секции, подзаголовок "**Verify the /etc/hosts file**".

```{hint}
Рекомендации приведены для сервера FreeIPA (в статье `IdM server`), но
применимы к любому хосту, в том числе клиенту / члену домена FreeIPA.
```

`/etc/hosts` должен удовлетворять одному из двух условий:

* файл не содержит записи с именем текущего хоста, он содержит только IPv4
  и IPv6 записи `localhost`;

* файл содержит запись с именем текущего хоста и удовлетворяет **всем**
  следующим условиям:

  - первые две записи (строки) --- это записи localhost для IPv4 и IPv6;
  - следующая запись содержит IPv4 адрес текущего хоста (сервера FreeIPA)
    и его имя;
  - `FQDN` текущего хоста (сервера FreeIPA) указан *перед* его кратким именем;
  - имя текущего хоста (сервера FreeIPA) не является частью строки
    `localhost`.

Пример корректного файла `/etc/hosts`:

```text
127.0.0.1       localhost localhost.localdomain localhost4 localhost4.localdomain4
::1             localhost localhost.localdomain localhost6 localhost6.localdomain6
192.0.2.1	server.idm.example.com server
2001:DB8::1111	server.idm.example.com server
```

```{note}
Сейчас `/etc/hosts` именно в таком формате формирует плейбук стартовой
инициализации хостов. Практика показала, что VMWare, когда вносит изменения 
в данный файл, нарушает требуемый формат (или последовательность записей).
```

```{hint}
Во время ввода клиента FreeIPA в домен с помощью `ipa-client-install` помочь
избежать данную ошибку может также опция `--hostname=client.idm.example.com`,
т.е. явное задание FQDN хоста при вызове команды.

Тем не менее, соблюдение корректного формата `/etc/hosts` --- вариант более
правильный, системный и предпочтительный.
```

---

Также рекомендации приведены в статье 
[ipa-client fails with "ERROR Invalid hostname: 'localhost.localdomain' must
not be used"](https://access.redhat.com/solutions/4735031):

```{figure} img/localhost-localdomain.png
:alt: Скриншот решения проблемы из статьи access.redhat.com
:target: /_images/localhost-localdomain.png

Скриншот решения проблемы из статьи access.redhat.com
```