Configuration Tool Command Line Reference
This article applies to: OutSystems 11 Other versions available: 10
The Configuration Tool allows you to configure your OutSystems server.
The default path of the Configuration Tool command line is the following:
C:\Program Files\OutSystems\Platform Server\ConfigurationTool.com
The Configuration Tool command line returns non-zero values when an error occurs.
Syntax
ConfigurationTool.com
| /SetupInstall [<platform_db_admin_username> <platform_db_admin_password> <logging_db_admin_username> <logging_db_admin_password>] [/SetPlatformServerAdminPassword <platform_server_admin_password>]
| /UpgradeInstall [<integrated_auth_admin_password>] [/SetPlatformServerAdminPassword <platform_server_admin_password>]
| /RebuildSession <session_db_admin_username> <session_db_admin_password>
| /SCInstall
| /InstallSystemComponents
| /GenerateTemplates
| /ClearInternalNetwork
| /UploadLicense <license_file> <platform_server_admin_user> <platform_server_admin_password>
| /RegenerateSettingsKey
| /GetSerial
| /SetPlatformServerAdminPassword <platform_server_admin_password>
| /GetDeploymentZones
| /ModifyDeploymentZone <deployment_zone_name> <deployment_zone_address> [<enable_https>]
| /CreateUpgradeCacheInvalidationService
| /EnableServerAPI
| /DisableServerAPI
| /UpgradeEnvironment
| /ApplySettingsFactory
Parameters
/SetupInstall [<platform_db_admin_username> <platform_db_admin_password> <logging_db_admin_username> <logging_db_admin_password>] [/SetPlatformServerAdminPassword <platform_server_admin_password>]
-
Creates or upgrades the OutSystems platform and logging database model using the
server.hsconf
configuration file.For Azure SQL Database or SQL Server databases, you must provide the credentials needed to create or upgrade the platform database. Furthermore, if you specify separate platform and logging databases in
server.hsconf
, you also need to provide the credentials needed to create or upgrade the logging database.For Oracle databases, you do not need to provide the admin usernames and passwords.
If you provide the optional
/SetPlatformServerAdminPassword
parameter with a password, sets the password for the Platform Serveradmin
user. /UpgradeInstall [<integrated_auth_admin_password>] [/SetPlatformServerAdminPassword <platform_server_admin_password>]
-
Upgrades the OutSystems platform and logging database models, without validating if the database exists or if the permissions are correct.
The admin password is optional and is only used for integrated authentication purposes where the password isn't stored in the server configuration file.
If you provide the optional
/SetPlatformServerAdminPassword
parameter with a password, sets the password for the Platform Serveradmin
user. /RebuildSession <session_db_admin_username> <session_db_admin_password>
-
Upgrades the session database model. The username and password provided must belong to a user with permissions to execute these operations.
/SCInstall
-
Forces the Service Center installation to run after finishing Configuration Tool.
/InstallSystemComponents
-
Forces the System Components installation or upgrade to run after applying the configuration settings.
/GenerateTemplates
-
Generates server configuration file (
.hsconf
) templates for each supported database engine inPlatform Server\docs
. /ClearInternalNetwork
-
Resets the internal network settings so that internal applications become accessible from any origin.
/UploadLicense <license_file> <platform_server_admin_user> <platform_server_admin_password>
-
Uploads the license file and checks if the license is valid.
You must provide valid Service Center admin user credentials to execute this operation.
The Service Center application must be running. /RegenerateSettingsKey
-
Generates a new private.key file.
/GetSerial
-
Prints the serial number of this installation.
/SetPlatformServerAdminPassword <platform_server_admin_password>
-
Defines the password for the Platform Server Admin user, if the user is active.
Note: This command doesn't work when using Integrated Authentication. /GetDeploymentZones
-
Lists the configured deployment zones for the current installation. The data is presented in JSON format, limited to the relevant settings that can be manipulated with
/ModifyDeploymentZone
, namely: the Configuration Name and Address, and it's Enable HTTPS status. /ModifyDeploymentZone <deployment_zone_name> <deployment_zone_address> [<enable_https>]
-
Modifies the Address and/or Enable HTTPS settings of a Deployment Zone.
<deployment_zone_name>
is the Deployment Zone that you want to modify; this argument is case insensitive (for example "GLOBAL" will map to "Global").<deployment_zone_address>
is the new address for the target Deployment Zone.[<enable_https>]
is an optional boolean argument; if this argument is not provided the setting will remain unchanged. If the string "true" (case insensitive) is provided, the Enable HTTPS setting is set to "true"; if any other string is provided the setting Enable HTTPS is set to "false". The applied value of the Enable HTTPS setting is displayed. /CreateUpgradeCacheInvalidationService
-
Installs cache invalidation service or reconfigures the service given in the configuration file (
server.hsconf
). /EnableServerAPI
-
Enables Server.API and Server.Identity on this machine. (Server.API and Server.Identity are enabled by default).
/DisableServerAPI
-
Disables Server.API and Server.Identity on this machine. Beware, Service Center will not work without them.
/UpgradeEnvironment
-
Installs Service Center and System Components. Skips any of these steps if they were previously executed.
/ApplySettingsFactory
-
Applies the current
server.hsconf
settings to the factory.
Note: This command only generates output in case of errors.
Example
Perform a clean installation for SQL Server or Azure SQL Database:
ConfigurationTool.com
/SetupInstall <platform_db_admin_username> <platform_db_admin_password> <logging_db_admin_username> <logging_db_admin_password>
/RebuildSession <session_db_admin_username> <session_db_admin_password>
/CreateUpgradeCacheInvalidationService
/SCInstall
Perform a clean installation for Oracle:
ConfigurationTool.com
/SetupInstall
/RebuildSession <session_db_admin_username> <session_db_admin_password>
/CreateUpgradeCacheInvalidationService
/SCInstall
Perform an upgrade from OutSystems 10 (or lower):
ConfigurationTool.com
/UpgradeInstall <integrated_auth_admin_password>
/RebuildSession <session_db_admin_username> <session_db_admin_password>
/CreateUpgradeCacheInvalidationService
/SCInstall
Perform an upgrade from OutSystems 11:
ConfigurationTool.com
/UpgradeInstall <integrated_auth_admin_password>
/RebuildSession <session_db_admin_username> <session_db_admin_password>
/SCInstall
Modify the Address and/or Enable HTTPS settings of the "Global" deployment zone:
ConfigurationTool.com
/ModifyDeploymentZone "Global" <deployment_zone_address> [<enable_https>]
Disable Server.API and Server.Identity:
ConfigurationTool.com
/DisableServerAPI
Enable Server.API and Server.Identity:
ConfigurationTool.com
/EnabelServerAPI
Logging
By default, the Configuration Tool has logging enabled with log level 4
(Verbose), and the predefined log file is defined as C:\Windows\Temp\ConfigurationTool.log
.
For more information on configuring logs check the Change OutSystems Platform logging levels (OSTrace) topic.