# OpenSearch - Upgrade

## **Upgrade Process**

## **PaaS upgrade workflow** <a href="#opensearchupgradeinplace-opensearchpaasupgrade" id="opensearchupgradeinplace-opensearchpaasupgrade"></a>

### Request <a href="#opensearchupgradeinplace-request" id="opensearchupgradeinplace-request"></a>

The update of an OpenSearch PaaS can be done in self-service on the OpenSearch cluster's resource page in [ITCare](https://itcare.cegedim.cloud)

It is recommended that you upgrade your non-production environments first in order to estimate the downtime generated by the operation and to test your applications using the new version.

### Process <a href="#opensearchupgradeinplace-process" id="opensearchupgradeinplace-process"></a>

The upgrade of an OpenSearch deployment takes place in two fully automated steps:

* Update the Operating system first if required
* The upgrade is performed **node by node** to ensure service continuity.

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>Skipping to a major version requires to be up to date with minor versions. Reverting to a previous version is not supported</p></div>

<figure><picture><source srcset="https://835168969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FXoHyOBZPpJv3UALn4V%2Fuploads%2Fgit-blob-2db6271a29e766bf10782db7a54a25dbdf6d7067%2Fopensearch-upgrade-dark-eng.png?alt=media" media="(prefers-color-scheme: dark)"><img src="https://835168969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2FXoHyOBZPpJv3UALn4V%2Fuploads%2Fgit-blob-ff9d731f13b947c9df3afcedc721a7efc7ebbfe4%2Fopensearch-upgrade-light-eng.png?alt=media" alt="" width="563"></picture><figcaption></figcaption></figure>

### Impacts

When upgrading OpenSearch, anticipate the following potential impacts:

* Data write might slow down
* Temporarily reduced performance
* Dashboard's page reload may be needed

### Time references <a href="#opensearchupgradeinplace-timereferences" id="opensearchupgradeinplace-timereferences"></a>

As an average guideline, durations for each steps of an upgrade in place of a 100 GB cluster :

* Debian upgrade: 10 minutes on average
* Backup: 5 minutes on average
* OpenSearch upgrade : 15 minutes on average
* Dashboard upgrade : 10 minutes on average
* Automatic validation tests : 15 minutes on average

These times are indicative and may vary depending on specific cluster configurations.

## **OS / Opensearch support matrix** <a href="#opensearchupgradeinplace-os-opensearchsupportmatrixmatrice" id="opensearchupgradeinplace-os-opensearchsupportmatrixmatrice"></a>

Linux distributions supported by **cegedim.cloud** depending on the Opensearch version:

<table><thead><tr><th width="223">Opensearch version</th><th>Debian distribution</th></tr></thead><tbody><tr><td>OpenSearch 2.15</td><td>Debian 12</td></tr><tr><td>OpenSearch 2.19</td><td>Debian 12</td></tr><tr><td>OpenSearch 3.3.0</td><td>Debian 12</td></tr><tr><td>OpenSearch 3.5.0</td><td>Debian 12</td></tr></tbody></table>