Agent Node Configuration

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

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