Unattended Installation and Upgrade

1. Install the OutSystems platform prerequisites

The OutSystems Platform Server installation package can automatically install most of the prerequisites if you provide the optional /InstallPrerequisites=True switch.

If you prefer to install the prerequisites manually, follow the instructions in the Pre-installation checklist section of the Installation Checklist before running the installation package.

2. Install the Development Environment binaries

Run the OutSystems Development Environment installation package as follows:

DevelopmentEnvironment-<version>.exe /S [/D=<development_environment_path>]

The optional /D switch specifies the path where the Development Environment is installed. If this switch is provided, it must be the last one in the command line and the provided path must not contain quotes ("") even if the path contains spaces.

3. Install the Platform Server binaries

Run the OutSystems Platform Server installation package as follows:

PlatformServer-<version>.exe /S [/InstallPrerequisites=True] [/DoTuning=<factory_size>] [/D=<platform_path>]

The optional /InstallPrerequisites=True switch specifies if the prerequisites will be automatically installed.
The optional /DoTuning=<factory_size> switch specifies if the tuning should be automatically performed.
The optional /D switch specifies the path where the OutSystems Platform Server is installed. If this switch is provided, it must be the last one in the command line and the provided path must not contain quotes ("") even if the path contains spaces.

For more information check the Automatic Prerequisites Installation and Configuration Tuning.

4. Only for Oracle: create the database users

Follow the instructions in the Database section of the Installation Checklist.

5. Update the server.hsconf configuration file

Replace the default <platform_path>\server.hsconf file with a customized template containing your specific configurations.

To help create specific server configuration files, Configuration Tool can automatically generate different configuration file templates for each database engine on which OutSystems can run on. The templates refer to the operating system and application server where the Configuration Tool is running. You can check the description of each parameter in the server.hsconf file.

Templates can be automatically generated before proceeding with the configuration steps of the unattended installation process (or even before the installation of the platform in the new machine, if you already have another machine where the platform is already installed), by using the following command line which will save them to the directory <platform_path>\docs:

<platform_path>\ConfigurationTool.com /GenerateTemplates

Keep in mind that configuration settings differ between OutSystems platform database.

To easily add a front-end later, the CompilerServerHostname parameter must include the name or IP of the machine and not localhost. The same applies to other parameters that refer hostnames.

Ensure that usernames and passwords are stored with the correct casing.

6. Run Configuration Tool and install Service Center

For SQL Server and Azure SQL Database:

<platform_path>\ConfigurationTool.com /SetupInstall <platform_db_admin_username> <platform_db_admin_password> [<logging_db_admin_username> <logging_db_admin_password>]
    /SetPlatformServerAdminPassword <platform_server_admin_password>
    /RebuildSession <session_db_admin_username> <session_db_admin_password>
    /CreateUpgradeCacheInvalidationService
    /SCInstall

For Oracle:

<platform_path>\ConfigurationTool.com /SetupInstall
    /SetPlatformServerAdminPassword <platform_server_admin_password>
    /RebuildSession <session_db_admin_username> <session_db_admin_password>
    /CreateUpgradeCacheInvalidationService
    /SCInstall

7. Publish System Components

<outsystems_common_path>\OSPTool.com /Publish "<platform_path>\System_Components.osp" <hostname> <username> <password>

8. Upload license file (requires manual intervention)

Manually obtain a valid OutSystems platform license from www.outsystems.com/licensing using the environment activation code.

<platform_path>\ConfigurationTool.com /UploadLicense <license_file.lic>

9. Publish LifeTime

<outsystems_common_path>\OSPTool.com /Publish "<platform_path>\LifeTime.osp" <hostname> <username> <password>

10. Publish OutSystems Now

Requires downloading OutSystems Now from Forge.

<outsystems_common_path>\OSPTool.com /Publish "<OutSystemsNow-version.oap>" <hostname> <username> <password>

1. Install the OutSystems platform prerequisites

The OutSystems Platform Server installation package can automatically install most of the prerequisites if you provide the optional /InstallPrerequisites=True switch.

If you prefer to install the prerequisites manually, follow the instructions in the Pre-installation checklist section of the Installation Checklist before running the installation package.

