Manage service profiles

Add a service profile

You can add the service profiles for the Core Worker and Transformation. As the Core Worker can only access one data center, the Core Worker Service profiles are stored within a single data center.

On the header bar, click Management Console > Service Profiles.

The Service Profiles page appears. The default Data Center (On Premise Datacenter Database) appears as you can configure only one data center in an on-premise multi-tenant environment.
In the Refresh deployments with assigned profiles after box, to change the refresh interval, enter a number or click an arrow to select the value in seconds.

This settings is not specific to an individual service profile but to a deployment. You can set the refresh interval only after adding the service profile.
Click Update.

The deployments are refreshed with the assigned profile after the specified interval.
Add the Core Worker Service profile and Transformation Service profile as needed, and click Save.

Add a Core Worker Service profile

Define the Core Worker service profile to control how the Core Worker functions so you can adjust the settings as required and apply them to any deployment.

On the Service Profiles page, click Create.

The Add Core Worker Service Profile page appears with the default data center.
In the Profile Name box, enter a name for the Core Worker Service profile.

Configure other settings as needed.

The Core Worker Service profile settings with default values are given in the following table.

Setting	Description	Default value
General
Worker task poll interval (seconds)	Specifies how often the system should check for the in-memory worker tasks that are due.	1
Database worker task poll interval (seconds)	Specifies how often the system should poll for the due database worker tasks.	1
Worker task timeout interval (seconds)	Specifies how often the system checks for timed-out worker tasks.	300
Maximum evaluate job task size	Specifies the maximum number of Evaluate Job tasks to take.	50
Thread pool monitoring interval (seconds)	Defines how often a thread pool should monitor the threads in it. Currently, the monitoring is done to check for thread timeout is monitored, and only for thread pools of the Automatic activity type.	60
Archive delete worker tasks to retrieve	Specifies the number of Archive Jobs and DeleteItem non-system level worker tasks to retrieve for execution.	50
Archive delete retry interval (seconds)	Specifies the thread pool name for automatic activities.	0
Upgrade jobs thread pool size	Specifies the size of the Upgrade job thread pool. If the thread pool size is full, the core worker waits until the space to add more tasks is available.	4
Activity Timeout
Activity timeout interval (minutes)	Defines the duration after which an activity is timed out. The activity is only freed once the corresponding task executes.	60
Poll time activities reset interval (seconds)	Specifies how often the Core Worker checks for timed-out activities.	300
Import Connector
Import connector name	Allows administrators to explicitly specify the import connection a Core Worker should use. This setting is useful when multiple Core Workers are set up.	All
Maximum messages/documents to import	Specifies the maximum number of documents or messages to import for document ingestion.	50
Automatic Activities
Maximum work queue task size	Specifies the maximum number of tasks that can be taken by the Core Worker.	50
Maximum number of activities to lock	Specifies the number of automatic activities to lock when the Core Worker polls for the execution of automatic activities.	32
Activity order	Specifies the order in which the activities are taken for processing.	Activity Due Date, Priority
Auto activities pool name	Specifies the thread pool name for automatic activities.	None
Auto activities pool ID	Specifies the thread pool ID for automatic activities.	None
Message Connector
Maximum direct ingest threads	Specifies the maximum number of direct import threads per tenant.	1
Direct ingest burst duration (seconds)	Specifies the maximum duration since the start of a worker thread where the available massages are continuously imported. The worker thread usually terminates the earlier messages if no input is due for polling. If this duration is reached, the worker thread completes after the current import/poll operation.	600
Direct ingest timeout (seconds)	Specifies the maximum run duration of direct import worker threads. The worker threads are cancelled if this time-out expires. The maximum run duration must be higher than the expected worst-case duration for reception and import of a message.	7200
Direct ingest confirm timeout (seconds)	Specifies the maximum duration between each retry.	600

Modify the settings as needed and click Save.

Add a Transformation Service profile

