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.

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, it is necessary to first follow the upgrade guide for the corresponding version and restart the iObeya service once before you proceed to the next version.

Warning:

You need to contact our Support team to download the latest version of iObeya before you upgrade your iObeya platform.

• From iObeya 4.5, you have to upgrade to iObeya 4.6 (4.6 download)

• From iObeya 4.6, you have to upgrade to iObeya 4.8 (4.8 download)

• From iObeya 4.8, you have to upgrade to iObeya 4.12 (4.12 download)

• From iObeya 4.12, you have to upgrade to iObeya 4.16 (4.16 download)

• From iObeya 4.16, you have to upgrade to iObeya 4.20 (4.20 download)

• From iObeya 4.20, you have to upgrade to iObeya 4.31 (4.31 download)

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.

Warning:

You need to contact our Support team to download the latest version of iObeya before you upgrade your iObeya platform.

To upgrade iObeya, follow the main steps:

• Step 1: Preparing your environment

• Step 2: Backing up your environment

• Step 3: Practicing on a test environment

• Step 4: Downloading the iObeya on-premise package

• Step 5: Extracting and configuring the webapp

• Step 6: Upgrading Database

• Step 7: Upgrading the web application

• Step 8: Final steps