Documentation Center

How to adapt the role of an existing BackgroundTask service

This topic explains how to adapt the role of an existing Trisoft InfoShare BackgroundTask service.

Before you begin

Check the name of the service role via Settings > XML Settings > Background Tasks.

If the name is newServiceRole, there should be a XML fragment like the following:
<service role="newServiceRole">
	  <matrix>
	  ...
	  </matrix>
	  <leaseRecovery isEnabled="true" interval="00:05:00" />
	  <poller isEnabled="false" interval="00:00:10" />
	  <aggregationRecovery isEnabled="false" gracePeriod="00:10:00" interval="00:10:00" maximumRetries="3" />
 </service>

Procedure

  1. Modify the Default service role configured for the Trisoft InfoShare BackgroundTask One windows service.
    1. Open the Registry Editor with Administrator rights.
    2. Open the key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Trisoft InfoShare BackgroundTask One.
    3. Open the value with name ImagePath.
      The current data looks like.
      D:\InfoShare\App\BackgroundTask\Bin\BackgroundTask.exe --service "Trisoft InfoShare BackgroundTask One" Default
      where Default is the default service role name configured out-of-the-box and present in the XML Background Task Settings.
    4. Edit the data and change Default to the new service role name newServiceRole
      The data should now look like.
      D:\InfoShare\App\BackgroundTask\Bin\BackgroundTask.exe --service "Trisoft InfoShare BackgroundTask One" newServiceRole
    5. Save the data.
    At this point we have configured the Trisoft InfoShare BackgroundTask One windows service to run with the newServiceRole.
  2. Start the Trisoft InfoShare BackgroundTask One windows service