Define the Transformation Service Profile to control how the Transformation Server functions so you can adjust the settings if required on a deployment.

The Transformation Service profiles are not defined by default.

On the Service Profiles page, click Create.

By default, the Add Core Worker Service Profile page appears with the default data center.
On the Service Profile list, select Transformation Service Profile.
In the Profile Name box, enter a name for the Transformation Service profile.

Configure other settings as needed.

The Transformation Service Profile settings with default values are given in the following table.

Setting	Description	Default value
Pool Name	Specifies the pool from which the Transformation Server will process.	Empty
Maximum number of slots	Specifies the number of CPU-intensive background processes that may run concurrently, excluding the idle background processes. The maximum number of processing slots is determined using the following formula: (int)Math.Round(Environment.ProcessorCount*1.25)	0
Number of reserved slots	Specifies the number of slots on the Transformation Server that are reserved for pushed high-priority activities (such as synchronous calls).	0
Activity order	Specifies the order in which the activities are taken for processing.	Activity Due Date, Priority
Poll timeout activities reset interval (minutes)	Defines how often the activities are checked for running too long.	10
Taken activities reset timeout (minutes)	Specifies how often the Transformation Server checks for timed-out activities.	10
Enable online learning	Enables processing of the Online Learning task for this Transformation Server instance.	Selected
Enable processing of synchronous activities	Enables processing of synchronous pushed calls.	Selected

Modify the settings as needed and click Save.

Update a service profile

You can change the values for the Core Worker service and Transformation Service profile settings.

On the header bar, click Management Console > Service Profiles.

The Service Profiles page appears with the list of Core Worker Service and Transformation Service profiles.
To update the Core Worker Service profile:
1. On the list of profiles, click the Core Worker Service profile name to update.
  
  The Update Core Worker Service Profile page appears.
2. Update the values for the settings as needed and click Save.
To update the Transformation Service profile:
1. On the list of profiles, click the Transformation Service profile name to update.
  
  The Update Transformation Service Profile page appears.
2. Update the values for the settings as needed and click Save.

Delete a service profile

You can delete the Core Worker and Transformation Service profiles.

On the Service Profiles page, on the list of profiles, click the profile to delete.
Click Delete.
On confirmation, the service profile is deleted.

Associate a service profile

You can associate a service profile with a deployment (production deployment or any of the additional deployments) so that you can change how the service is performing.

Associate a Core Worker Service profile

You can associate a Core Worker Service profile with a deployment (production deployment or any of the additional deployments) so that you can change how the Core Worker service is performing.

On the header bar, click Configuration > Data Centers.

The Data Centers page appears with the default data center name, (On Premise Datacenter Database).
Click the data center name.
Under Service Profiles, on the Core Worker Service Profile list, select the Core Worker Service profile to associate with the deployment. (Default: None (Default System Settings)).
Click Save.

The Core Worker Service profile is associated with the deployment once the service profile refresh interval has passed. The Core Worker functions as per the settings defined in the selected profile across all environments on that deployment and for all tenants using the environments on that deployment.

When you edit a data center and remove the profile associated with a deployment, the Core Worker Service uses the default settings from the Core Worker Service configuration file (Agility.Server.Core.WorkerService.exe.config).

Associate a Transformation Service profile

You can associate a Transformation Service profile with a deployment (production or additional deployments) so that you can change how the Transformation Server is performing.

On the header bar, click Configuration > Data Centers.

The Data Centers page appears with the default data center name, (On Premise Datacenter Database).
Click the data center name.
Under Service Profiles, on the Transformation Service Profile list, select the Transformation Service profile to associate with the deployment. (Default: None (Default System Settings)).
Click Save.

The Transformation Service profile is associated with the deployment once the service profile refresh interval has passed. The Transformation Server functions as per the settings defined in the selected profile across all environments on that deployment and for all tenants using the environments on that deployment.

When you edit a data center and remove the Transformation Service profile associated with a deployment, the default system settings are used.