Understanding Job Runs
Overview
Notion of Job Runs was introduced in Resilio Connect v.2.5.0.
All jobs, apart from Sync Job, have a finite runtime with a specific moment when it can be considered as finished - successful, aborted or failed. Job Run is basically the Job execution from its start to end, during which the configured file delivery is performed and/or scripts are executed. Each Job Run is numerated.
First launch of a newly created job gets #1 index and then it's incremented upon each Job restart. All Job Runs appear on tab JOBS and consist of Job name and the index. When a Job is finished and then restarted, a new Job Run appears.
Job Runs only show the current run of a Job and allow to watch the process of job execution, see the result. Job Run is not designed to allow editing a Job - you can edit only the Job itself on "Configure Jobs" tab and restart it, new Job Run will appear.
How to use it
Start a job
To start a new Job run click on "Start Job" button. It opens a list of jobs. A
Job cannot have several active Job Runs. If a selected job already has a Run,
corresponding warning will appear.
About Synchronization Job Runs
Synchronization Job is a special type of job. It has its peculiarities due to the fact that it's the ongoing synchronization that does not have any 'finish' state. It means that even though the Job Run can have status "Synced", the Job itself will still have status "Running". Sync Job can have only one Job Run. If a Sync Job is updated, its Run is just moved up in the list of Job Runs.
Restarting the job run on Agents
It is possible to restart an already finished (aborted) Job Run. There are two ways to do it depending on the final goal:
- To restart the job run on all agents in the job: select a job run that you want to restart and click "Start job". The new job run will inherit parameters from the Job itself.
- To restart the job run on some Agents only: open a finished job run details and go to Agents tab, select the wanted agents and click 'Restart on agents'. Source Agent must be selected. For more information, see Restarting the job on Agents.
Job Run details
Clicking a Job Run opens its details. It gives a clear way to see the status of each agent and overall progress of the job.
Overview Shows the general information about Job Run for the given working moment or result of its completion. For more information, see Dashboard Performance Monitoring.
Statistics Charts are depicting current speed, files and bytes synced, network failures. These are most useful to watch for an active Run as they work in real-time mode.
Agents Shows the state of each agent for the moment of run completion. Thus some agents may show up as offline there, cause they indeed where offline when run stopped, even though the agent is now online. From here one can add more agents to the Run (only to an active job run), remove some agents, or restart the finished Run on some of them, or watch the Agent's event log.
File query
Appears in Resilio Connect v3.7.0. Allows to inspect files state in the job by sending a configured request to the Agents. For more information, see File query in a Job Run.
Logs Shows the event logs for this Run. These are events recorded by all agents in the logs, and are masked by "Console's events level" parameter in Job's profile.