Specifies the node configuration in the server farm. Generally, it contains the application host connection and other network-related configuration settings. Agent configuration uses the layered configuration in the following order;
<installdir>/appsettings.json
<installdir>/Configuration/appsettings.json
<installdir>/Configuration/Data/appsettings.json
Environment variables
<installdir>/Configuration/Data/protectedsettings.json
The default configuration is stored in <installdir>/appsettings.json
file and it is not recommended to change. Any change should be specified in <installdir>/Configuration/appsettings.json
or <installdir>/Configuration/Data/appsettings.json
or other layers.
Environment Variables
Any environment variable that starts with "AK_
" prefix overrides the configuration entries in appsettings.json file. For example, the host configuration connection can be specified as an environment variable;
Code Block |
---|
AK_DbProvider = "Postgres"
AK_DbConnStr = "Host=myserver;Database=emakin;Username=emakin;Password=mypassword;" |
Configuration sub-section entries can be overridden with “__” (double underscores) separators. For example, if you want to change the webserver port you may define an environment variable as follows;
Code Block |
---|
AK_WEB__KESTREL__ENDPOINTS__HTTP__URL=http://*:81 |
Command Line Arguments
Any command line argument to the agent executable overrides the configuration entries.
Code Block |
---|
.\AltiKare.Workflow.Agent.exe DBConnStr="Host=myserver;Database=emakin;Username=emakin;Password=mypassword;" |
Encrypting Configuration Settings
By default, all configuration parameters are stored in plain text JSON files but sensitive settings like database connection string can be encrypted if needed.
<installdir>/Configuration/Data/protectedsettings.json
Note |
---|
Encrypted configuration settings can be only written and cannot be read back. If you lost this file all values are cannot be retrieved. |
For example, the database connection string can be set with;
Code Block |
---|
.\AltiKare.Workflow.Agent.exe setconfig DbConnStr DBConnStr 'Host=myserver;Database=emakin;Username=emakin;Password=mypassword;' |
Detailed information can be found in the CLI interface option.