> For the complete documentation index, see [llms.txt](https://kb.pvhostvm.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.pvhostvm.ru/hostvm-server/rukovodstvo-po-administrirovaniyu/chasto-zadavaemye-voprosy/ustanovka-i-nastroika-khostov/ochistka-metadannykh-na-khostakh-klastera-s-rolyu-self-hosted.md).

# Очистка метаданных на хостах кластера с ролью Self-Hosted

В данном разделе описывается процедура очистки метаданных после удаления хоста из кластера или его переразвёртывания.

При удалении хоста из кластера его метаданные не удаляются автоматически из общего хранилища Hosted Manager. В результате на остальных хостах с ролью Self-Hosted этот хост продолжает отображаться в выводе команды `hosted-engine --vm-status` как недоступный. Аналогичная ситуация возникает при повторном развёртывании хоста без предварительной очистки старых метаданных — появляются дублирующиеся записи, что мешает корректной работе кластера высокой доступности.

Ниже приведены сценарии очистки для каждого из этих случаев.

### Удаление метаданных хоста, исключённом из кластера

Если из кластера удалён хост с ролью Self-Hosted, но его данные продолжают отображаться на остальных аналогичных узлах, требуется провести очистку на каждом действующем Self-Hosted хосте в составе кластера.

{% hint style="warning" %}
Перед выполнением очистки убедитесь, что:

* целевой хост физически отключён или удалён из кластера;
* включён режим глобального обслуживания.
  {% endhint %}

1. Включите режим глобального обслуживания на любом работающем хосте с ролью Self-Hosted

```
hosted-engine --set-maintenance --mode=global
```

2. Определите идентификатор удаленного хоста из вывода команды

```
hosted-engine --vm-status
```

Пример вывода:

```
--== Host but-node2.hostvm.test (id: 2) status ==--
Host ID                            : 2
```

В данном примере `ID` удалённого хоста — `2`

3. На каждом работающем хосте с ролью Self-Hosted выполните команду очистки:

```
hosted-engine --clean-metadata --host-id=ID
```

Вместо `ID` подставьте идентификатор **удалённого** хоста (в примере - 2).

{% hint style="warning" %}
Убедитесь, что вы используете правильный `host-id`, чтобы случайно не очистить метаданные другого рабочего хоста. Не выполняйте эту команду для хоста, который в данный момент активен и работает в кластере.
{% endhint %}

4. Проверьте результат на любом хосте:

```
hosted-engine --vm-status
```

Запись об удалённом хосте должна исчезнуть из вывода.

5. Отключите режим глобального обслуживания

```
hosted-engine --set-maintenance --mode=none
```

### Очистка метаданных переразвернутого хоста

Хост был переразвернут без очистки старых метаданных, и теперь в статусе отображаются дублирующиеся записи для этого хоста. Это мешает корректной работе кластера высокой доступности.

{% hint style="warning" %}
Очистка выполняется строго на том хосте, который был переразвернут и имеет дублирующиеся записи. Перед началом убедитесь, что:

* вы работаете именно с проблемным хостом;
* на кластере включён режим глобального обслуживания.
  {% endhint %}

1. Включите режим глобального обслуживания на любом хосте кластера

```
hosted-engine --set-maintenance --mode=global
```

2. Подключитесь к проблемному хосту по SSH и остановите HA-агент:

```
systemctl stop ovirt-ha-agent
```

3. Принудительно удалите старые метаданные:

```
hosted-engine --clean-metadata --host-id=ID --force-clean 
```

Вместо `ID` подставьте **старый** идентификатор хоста (дублирующуюся запись из вывода `hosted-engine --vm-status`)

{% hint style="warning" %}
Убедитесь, что вы используете правильный `host-id`, чтобы случайно не очистить метаданные другого рабочего хоста.
{% endhint %}

4. Запустите HA-агент заново:

```
systemctl start ovirt-ha-agent
```

5. Убедитесь, что дублирующаяся запись исчезла. Проверку можно выполнить как на текущем хосте, так и на любом другом хосте вашего окружения HOSTVM Manager

```
hosted-engine --vm-status
```

6. Отключите режим глобального обслуживания

```
hosted-engine --set-maintenance --mode=none
```

Дублирующаяся запись должна исчезнуть.

Если в вашей среде несколько хостов были переразвернуты без очистки и теперь отображаются с дублями, повторите шаги 1–6 для каждого такого хоста индивидуально.