Upgrading

Upgrading Seldon Enterprise Platform (Seldon Deploy previously)

Important: When upgrading Seldon Enterprise Platform, please, always use matching version of the installation resources that is downloaded. This is especially important for the Seldon Enterprise Platform Helm charts as these may contain updates.

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.

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

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.

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 section. Upgrading notes for Seldon Core can be found here.

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:

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.

References

Last updated