Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Layered Configuration Settings

Configuration settings can be overridden in following order.

...

Emakin configuration settings can be divided to two different area. Emakin supports the multiple nodes to support horizontally scaling with load balancer scenarios. Each agent node has own configuration files to connect host configuration database. Host configuration is shared with all nodes in farm and stored in database.

Image Added

Agent 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
  • Environment variables
  • Command line arguments

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;

Code Block
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.

Code Block
.\AltiKare.Workflow.Agent.exe DBConnStr="Host=myserver;Database=emakin;Username=emakin;Password=mypassword;"

Host configuration

Specifies the global farm configuration. All agent nodes in farm shares the same configuration.


All Emakin configuration settings can be view or updated from special panel called "host administration". By default host administration can be accessed from only localhost http://localhost:5000 address. 

Host administration port (5000) should be open to only secured networks and should not be open for public access. In addition to special port host administration panel also protected by a password. On initial setup emakin assigns default password ("verysecret") but it can be changed later from administration panel.