Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/outsystems/outsystems.setuptools

Powershell module to install and manage the OutSystems platform
https://github.com/outsystems/outsystems.setuptools

engineering os-rd-productivity outsystems powershell powershell-module rd-infra-automation snyk-product

Last synced: about 2 months ago
JSON representation

Powershell module to install and manage the OutSystems platform

Host: GitHub
URL: https://github.com/outsystems/outsystems.setuptools
Owner: OutSystems
License: apache-2.0
Created: 2018-09-13T10:29:00.000Z (over 6 years ago)
Default Branch: dev
Last Pushed: 2024-01-17T10:26:50.000Z (12 months ago)
Last Synced: 2024-04-14T10:11:29.071Z (9 months ago)
Topics: engineering, os-rd-productivity, outsystems, powershell, powershell-module, rd-infra-automation, snyk-product
Language: PowerShell
Homepage:
Size: 2.16 MB
Stars: 22
Watchers: 71
Forks: 10
Open Issues: 18
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

# OutSystems.SetupTools

[![PowerShell Gallery](https://img.shields.io/powershellgallery/dt/outsystems.setuptools.svg)](https://www.powershellgallery.com/packages/Outsystems.SetupTools)
[![AppVeyor](https://img.shields.io/appveyor/ci/pintonunes/OutSystems-setuptools.svg)](https://ci.appveyor.com/project/pintonunes/outsystems-setuptools) [![AppVeyor tests](https://img.shields.io/appveyor/tests/pintonunes/OutSystems-setuptools.svg)](https://ci.appveyor.com/project/pintonunes/outsystems-setuptools/build/tests) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

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](https://www.powershellgallery.com/).

## 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](https://www.powershellgallery.com/packages/OutSystems.SetupTools):

```powershell
Install-Module -Name OutSystems.SetupTools
```

* Test if your system is compliant for installing OutSystems

```powershell
Test-OSServerHardwareReqs -MajorVersion 11
Test-OSServerSoftwareReqs -MajorVersion 11
```

* Install the platform pre-requisites:

```powershell
Install-OSServerPreReqs -MajorVersion 11
```

* Install the platform server and development environment:

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

* Configure the platform :

```powershell
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:

```powershell
Install-OSPlatformServiceCenter
Publish-OSPlatformSystemComponents
```

* Do the post configuration:

```powershell
Set-OSServerPerformanceTunning
Set-OSServerSecuritySettings
```

## Documentation

Function reference is available at the [docs](docs) folder.
Usage and script examples at the [examples](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.