2. Install the Development Environment binaries

If your Development Environment is no longer compatible with the Platform Server you are about to install, run the OutSystems Development Environment installation package as follows:

DevelopmentEnvironment-<version>.exe /S [/D=<development_environment_path>]

The optional /D switch specifies the path where the Development Environment is installed. If this switch is provided, it must be the last one in the command line and the provided path must not contain quotes ("") even if the path contains spaces.

3. Upgrade the Platform Server binaries

Run the OutSystems Platform Server installation package as follows:

PlatformServer-<version>.exe /S [/InstallPrerequisites=True] [/DoTuning=<factory_size>] [/D=<platform_path>]

The optional /InstallPrerequisites=True switch specifies if the prerequisites will be automatically installed.
The optional /DoTuning=<factory_size> switch specifies if the tuning should be automatically performed.
The optional /D switch is ignored in an upgrade scenario.

For more information check the Automatic Prerequisites Installation and Configuration Tuning.

4. Update the server.hsconf configuration file

Skip this step if no changes are necessary to the running configuration and that configuration file templates haven't changed.

5. Run Configuration Tool and install Service Center

<platform_path>\ConfigurationTool.com /UpgradeInstall [<admin_password>]
    [/SetPlatformServerAdminPassword <platform_server_admin_password>]
    [/RebuildSession <session_db_admin_username> <session_db_admin_password>]
    [/CreateUpgradeCacheInvalidationService]
    /SCInstall

Note: You need to include the /SetPlatformServerAdminPassword <platform_server_admin_password> argument if the Admin user of Platform Server is active and its password is still defined as 'admin'.

6. Publish System Components

<outsystems_common_path>\OSPTool.com /Publish "<platform_path>\System_Components.osp" <hostname> <username> <password>

7. Upload license file (requires manual intervention)

Skip this step if the existing license is valid for the OutSystems version you're upgrading to.

Manually obtain a valid OutSystems platform license from www.outsystems.com/licensing using the environment activation code.

<platform_path>\ConfigurationTool.com /UploadLicense <license_file.lic>

8. Publish LifeTime

<outsystems_common_path>\OSPTool.com /Publish "<platform_path>\LifeTime.osp" <hostname> <username> <password>

9. Publish OutSystems Now

Requires downloading OutSystems Now from Forge.

<outsystems_common_path>\OSPTool.com /Publish "<OutSystemsNow-version.oap>" <hostname> <username> <password>

10. Republish the entire factory

<outsystems_common_path>\OSPTool.com /PublishFactory <hostname> <username> <password>

1. Install the Platform Server binaries

Implies execution of the steps described in the Pre-installation Checklist (e.g. server roles and features, services options). The OutSystems Platform Server installation package can automatically install most of the prerequisites.

Run the OutSystems Platform Server installation package as follows:

PlatformServer-<version>.exe /S [/InstallPrerequisites=True] [/DoTuning=<factory_size>] [/D=<platform_path>]

The optional /InstallPrerequisites=True switch specifies if the prerequisites will be automatically installed.
The optional /DoTuning=<factory_size> switch specifies if the tuning should be automatically performed.
The optional /D switch specifies the path where the OutSystems Platform Server is installed. If this switch is provided, it must be the last one in the command line and the provided path must not contain quotes ("") even if the path contains spaces.

For more information check the Automatic Prerequisites Installation and Configuration Tuning.

2. Copy the configuration files from the controller node to the front-end

In order for this step to be successful, the server.hsconf file in the deployment controller machine must not refer to localhost in any hostname parameter, namely the deployment controller hostname and cache service hostname. If that is not true, you will need to run the Configuration Tool on the controller machine and change that address, before continuing with this step.

Copy the following files from the controller machine to the front-end machine, keeping the same path:

• <platform_path>\private.key

• <platform_path>\server.hsconf

3. Run Configuration Tool

For SQL Server and Azure SQL Database:

<platform_path>\ConfigurationTool.com /SetupInstall <platform_db_admin_username> <platform_db_admin_password> <logging_db_admin_username> <logging_db_admin_password>

For Oracle:

<platform_path>\ConfigurationTool.com /SetupInstall