Documentation Center

Default background task role

This role provides everything which is necessary to execute all possible background tasks

The default background task role runs the Trisoft InfoShare BackgroundTask One service configured with a role that contains all possible eventTypes.

Prerequisites

Out of the box, the Trisoft InfoShare BackgroundTask One service is configured with the Default role, which contains all possible eventTypes. With this configuration, starting the Trisoft InfoShare BackgroundTask One service is enough to enable the default background task role.

However, should you wish to double-check the configuration, do the following:
  1. Go to Start > Administrative Tools > Services
  2. Right-click the Trisoft InfoShare BackgroundTask One service, and from the context menu, select Properties.
  3. Check the value for Path to executable. The value should contain something like:
    C:\InfoShare\App\BackgroundTask\Bin\BackgroundTask.exe --service "Trisoft InfoShare BackgroundTask One" Default
    The last parameter in the command line is the name of the service role. Out of the box, the role is Default.
  4. Sign in to Organize Space.
  5. From the top tab level, select the Settings tab.
  6. From the second tab level, select the XML Settings tab.
  7. From the third tab level, select the Background Tasks tab.
  8. Find all eventType values by checking that attribute in the XPath handlers/handler.
  9. Go to the server definition with the role used by the service (e.g. "Default") and check that all eventTypes from the previous step are referenced in one of the groups. If necessary, add the missing eventTypes.

Make sure that all required third-party software is installed and configured properly on this server, because if one of the dependencies is not present, the background tasks will fail.

How do I enable the default background task role?

Execute the following steps to enable the default background task role:
  • Go to Start > Administrative Tools > Services.
  • Right-click the Trisoft InfoShare BackgroundTask One item and from the context menu, select Start.

How do I scale out?

There are two ways of scaling out the Trisoft InfoShare BackgroundTask service:
  • Adding extra services with the same role
  • Introducing specialized roles with a limited set of eventTypes.