OutSystems.SetupTools

OutSystems.SetupTools is a powershell module for installing and manage the OutSystems platform installation.

This module allows you to install and configure the OutSystems platform completely using Powershell.

Branches

master

This is the branch containing the latest release - no contributions should be made directly to this branch.

dev

This is the development branch to which contributions should be proposed by contributors as pull requests. This development branch will periodically be merged to the master branch, and be released to PowerShell Gallery.

Common scenarios

With this module you can:

• Install the platform from a powershell command line.
• Create small scripts to install the platform on your environment and reuse them to reinstall or create other environments.
• Use the module functions in Docker files.
• Create small deployment scripts and use them on Azure ARM templates, AWS Cloudformation, Terraform to automatize the OutSystems deployment on the cloud.
• Use it in Packer to create golden images.

Quick start

• Install the module from PowerShell Gallery:

Install-Module -Name OutSystems.SetupTools

• Test if your system is compliant for installing OutSystems

Test-OSServerHardwareReqs -MajorVersion 11
Test-OSServerSoftwareReqs -MajorVersion 11

• Install the platform pre-requisites:

Install-OSServerPreReqs -MajorVersion 11

• Install the platform server and development environment:

Install-OSServer -Version "11.0.108.0" -InstallDir "D:\OutSystems"
Install-OSServiceStudio -Version "11.0.108.0" -InstallDir "D:\OutSystems"

• Configure the platform :

New-OSServerConfig -DatabaseProvider 'SQL'
Set-OSServerConfig -SettingSection 'PlatformDatabaseConfiguration' -Setting 'RuntimePassword' -Value 'mypassword'
Set-OSServerConfig -SettingSection 'SessionDatabaseConfiguration' -Setting 'SessionPassword' -Value 'mypassword'
...
...
Set-OSServerConfig -Apply -ConfigureCacheInvalidationService

• Install Service Center and the OutSystems systems components:

Install-OSPlatformServiceCenter
Publish-OSPlatformSystemComponents

• Do the post configuration:

Set-OSServerPerformanceTunning
Set-OSServerSecuritySettings

Documentation

Function reference is available at the docs folder. Usage and script examples at the examples folder.

Disclaimer

Hopefully this is obvious, but:

This is an open source project and all contributors are volunteers. All commands are executed at your own risk. This module is not directly supported by OutSystems. All issues with this module should be reported here.