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.
.png?version=2&modificationDate=1712323366387&cacheVersion=1&api=v2&width=716)
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. By default host administration can be accessed from only localhost http://localhost:5000 address.
| Note | ||
|---|---|---|
| ||
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. |
Host configuration contains one or more application definition to as hosted emakin application. Each application has multiple domains for multi-tenancy.
Application definition performs isolation at database level and nothing can be shared between application-wide. Domains isolates the process-wide data and cross domain workflows are possible. For example a workflow instance can be started in "foo" domain and next step can be assigned to a user in "bar" domain.
Domains also inherits configuration settings from application if not overriddenPlease see Agent Node Configuration page to configure an agent.
Host configuration
Please see Host Configuration page to configure host settings.