Differences

This shows you the differences between two versions of the page.

--- rdms:webapp:processes [2025/03/18 09:40] – heading level jelte
+++ rdms:webapp:processes [2025/09/23 13:47] (current) – some small text changes jelte
@@ Line 1: / Line 1: @@
-====== Processes/Jobs ======
+====== Processes and Jobs ======
 {{indexmenu_n>5}}
-The RDMS web interface allows you to observe certain processes/jobs that you do via the web interface. For that, the //Processes/jobs// view on the left-side menu can be used. Moreover, this view allows you to observe the status of your //Delayed Rules//, a concept that will be explained in this section as well.
+The RDMS web interface allows you to observe the status of the processes/jobs that you started via the web interface. For that, you can use the "Processes/jobs" view on the left-side Menu bar. Moreover, this view allows you to observe the status of your **delayed rules**, a concept that will be explained in this section as well.
-{{ :rdms:webapp:rdms_procces_0.png?direct&800 |}}
+{{ :rdms:webapp:rdms_procces_0.png?direct&850 |}}
+===== Processes/Jobs in the Web Interface =====
+If you perform certain operations in the RDMS web interface, these get registered as processes. The status of these processes can be observed here.
+Currently, the following operations are visible as processes:
+  - Uploading of data via the web interface.
+  - Bundling operations (compress to tar or decompress).
+  - Extraction of metadata.
+  - Different steps of the [[rdms:workflows:archiving|Archiving Workflow]].
+By clicking on a listed process, you can get more details about it, as shown below.
+{{ :rdms:webapp:rdms_procces_4.png?direct&850 |}}
+For example, this view can show you the kind of process and the data on which it was executed. Moreover, every process gets a process number as well as an ID. You can use the ID to correlate the job to a delayed rule (see below), if applicable.
+**Note:** Not all jobs are executed as delayed rules, as will be described below. For example, the upload operation will not be triggered as a delayed rule, but the computation of the data checksum following the upload will be executed as a delayed rule in the background.
-===== Proccesses/Jobs in the Web Interface =====
 ===== Delayed Rules =====
+The RDMS is built on top of the data management software [[https://irods.org/|iRODS]]. The iRODS system has the built-in capability to execute certain tasks when a certain event is registered in the system. These automated tasks are called **rules** and they can be delayed, meaning being queued and executed in the background even if the user is not logged in anymore.
+We use rules in several places in the RDMS, often as delayed rules. Important examples of delayed rules are:
+  * **Automated checksum calculations of your data**: If you upload files to the RDMS, an automated checksum calculation for your files will be executed as a delayed rule. This guarantees that all your files have a checksum registered, which gives you and us the capability to check the [[rdms:data:integrity|integrity of your data]].
+  * **Bundling/Unbundling via the web interface**: If you use the function to compress a folder to a tar archive or to decompress a archive, it will also be executed as a delayed rule.
+You can observe the status of your rules via the second tab in the processes/jobs view.
+{{ :rdms:webapp:rdms_procces_5.png?direct&850 |}}
+The RDMS process ID (highlighted in red) is visible for every delayed rule, which allows you to correlate a job with its respective delayed rule. For example, in the screenshots above, you can see that the process ID is the same for both the delayed rule and for the related job presented in the section above.
+The example we show above is a delayed rule linked to the creation of a tar archive (data bundling). You will notice that below the first line (see ID:), a **Priority** of 9 is assigned to this rule. The RDMS assigns **priority 9** to all the delayed rules that **should be executed first**, **priority 5** to delayed rules that have **medium priority**, and finally **priority 1** to all the rules that should be **queued last** (i.e., checksum calculations).
+{{ :rdms:webapp:rdms_procces_8.png?direct&850 |}}
+The priorities are set such that critical tasks, tasks initiated manually by the user, and tasks that are part of a [[..:workflows:|workflow]] are allowed to jump the queue and be executed before tasks that are not essential to the functioning of the system, numerous, common, and automatically scheduled. For example, it is important that the checksum of a file is calculated after the file is uploaded, but this calculation should not stop the archiving workflow from moving to the next step. Even if the file was uploaded way before the workflow started, the calculation of the checksum is given minimal priority, so that it may happen when the system is mostly idle.
+You can also check the status of delayed rules via the CLI tool [[rdms:access:linux:icommands|iCommands]] using the ''iqstat'' command, which shows the user's delayed rules that await execution.
+{{ :rdms:webapp:rdms_procces_9.png?direct&850 |}}