Skip to main content

Get help for ARIS Risk and Compliance

Adapt server task schedules

ARIS Risk and Compliance provides server tasks that are automatically executed according to schedules, for example, to generate tasks and monitor due dates of tasks. The server tasks are specified in the system configuration of ARIS Risk and Compliance (ARIS Risk and Compliance Administration Administration > System configuration > Administration > Server task schedules). They are usually executed at night. An automated server task should be executed maximum three times a day. If you need to execute a server task more frequently, contact the support team. For training and presentations only, you can also trigger server tasks manually in ARIS Risk and Compliance (ARIS Risk and Compliance Administration Administration > Server tasks) if you have the appropriate manager role.

Server task configuration parameters always start with arcm.config.schedule.job, followed by the server task type (generator, monitor, updater), and then by the object type for which the server task is responsible, for example, arcm.config.schedule.job.generator.testcase. The cleaning server task does not have this object type appendix: arcm.config.schedule.job.cleaning. The value of a server task parameter is built up as a sequence of key value pairs, grouped by square brackets []. Key and value are separated by the pipe character (|). To change the settings of scheduled server tasks in ARIS Risk and Compliance, follow the procedure described below. For further information, see the CronTrigger documentation on the Quartz home page.

Example 3.

  • The generator server task for control tests should be started every day at 00:52. The server task is to be executed for all environments, except for the env1 environment.

    Property key:

    arcm.config.schedule.job.generator.testcase

    Value:

    [ jobitem | generatorJob ] [ startScheduler | true ] [ executionTime | 0 52 00 ? * SUN-SAT ] [ excludedEnvironments | env1] [ includedEnvironments | ] [ objecttypes | TESTCASE ]

  • The monitor server task for risk assessments is to be started Monday to Friday at 08:00 and 18:00. The server task is to be executed only for the env1 environment.

    Property key:

    arcm.config.schedule.job.monitor.riskassessment

    Value:

    [ jobitem | monitorJob ] [ startScheduler | true ] [ executionTime | 0 0 8,18 ? * MON-FRI ] [ excludedEnvironments | ] [ includedEnvironments | env2] [ objecttypes | RISKASSESSMENT ]



Meaning of the individual parameters

Jobitem

The server task to be executed. The parameter value must correspond to an EnumItem ID from the jobs enumeration in the enumerations.xml file.

startScheduler

The value must be true so that the time control for this server task is active.

executionTime

This expression specifies when the server task should be started. It has the format CronTrigger that allows the specification of time intervals. The individual values mean the following from left to right:

  • Seconds (0-59)

  • Minutes (0-59)

  • Hours (0-23)

  • Day of month (1-31 or question mark (?) for any calendar day of the month)

  • Month (1-12, JAN-DEC, or asterisk (*) for any month)

  • Day of week (1-7 or SUN-SAT)

  • Year (can be empty, 1984, 1970-2099, ...)

excludedEnvironments

The environments in the ARIS Risk and Compliance database for which the server task should not be executed are listed here. The values can be specified separated by commas. This applies to environment-specific server tasks only.

includedEnvironments

The environments in the ARIS Risk and Compliance database for which the server task should be executed are listed here. If no value is specified, a separate server task is started for each individual environment. The values can be specified separated by commas. This applies to environment-specific server tasks only.

Objecttypes

The object types for which the server task should be executed. In the example above, this instance of the monitoring server task should check only the control tests. The values can be specified separated by commas.

Configure scheduled server tasks

Prerequisite

You have system administrator privileges in ARIS Risk and Compliance.

Procedure. Procedure

  1. Click ARIS Risk and Compliance Administration Administration. The General menu item is displayed initially.

  2. Under System management, click System configuration. The configuration parameters are displayed.

  3. In the filter (Filter), click Administration > Server task schedules. The parameters are displayed.

  4. Click Edit object Edit in the row of the parameter you want to change. The Specify parameter value dialog opens.

  5. Copy the Current value to the clipboard. For example:

    [ jobitem | generatorJob ] [ startScheduler | true ] [ executionTime | 0 52 00 ? * SUN-SAT ] [ excludedEnvironments | ] [ includedEnvironments | ] [ objecttypes | TESTCASE ]

  6. Paste it into a text editor and make the relevant changes, for example, change the execution time. For example:

    [ jobitem | generatorJob ] [ startScheduler | true ] [ executionTime | 0 0 8-18 ? * MON-FRI ] [ excludedEnvironments | ] [ includedEnvironments | ] [ objecttypes | TESTCASE ]

  7. Copy the modified parameter value to the clipboard, then paste it into the New value text box.

    Make sure that you always copy and paste the complete string. It does not work to use only the part of the string you want to adapt, for example, [ executionTime | 0 0 8-18 ? * MON-FRI ].

  8. Click OK.

The changes are immediately applied and stored in the database. Click Cancel Reset in the row of the relevant parameter to return to the default value.