Skip to main content

 

Upgrade your applications to a new OutSystems Platform version

OutSystems

Upgrade your applications to a new OutSystems Platform version

This article explains how you can upgrade your applications after you Upgrade the OutSystems Platform to a new version.

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.

Overview

After upgrading an OutSystems Platform environment, you may have to upgrade the applications to the new major release as well. The process is different for the .NET and Java stacks environments.

Upgrading applications in the .NET stack

To upgrade applications in the .NET stack, proceed as follows:

  1. Open the environment's management console (Service Center) and create a solution with all modules of all applications. Publish it;
  2. If all modules are published without errors (like the picture below), proceed to step 3;
    solution-successfully-published.png

    Otherwise, do the following:
    1. Use the appropriate development tool (Development client tools in the downloads page) to open the module;
    2. Fix the problems and publish the module, until it has no errors.
  3. Publish the whole solution again to make sure all dependencies are properly resolved;
  4. Test your applications: screens, workflows, operations, etc. Check for errors in Service Center’s  Errors Log.

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

Upgrading applications in the Java stack

To upgrade applications in the Java stack, proceed as follows:

  1. Open the environment's management console (Service Center) and create a solution with all modules of all applications. Download the solution and extract the contents of the solution to your computer’s hard disk (use a ZIP file archiver to extract the individual modules from the OutSystems Solution Pack - .OSP);
  2. Upgrade Extension modules:
    1. Use Integration Studio to individually open and publish each module;
    2. If it is published without errors, move on to the next module. Otherwise fix the problems and publish it again, until it has no errors.
  3. Upgrade eSpace modules:
    1. Use Service Studio to individually open and publish each module;
    2. If it is published without errors, move on to the next module. Otherwise fix the problems and publish it again, until it has no errors.
  4. After all modules have been individually upgraded, go to Service Center and publish the solution with all modules of all applications. This will validate dependencies between modules and ensure your factory’s consistency.
  5. If all modules are published without errors (like the picture below), proceed to step 6.
    solution-successfully-published.png
    Otherwise, do the following:
    1. Use the appropriate development tool (Development client tools in the downloads page) to open the module;
    2. Fix the problems and publish the module, until it has no errors.
  6. Publish the whole solution again to make sure all dependencies are properly resolved;
  7. Test your applications: screens, workflows, operations, etc. Check for errors in Service Center’s  Errors Log.

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