Skip to main content
OutSystems

Default Platform Server and database configurations

To install and run OutSystems, you need permissions to change files in the file system, run services, listen to specific ports, and make changes to the database. Learn what permissions are needed.

Server configurations

Hardware

The Platform Server must run on a server deployed on bare metal or hardware virtualization technologies (e.g. VMware, KVM) with a fixed MAC address. Changing the MAC address (either by physically changing the network card, of through virtualization software) results in an invalid license. 

Software

All software required for installing the Platform Server is listed in the Platform Server installation checklist.

File system

All OutSystems components are installed by default at C:\Program Files\OutSystems\. If you install the development tools (Service Studio and Integration Studio), their preferences are stored at C:\Users\<user name>\AppData\Roaming\OutSystems.

Also, the OutSystems installers creates registry entries to store some configurations. These are stored at HKEY_LOCAL_MACHINE > SOFTWARE > OutSystems

Services

During the installation, OutSystems registers a set of services on the server. You can start and stop these services using the Windows Management Console.

Service Executable C:\Program Files\OutSystems\Platform Server Configuration C:\Program Files\OutSystems\Platform Server
SMS Connector SmsConnector.exe  SmsConnector.exe.config
Compiler CompilerService.exe CompilerService.exe.config
DeployService DeployService.exe  DeployService.exe.config 
Log LogServer.exe LogServer.exe.config 
Scheduler Scheduler.exe Scheduler.exe.config 

The logs of these services are stored in Windows Event Viewer.

Database configurations

SQL Server

The SQL Server database must comply with the following requirements:

  • If you are using SQL Server authentication, the authentication mode needs to be set to “Mixed Mode”.
  • When using Windows Authentication, all front-ends and controller must use the same domain as the database server.
  • The collation of the SQL Server instance must be case-insensitive (CI_*).
  • The collation of the database catalog must be Case Insensitive and should also be Accent Insensitive.

Azure SQL

The Azure SQL database and catalog must comply with the following collation requirements:

  • The database instance must be Case Insensitive;
  • The database catalog must be Case Insensitive and should also be Accent Insensitive.

Oracle

To integrate with an Oracle database, the NLS_CHARACTERSET must be set to WE8MSWIN1252 or AL32UTF8. Additionally, names of tables and columns you want to integrate must use uppercase letters only.

DB2

To integrate with DB2 database for iSeries, the installation of the IBM iAccess software is required in all Front-End and Deployment Controller server machines.

Application Server

The IIS needs to be set to IIS6 compatibility mode. To configure your IIS, simply use the Windows Server Manager console.

OutSystems applications are always deployed to the Default Web Site (identifier 1). For this reason, the Default Web Site cannot be renamed, and must listen to 127.0.0.1 on port 80 without any host headers.

In case of having multiple address entries in Default Web Site, the configuration 127.0.0.1:80 with no host headers must be on top of all other entries.

Deployed applications

When an application is deployed, the OutSystems Deployment Service compiles the model developed using the development environment into valid .NET code. 

Applications source code

The server with the deployment controller role stores the application source code at: C:\Program Files\OutSystems\Platform Server\share\<application name>\full 

Compiled applications

During the deployment of an application, the Deployment Controller ensures the front-end servers have the compiled applications stored in the OutSystems installation folder, and proceeds to change the virtual directories in ISS to point to the new application folder.

The compiled applications are stored at:

  • Shared Libraries - C:\Program Files\OutSystems\Platform Server\repository
  • Applications - C:\Program Files\OutSystems\Platform Server\running 

Logging 

OutSystems has built-in logic capabilities to monitor the applications during runtime. To ensure the performance of the applications is not compromised, the logs are performed asynchronously, using a message queue. For this, the OutSystems installer creates several queues in the Microsoft Message Queue, and configures them to not be persisted in secondary memory.

The LogServer process is then responsible to consume the messages in these queues and insert them in the OutSystems' Log tables. You can then use Service Center (the environment monitoring console) to consult the logs.

 

Check here the default Platform Server and database configurations for other stacks.