Skip to main content

 

 

 

 

Template:OutSystems/Documentation_KB/Breadcrumb_New_Layout

 

 

Template:OutSystems/OSLanguageSwitcher

 

 

 

OutSystems

Upgrade OutSystems Platform in OutSystems Cloud

This article explains how you can upgrade your OutSystems Platform in the OutSystems Cloud. You'll be able to assess the upgrade, understand its impacts, and plan it accordingly. 

Before you start

Make sure you checked the general guidelines in the Upgrade OutSystems Platform before proceeding. Then read this article to understand what is involved and what you should plan in advance.

Upgrading an OutSystems Platform environment may incur in downtime for that environment, or the applications hosted in it, depending on the impact of the breaking changes resulting of the upgrade. You can ask OutSystems Support for the expected downtime of your environment.

Overview

In the OutSystems Cloud, the overall upgrade process is managed by OutSystems, coordinating with you in every step of the way, to guarantee a successfully and as effortless as possible procedure, consisting of the follow high-level steps:

  1. You can request the upgrade of your OutSystems Cloud infrastructure to a supported upper version, by opening a Support Case using any of the available mechanisms;
  2. OutSystems will promptly contact you to schedule and plan the OutSystems Platform upgrade of each of the OutSystems Cloud environments:
    1. You and OutSystems will upgrade the Management Console environment. See section Upgrade the Management Environment for more details;
    2. You and OutSystems will upgrade the first OutSystems Cloud non-production environment, typically the Development Environment. See section Upgrade the Development Environment for more details;
    3. You and OutSystems will upgrade the remaining OutSystems Cloud environments. See section Upgrade the remaining Environment for more details;
    4. Keep updating your Support case with the requests to upgrade each of the environments, as the upgrade plan moves forward

If you have a hybrid configuration where your infrastructure is comprised of both on-premise and OutSystems Cloud environments, please see section Upgrade hybrid infrastructures in the OutSystems Cloud for more details.

Upgrade the infrastructure management console

In the OutSystems Cloud, the infrastructure management console is installed on a dedicated environment. This environment should be the first to be upgraded. This allows you to stage applications from one environment to the next, as you upgrade the next environments to the latest version.

OutSystems will upgrade this environment upon request. The overall steps are:

  1. Request OutSystems to begin the upgrade process of your OutSystems Cloud infrastructure;
  2. OutSystems will upgrade the Platform Server and the LifeTime components on the environment;
  3. If you have any LifeTime plugin deployed on this environment, you must upgrade the correspondent application in that environment. See Upgrading Applications in an OutSystems Platform environment for more details.

You're done, and ready to start upgrading the other environments.

Upgrade the development environment

The Development environment is usually the first OutSystems Cloud environment to upgrade after the Management Console (LifeTime) environment. If following the same staging order, this is where you'll upgrade the applications to the new version as well.

OutSystems will upgrade this environment upon request. The overall steps are:

  1. Request OutSystems to begin the upgrade process of your OutSystems Cloud Development environment, or the first non-production environment in the OutSystems Cloud;
  2. OutSystems will upgrade the Platform Server component on the environment;
  3. Your developers install the new release of the development tools (Development client tools in the downloads page) in their desktops;
  4. You upgrade and test all applications. See Upgrading Applications in the Development Environment for more details.

Upgrade the remaining environments

After upgrading the Development environment, proceed to upgrading the remaining environments in your infrastructure, preferably according to your staging order.

OutSystems will upgrade each environment upon request. The overall steps are:

  1. Request OutSystems to begin the upgrade process of your next OutSystems Cloud environment;
  2. OutSystems will upgrade the Platform Server component on the environment;
  3. If they haven’t already, your developers install the new release of the development tools (Development client tools in the downloads page) in in their desktops;
  4. You deploy all applications from the Development environment to the environment you are upgrading, using Lifetime, the Platform management console.

Upgrading hybrid infrastructures in OutSystems Cloud

In case you have a hybrid infrastructure, i.e. some environments running in OutSystems Cloud and some environments running in your own private cloud or datacenter, OutSystems will only upgrade the environments in the OutSystems Cloud. For you to upgrade your private cloud or datacenter environments, please refer to the Upgrade OutSystems Platform in your datacenter article.

Hybrid configuration is only supported in OutSystems licenses purchased before January 2020.

Doing maintenance while upgrading environments

While upgrading, if you need to do some bug fixing in an application that's running on an environment that hasn't been upgraded, you'll need to do it on that environment. It won't be possible to go through the usual development-production pipeline, because you can't stage applications between environments in different versions.

The solution is to make the fix directly in the environment that is not yet upgraded.


As an example, imagine that you already upgraded Development and Test environments. There are still Pre-Production and Production environments to be upgraded. You have to do a critical fix on an application in Production. In this case, use the development tools in Pre-Production to do the fix, to publish and test. Then, move the application to Production. Don’t forget to backport the fix to the other environments.

At any time, you can ask OutSystems Support for assistance.