The content is currently unavailable in French. You are viewing the default English version.

Overview

This article provides you general information to upgrade an on-premise deployment of iObeya.

Recommendation:

We recommend upgrading your iObeya platform at least once a year to stay no more than one version behind the latest release.

The iObeya support policy only supports the most recent minor version of iObeya on-premise servers.

Information:

A maintenance page is available for your upgrade process. We can provide you with the necessary resources to set it up but the actual configuration is up to you.

Simply reach out to us to request the resources needed.

Upgrade Path

To successfully upgrade from an old version of iObeya, you need to follow the upgrade path and upgrade to every version between the one you currently have and the targeted one.

Warning:

If you need to go through several versions to upgrade your iObeya on-premise servers:

  • Follow the upgrade path and use the upgrade guide for the targeted version.

  • For each version of iObeya on-premise servers, follow the upgrade guide for the corresponding version and restart the iObeya service once before you proceed to the next version.

Before you start your upgrade, you need to request access to download the latest version of iObeya.

iObeya-v4-upgrade-path.png

  • From iObeya 4.5, you have to upgrade to iObeya 4.6.

  • From iObeya 4.6, you have to upgrade to iObeya 4.8.

  • From iObeya 4.8, you have to upgrade to iObeya 4.12.

  • From iObeya 4.12, you have to upgrade to iObeya 4.16.

  • From iObeya 4.16, you have to upgrade to iObeya 4.20.

  • From iObeya 4.20, you have to upgrade to iObeya 4.31.

  • From iObeya 4.31, you have to upgrade to iObeya 4.36.

Note:

If you fall behind and your instance is on an unsupported version, please contact your dedicated Customer Success Manager or our Support team to get guidance regarding the upgrade path to follow.

Preparation is the key to success:

  • An upgrade is a good opportunity to assess whether the current environment meets your needs or if it makes sense to make changes.

  • Upgrading to a new version may require new hardware or software to meet the technical requirements.

Prepare adequately and identify any necessary changes to ensure that your upgraded system works optimally and meets your needs in the long run.

Expect the best, prepare and plan for the worst:

Even though the upgrade procedure is reliable and each new version of iObeya has been tested and validated during months with our Cloud customers, it always makes sense to prepare for any unforeseen issues when you upgrade your on-premise instance.

As a precaution, it is important to understand how to:

  • revert to the previous version,

  • check if you have a complete and consistent backup of your iObeya database and assets files available.

This ensures that you can easily restore your system to its previous state in the event of any unexpected problems during the upgrade process. Use the Backup and restore section to create a backup of your iObeya database and assets files.

Main Steps to Upgrade iObeya

Warning:

  • Do not forget to check the iObeya license deployed on your server before you upgrade to a newer version of iObeya.

  • Attempting to upgrade to a version that has been released after the support date of your license will lead to the inability to restart iObeya. Information regarding the support date of the current license is available on the License page in the administration interface of the platform, as well as the release date on Resource Center.

To upgrade iObeya, follow the main steps: