> For the complete documentation index, see [llms.txt](https://platform9.com/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://platform9.com/kb/pmo/solution/instance-missing-on-hypervisor.md).

# Instance Missing on Hypervisor

## Problem

* Instance goes into **ERROR** state after failing to start.
* Running **`openstack server show [uuid]`** command shows an instance fault such as the following.

{% tabs %}
{% tab title="None" %}

```none
Error: Instance [UUID] could not be found on hypervisor.
```

{% endtab %}
{% endtabs %}

## Environment

* Platform9 Managed OpenStack - All Versions
* Nova

## Causes

1. Instance failed to migrate.
2. Disk is full on hypervisor.

## Resolution

### Instance Failed to Migrate

1. Determine on which host the instance resides on.

{% tabs %}
{% tab title="None" %}

```none
# openstack server show [UUID]
```

{% endtab %}
{% endtabs %}

2. Check if the instance is running on the host obtained from the previous output.

{% tabs %}
{% tab title="None" %}

```none
# virsh list --all | grep [UUID]
```

{% endtab %}
{% endtabs %}

3. Confirm that the instance XML file still exists on the hypervisor.

{% tabs %}
{% tab title="None" %}

```none
# ls -l /etc/libvirt/qemu/[UUID].xml# ls -l /opt/pf9/data/instances/[UUID]/cfg-[UUID].xml
```

{% endtab %}
{% endtabs %}

4. If the XML file resides on the host, redefine the instance using *virsh*.

{% tabs %}
{% tab title="None" %}

```none
# virsh define /etc/libvirt/qemu/[UUID].xml
```

{% endtab %}
{% endtabs %}

5. Reset the state of the instance.

{% tabs %}
{% tab title="None" %}

```none
# openstack server set --state active [UUID]
```

{% endtab %}
{% endtabs %}

### Disk Full

1. Identify which partition is full.

{% tabs %}
{% tab title="None" %}

```none
# df -h
```

{% endtab %}
{% endtabs %}

2. Inspect which folder(s) or file(s) are consuming the most amount of disk space.

{% tabs %}
{% tab title="None" %}

```none
# du -xh [partition-path] | sort -h | tail
```

{% endtab %}
{% endtabs %}

3. At your discretion, optionally backup and/or remove or truncate the offending large files which are consuming the most space.

**Note**: If you are uncertain if a particular file may be removed or truncated belonging to PF9, please [contact Support](https://support.platform9.com/hc/en-us/requests/new?ticket_form_id=360000924873).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://platform9.com/kb/pmo/solution/instance-missing-on-hypervisor.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
