# Upgrading

> Upgrading Seldon Enterprise Platform (*Seldon Deploy previously*)

{% hint style="warning" %}
**Important**: When upgrading Seldon Enterprise Platform, please, always use matching version of the [installation resources](/seldon-enterprise-platform/production-environment/observability-alerting/observability.md#installing-kube-prometheus) that is downloaded. This is especially important for the Seldon Enterprise Platform Helm charts as these may contain updates.
{% endhint %}

{% hint style="warning" %}
**Important**:

* Seldon always recommend to first validate upgrade path in development cluster before rolling out changes to production.
* Model artifacts trained to work with pre-packaged model servers may require retraining when upgrading. This is due to changes in their dependencies or in their Python versions. Advanced monitoring components -- model explainers, drift detectors, outlier detectors, etc. -- are the most likely to be affected.
* Seldon recommends testing these artifacts in a development environment to determine whether or not they require retraining. Alternatively, you can modify the Helm values to specify previous versions of the relevant model servers.
  {% endhint %}

{% hint style="warning" %}
**Important**: Seldon only support upgrading to the next released version of Seldon Enterprise Platform (*Seldon Deploy previously*). This means that if you for example are upgrading from Seldon Enterprise Platform 1.3 to Seldon Enterprise Platform 1.5 you need to first upgrade to version 1.4 and only then to version 1.5
{% endhint %}

{% hint style="warning" %}
**Note**: Keep your configuration files, e.g. Helm values of Seldon components, under VCS. This will allow you to easily rollback the installation if required.
{% endhint %}

## Upgrading Process Summary

Before proceeding with upgrading Seldon Core and Seldon Enterprise Platform check the corresponding subsection with detailed notes for each version of Seldon Enterprise Platform (*Seldon Deploy previously*), available as subpages listed in [References](#referencesreferences) section. Upgrading notes for Seldon Core can be found [here](https://docs.seldon.io/projects/seldon-core/en/latest/reference/upgrading.html).

The general process of upgrading Seldon product can be summarized in following steps:

1. Download the `seldon-deploy-install.tar` file that contains required installation resources. For example, to download the installation resources for version `2.3.1` of Seldon Enterprise Platform run the following:

   ```
   TAG=2.3.1 && \
    docker create --name=tmp-sd-container seldonio/seldon-deploy-server:2.3.1 && \
    docker cp tmp-sd-container:/seldon-deploy-dist/seldon-deploy-install.tar.gz . && \
    docker rm -v tmp-sd-container
   ```
2. Extract the contents of the `seldon-deploy-install.tar` file.

   ```
   tar -xzf seldon-deploy-install.tar.gz
   ```
3. Follow upgrading notes dedicated to the version you are upgrading to
4. Upgrade Seldon components executing executing `helm upgrade` commands as described on corresponding documentation pages:
   1. [Seldon Core V2](/seldon-enterprise-platform/production-environment/seldon-core-2.md).
   2. [Seldon Enterprise Platform](/seldon-enterprise-platform/production-environment/seldon-enterprise-platform.md).

{% hint style="warning" %}
**Important**: Always, first follow the upgrade procedure in your development cluster, validate that all your models and deployments work as expected, and only then follow with upgrading your production cluster.
{% endhint %}

## References

* [version 2.4.0](/seldon-enterprise-platform/upgrading/sep-2.4.0.md)
* [version 2.3.1](/seldon-enterprise-platform/upgrading/deploy-2.3.1.md)
* [version 2.3.0](/seldon-enterprise-platform/upgrading/deploy-2.3.0.md)
* [version 2.2.1](/seldon-enterprise-platform/upgrading/deploy-2.2.1.md)
* [version 2.2.0](/seldon-enterprise-platform/upgrading/deploy-2.2.0.md)
* [version 2.1.1](/seldon-enterprise-platform/upgrading/deploy-2.1.1.md)
* [version 2.1.0](/seldon-enterprise-platform/upgrading/deploy-2.1.0.md)
* [version 2.0.2](/seldon-enterprise-platform/upgrading/deploy-2.0.2.md)
* [version 2.0.1](/seldon-enterprise-platform/upgrading/deploy-2.0.1.md)
* [version 2.0.0](/seldon-enterprise-platform/upgrading/deploy-2.0.0.md)
* [version 1.6.0](/seldon-enterprise-platform/upgrading/deploy-1.6.0.md)
* [version 1.5.1](/seldon-enterprise-platform/upgrading/deploy-1.5.1.md)
* [version 1.5.0](/seldon-enterprise-platform/upgrading/deploy-1.5.0.md)
* [version 1.4.0](/seldon-enterprise-platform/upgrading/deploy-1.4.0.md)
* [version 1.3.0](/seldon-enterprise-platform/upgrading/deploy-1.3.0.md)
* [version 1.2.0](/seldon-enterprise-platform/upgrading/deploy-1.2.0.md)
* [version 1.1.0](/seldon-enterprise-platform/upgrading/deploy-1.1.0.md)
* [version 1.0.0](/seldon-enterprise-platform/upgrading/deploy-1.0.0.md)
* [Pre-GA versions](/seldon-enterprise-platform/upgrading/pre-ga.md)


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.seldon.ai/seldon-enterprise-platform/upgrading.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.