Skip to main content

Configure your OutSystems environment

OutSystems

Configure your OutSystems environment

This article applies only to OutSystems 11.

When installing the Platform Server in an environment, the installation checklist will ask you to configure Service Center, which is the management console of your OutSystems environment.

The Service Center console of a specific environment (eg. Development, Test, Production) is accessible through the url http://<your_server>/ServiceCenter.

Configure your environment

The configuration of your environment is done in the Administration > Environment Configuration area in Service Center console: 

environment-configuration.png

When installing the Platform Server for the first time, you must configure the following settings:

  • Hostname
  • Purpose
  • Debug Mode

Purpose

The Purpose of an OutSystems environment defines the main objective of the environment in the infrastructure. OutSystems changes its behavior to better fit the needs of each purpose, which reflects in optimizations and the availability of specific features.

The environment Purpose should only be changed when an environment is being configured for the first time or right after an upgrade to OutSystems 11. Besides those two moments, the Purpose should be stable throughout the life of an environment. 

In case you need to change the environment Purpose, the new configuration is applied to all modules automatically.

This runtime setting must be set to one of the following values:

Development

Environments whose main purpose is to create and develop applications, requiring a fast feedback loop. Development environments use several 1 Click-Publish process optimizations, like differential compilation, and allow testing/previewing data in Aggregates and SQL Queries, viewing data in Entities and using Personal Areas; Furthermore, in Development environments, it is not possible to deploy applications to Containers.

Production

Environments whose main purpose is to make applications available to your end-users. In Production environments, reliability is a top priority so 1-Click Publish process optimizations are disabled; as a consequence, publishing an application in a Production environment can take longer than publishing the same application in a Development environment.

Non-Production

Environments whose main purpose is to provide a real scenario (similar to Production) where developers can test your applications and mitigate the risk of deploying them to Production while keeping features that can assist developers with debugging. In Non-Production environments 1-Click Publish process optimizations are disabled (just like Production environments) and it is still possible to test SQL Queries and preview data in Aggregates and SQL Queries (like Development environments).

Management (LifeTime)
This is where LifeTime, the infrastructure management console lives. An environment with this purpose requires stability, and that’s why they also behave similarly to environments with Production purpose, with no optimizations being done.

The Purposes supported in a given environment are limited by the environment's license.
If an environment has a Development license, you can set the Purpose as Development or Non-Production.
Production licenses support all Purposes.

Feature availability for different Purposes

Legend: Yes Available; YesX Available with restrictions; No Not available

Features Development Non-Production Purpose


Production

Management (LifeTime)

Deploy to containers No Yes Yes Yes
1-Click Publish process optimizations1 Yes No No No
Publishing of solution continues with errors2 Yes Yes No No
Preview in Devices Yes Yes YesA Yes A
Test/preview data in Aggregates and Queries Yes Yes No No
View Data in Entities Yes Yes No No
Test and debug in Personal Area YesB No No No
Delete Module in Service Studio Yes No No No
Replace Module in Service Studio3 Yes No No No

1- Optimizations that only concern the performance of the 1-Click Publish process; 2- When not available the publish process will stop and ask the user if it should abort or continue; 3- By publishing a module with the same name.

A- Requires enabling the site property AvailableInProductionMode in PreviewInDevices Module; B- Requires enabling the Module's Debug Mode.

Environment Debug Mode

The Debug Mode of an OutSystems environment determines if eSpaces in that environment can be debugged in Service Studio.

To be able to debug an eSpace in Service Studio, both the environment Debug Mode and the eSpace Debug Mode must be enabled.

Disabling the environment Debug Mode
Disables the Debug Mode for each eSpace in the environment.
When the Debug Mode of the environment is disabled it is not possible to enable the Debug Mode for any of the eSpaces.   
Enabling the environment Debug Mode
Allows you to manually enable the Debug Mode for eSpaces you want to debug.

Changes in Debug Mode will only affect Modules after they have been republished; read more about applying compile-time configurations.
Note: When disabling the Debug Mode of an environment you will only need to republish the eSpaces whose Debug Mode was previously enabled.

When you publish an eSpace for the first time, the Debug Mode of the eSpace is set according to the Debug Mode of that environment.

  • Was this article helpful?