Specifies the node configuration in server farm. Generally it contains the application host connection and other network related configuration settings. Agent configuration uses layered configuration in following order;
<installdir>/appsettings.json
<installdir>/Configuration/appsettings.json
<installdir>/Configuration/Custom/appsettings.json
Environment variables
Command line arguments
<installdir>/Configuration/Custom/protectedsettings.json
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 other layers.
Environment Variables
Any environment variable that starts with "AK_
" prefix overrides the configuration entries in appsettings.json file. For example host configuration connection can be specified as environment variable;
AK_DbProvider = "Postgres" AK_DbConnStr = "Host=myserver;Database=emakin;Username=emakin;Password=mypassword;"
Command Line Arguments
Any command line argument to agent executable overrides the configuration entries.
.\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. Encrypted settings are stored in this path and overwrites the previous layers.
<installdir>/Configuration/Custom/protectedsettings.json
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 database connection string can be set with;
.\AltiKare.Workflow.Agent.exe setconfig DbConnStr DBConnStr 'Host=myserver;Database=emakin;Username=emakin;Password=mypassword;'
After this command is executed a new protectedsettings.json file is created in ‘Configuration/Custom’ directory and stores the encrypted connection string.
{ "DbConnStr": "CfDJ8L..........6PT0Kw=" }
Any configuration value from <installdir>/appsettings.json
file can be set with setconfig parameter and child sections can be specified with “:” qualifier.
dotnet AltiKare.Workflow.Agent.dll setconfig Section:SubSection:Key Value