---
title: influxdb3 manage retry-upgrade-to-pacha-tree
description: The influxdb3 manage retry-upgrade-to-pacha-tree command resets a Parquet-to-PachaTree storage engine upgrade that latched to a failed state in InfluxDB 3 Enterprise, so it resumes on the next compactor restart.
url: https://docs.influxdata.com/influxdb3/enterprise/reference/cli/influxdb3/manage/retry-upgrade-to-pacha-tree/
estimated_tokens: 652
product: InfluxDB 3 Enterprise
version: enterprise
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/enterprise/reference/cli/influxdb3/manage/retry-upgrade-to-pacha-tree/
date: '2026-08-28T05:19:10-05:00'
lastmod: '2026-08-28T05:19:10-05:00'
---

* InfluxDB 3 Enterprise v3.11.2+

Use `influxdb3 manage retry-upgrade-to-pacha-tree` to reset a [storage engine upgrade](/influxdb3/enterprise/reference/internals/storage-engine/) (Parquet-to-PachaTree) that latched to a `failed` state.

The command re-checks every previously failed upgrade source against the catalog and object store:

* Sources that are still readable are requeued.
* Sources whose table or database was dropped are recorded as skipped.
* Sources that can’t be read back are left unresolved for the next retry.

The reset itself only changes durable state.
The migration resumes the next time a compactor node starts with `--upgrade-pacha-tree`.

## Usage

```bash
influxdb3 manage retry-upgrade-to-pacha-tree [OPTIONS]
```

## Options

|Option|                      |               Description                |        Default        |  Environment variable   |
|------|----------------------|------------------------------------------|-----------------------|-------------------------|
| `-H` | `--host <HOST_URL>`  |     InfluxDB 3 Enterprise server URL     |`http://127.0.0.1:8181`|  `INFLUXDB3_HOST_URL`   |
|      |`--token <AUTH_TOKEN>`|           Authentication token           |                       | `INFLUXDB3_AUTH_TOKEN`  |
|      | `--tls-ca <CA_CERT>` |Path to a custom TLS certificate authority|                       |   `INFLUXDB3_TLS_CA`    |
|      |  `--tls-no-verify`   |   Disable TLS certificate verification   |                       |`INFLUXDB3_TLS_NO_VERIFY`|
| `-h` |       `--help`       |          Print help information          |                       |                         |

## Example

```bash
influxdb3 manage retry-upgrade-to-pacha-tree \
  --host http://localhost:8181 \
  --token AUTH_TOKEN
```

If any sources are left unresolved, run the command again to re-attempt them.

#### Related

* [Storage engine](/influxdb3/enterprise/reference/internals/storage-engine/)
* [influxdb3 manage cleanup-parquet](/influxdb3/enterprise/reference/cli/influxdb3/manage/cleanup-parquet/)
| Option |  | Description | Default | Environment variable |
| --- | --- | --- | --- | --- |
| Option |  | Description | Default | Environment variable |
| -H | --host <HOST_URL> | InfluxDB 3 Enterprise server URL | http://127.0.0.1:8181 | INFLUXDB3_HOST_URL |
|  | --token <AUTH_TOKEN> | Authentication token |  | INFLUXDB3_AUTH_TOKEN |
|  | --tls-ca <CA_CERT> | Path to a custom TLS certificate authority |  | INFLUXDB3_TLS_CA |
|  | --tls-no-verify | Disable TLS certificate verification |  | INFLUXDB3_TLS_NO_VERIFY |
| -h | --help | Print help information |  |  |