View Issue Details
|ID||Project||Category||View Status||Date Submitted||Last Update|
|0000886||bareos-core||director||public||2017-12-27 09:14||2023-09-13 11:57|
|Summary||0000886: "Run Before Job" in JobDefs is run even though a backup job specifies a different "Run Before Job"|
|Description||My JobDefs file specifies a script that is to be run before a backup job. This is valid for nearly all of my jobs. However, one backup job should not run that script; instead, I want to run a different script before running that backup. So in that one specific backup job definition, I override the default from JobDefs with a different script. But the JobDefs script still gets run anyway.|
|Steps To Reproduce||Create a JobDefs with a "Run Before Job" set to run "script1."|
Create one or more jobs (e.g., maybe "job-general1," "job-general2," "job-general3") for the general case, not setting "Run Before Job" in those, allowing the setting to default to the one specified in JobDefs (i.e., "script1").
Create one job for a specific case ("job-special"), setting "Run Before Job" to "script2."
Run any of the general case jobs ("job-general1," etc.) and "script1" is correctly run, since no override is specified for any of those jobs.
Run "job-special" and BOTH script1 AND script2 are run before the job.
|Additional Information||From the documentation, section 9.3, "Only the changes from the defaults need to be mentioned in each Job." (http://doc.bareos.org/master/html/bareos-manual-main-reference.html#QQ2-1-216) I infer that the description of Bareos's defaulting mechanism fits the industry-standard definition of the term "default."|
Please note that this was also an issue in Bacula, and one of the (many) reasons I chose to move on to Bareos. I was told by Bacula support that I did not understand the meaning of "default," which actually, I really am sure I do. I've worked with software for over 30 years, and the documented semantics (as per section 9.3) seem to comport with general agreement about the meaning of default mechanisms. To this day, I do not think I've ever seen a single exception to the generally agreed-upon meaning of "default." Even overloading mechanisms in OO languages all appear to comport to this intention and implementation.
I hope this will not result in the same stonewalling of this issue and that this bug, while minor for the most part but potential for disaster for those unawares in other more complicated contexts, can and will be fixed in some upcoming release. Thanks.
|Tags||No tags attached.|
The "Run Before Job" directive can be specified multiple times in a resource to run multiple run scripts. So the behavior you describe is to be expected. You can extend a DefaultJob with additional run scripts.
To achieve the behavior requested by you, you might use the fact, that DefaultJobs can be used recursively.
Name = "defaultjob-without-script"
Name = "defaultjob-with-script"
JobDefs = "defaultjob-without-script"
Run Before Job = "echo 'test'"
Jobs can than either refer to "defaultjob-with-script" or "defaultjob-without-script".
How is this reflected in the documentation? I was kind of wondering if one could specify multiple JobDefs (default configurations), which would be handy. However, the documentation, as I read it, does not seem to encourage the reader to consider multiple JobDefs, as you have illustrated.
Thank you for this information, and I will DEFINITELY make use of this facility -- actually, it addresses precisely what I wanted! However, it might be a good idea to add something to the JobDefs documentation to illustrate exactly what you have shown here. Thanks.
I wonder, even had a bareos admin read every last word of the documentation, if this approach to handling job defaults would be obvious to them. This is not a criticism of the current docs; as docs go, this is one of the more complete I've seen. It's just that sometimes it takes more explanation of various options than those one might glean by reading the material quite literally as I have. I also don't believe that one will necessarily read every last bit of the documentation in the first place (though you might be within your right to claim every user really should have in order to leverage the full advantage of this extensive system). Users may be tasked with correcting or adding an urgent matter and not have time to read everything, rather heading straight to the portion of the docs seeming to be most relevant for the task at hand.
In the opening paragraph of JobDefs might be a good place to add this information. It is the place where it would be most likely NOT to be missed. Again, thanks for the info.
Already documented at http://doc.bareos.org/master/html/bareos-manual-main-reference.html#directiveDirJobJob%20Defs :
To structure the conﬁguration even more, Job Defs themselves can also refer to other Job Defs.
If you know a better way to describe this: also patches to the documentation are always welcome.
From the doc:
Any value that you explicitly deﬁne in the current Job resource, will override any defaults speciﬁed in the Job Defs resource.
That isn't quite exactly correct. What really happens is something a bit more akin to subclassing I think, albeit these "classes" are linear; there is no "multiple inheritance," so to speak (though THAT might even be useful?).
BareOS JobDefs values are not always replaced; they may be replaced, or appended instead. Appending in this manner is not typical of the way we normally speak of defaults in most of the software kingdom (at least in my own experience).
Not sure how to improve the docs, but just thought I'd put this out there: This notion of single parent subclassing. Perhaps this could lead us toward a better description.
|I tried the link in your note https://bugs.bareos.org/view.php?id=886#c2853, but it takes me to the start of the doc, not the specific section, which is what I think your link is supposed to do. Seems like a lot of links (and anchors) in the doc are broken this way. References to the bareos doc from websites (like linuxquestions) are now broken; I realize there might not be much that can be done about external references outside of bareos.org.|
A lot of stabilization in terms of links has be done in documentation since then (Including how to contribute, by proposing a PR for a change).
For example actual 22x version.
Question, would you like to propose a change?
|2017-12-27 09:14||bozonius||New Issue|
|2017-12-27 12:59||joergs||Note Added: 0002845|
|2017-12-27 12:59||joergs||Status||new => feedback|
|2017-12-27 21:30||bozonius||Note Added: 0002848|
|2017-12-27 21:30||bozonius||Status||feedback => new|
|2018-01-02 16:39||joergs||Note Added: 0002853|
|2018-01-02 16:39||joergs||Status||new => resolved|
|2018-01-02 16:39||joergs||Resolution||open => no change required|
|2018-01-02 16:39||joergs||Assigned To||=> frank|
|2018-01-02 16:53||frank||Assigned To||frank =>|
|2018-01-03 03:35||bozonius||Note Added: 0002856|
|2018-01-03 03:35||bozonius||Status||resolved => feedback|
|2018-01-03 03:35||bozonius||Resolution||no change required => reopened|
|2019-01-16 16:01||arogge||Assigned To||=> arogge|
|2019-01-16 16:01||arogge||Status||feedback => assigned|
|2019-07-10 17:49||arogge||Assigned To||arogge =>|
|2019-07-10 17:49||arogge||Status||assigned => acknowledged|
|2019-11-20 07:49||bozonius||Note Added: 0003636|
|2023-09-13 11:57||bruno-at-bareos||Assigned To||=> bruno-at-bareos|
|2023-09-13 11:57||bruno-at-bareos||Status||acknowledged => feedback|
|2023-09-13 11:57||bruno-at-bareos||Note Added: 0005434|