> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upgrades and uninstalling

## Upgrading

Run `helm upgrade` with the new chart version and your values file:

```bash theme={null}
helm upgrade fineparser \
  oci://709825985650.dkr.ecr.us-east-1.amazonaws.com/abbyy/fineparser-enterprise/fineparser-enterprise \
  --version <new-version> --namespace fineparser -f fineparser-values.yaml
```

Workers finish their current unit before they are replaced, the orchestrator resumes its queue, and the pool keeps its size. While the orchestrator restarts, the API answers `503` with `Retry-After`.

With Helm 4, an upgrade can fail with a conflict on `.spec.replicas` if the pool resized during it. Run the same command again. Do not force it.

## Changes that need a reinstall

Some storage settings cannot change on an existing release: `storage.inProcess.efs.fileSystemId`, `storage.inProcess.storageClass.*`, `storage.output.s3.bucket`, `storage.s3.region`, and `storage.s3.mountOptions`. Let the queue drain, uninstall, and install again with the new values.

## Uninstalling

Let running jobs finish first, then:

```bash theme={null}
helm uninstall fineparser --namespace fineparser
```

The orchestrator's state claim, `mnesia-fineparser-orchestrator-0`, is kept. A new install with the same release name and namespace picks up its queue. To start empty, delete it:

```bash theme={null}
kubectl -n fineparser delete pvc mnesia-fineparser-orchestrator-0
```

The chart-created EFS access point is deleted, and by default its data stays on the file system. The EFS file system, the S3 bucket and its results, and any IAM role you created are kept.