Docs for daemons #346

labkode · 2024-07-15T14:52:03Z

Fixes #296

docs/started/daemons.md

labkode

Changes applied

docs/started/daemons.md

voetberg · 2024-07-19T22:15:56Z

docs/started/daemons.md

+
+## How is a replica declared bad?
+- An operator can declare a replica as bad issuing rucio cli commands. These bad replicas are taken by the necromancer daemon and then deleted if they cannot be recovered from other RSEs.
+- the suspicios-replica-recoverer is a daemon that will analyze different counters (transfer errors, download errors, etc ...) to mark replicas as being suspicious to have an issue. After hitting


Suggested change

- the suspicios-replica-recoverer is a daemon that will analyze different counters (transfer errors, download errors, etc ...) to mark replicas as being suspicious to have an issue. After hitting

- The suspicious-replica-recoverer is a daemon that will analyze different counters (transfer errors, download errors, etc ...) to mark replicas as being suspicious to have an issue. After hitting

Still misspelled

docs/started/daemons.md

labkode · 2024-11-12T14:35:58Z

@rdimaio @voetberg changes applied, thanks for your suggestions.

voetberg · 2024-11-12T21:24:55Z

docs/started/daemons.md

+
+## Daemons
+
+Name | Domain|  Purpose |  Details


I think this will be the last nit-pick. Is it is possible to set the links in Details up with the a relative path? Using this method will redirect the user to a different site to look at the executable page if they are looking at the gh docs mirror.

voetberg · 2024-11-12T21:27:03Z

docs/started/daemons.md

+a certain limit (configurable), the replica is marked as bad and eventually consumed by the necromancer.
+
+## What is the purpose of undertaker?
+A dataset is "never" deleted, however, when the dataset is known to be bad, there is no point having it in the catalog. The undertaker daemon takes care to remove these datasets.


Suggested change

A dataset is "never" deleted, however, when the dataset is known to be bad, there is no point having it in the catalog. The undertaker daemon takes care to remove these datasets.

A dataset is never "deleted", however, when the dataset is known to be bad, there is no point having it in the catalog. The undertaker daemon takes care to remove these datasets.

"deleted" is the specific term that isn't actually done

voetberg · 2024-11-12T21:28:32Z

docs/started/daemons.md

+Sometimes, replicas can become unhealthy. A dump is created by the dumper daemon. The auditor checks these dumps and declares replicas.
+
+## How is a replica declared bad?
+- An operator can declare a replica as bad issuing rucio cli commands. These bad replicas are taken by the necromancer daemon and then deleted if they cannot be recovered from other RSEs.


Can you add an example code block? It's useful for operators so they don't have to go diving into document.

voetberg · 2024-11-12T21:29:58Z

docs/started/daemons.md

+
+### How is data deleted?
+When replicas are healthy, the judge-cleaner will set a tombstone on replicas where the lifetime has expired. These replicas are taken by the reaper and they are deleted. 
+Sometimes, replicas can become unhealthy. A dump is created by the dumper daemon. The auditor checks these dumps and declares replicas.


Can you define "unhealthy"? It's a vague term here. I took a stab at it

Suggested change

Sometimes, replicas can become unhealthy. A dump is created by the dumper daemon. The auditor checks these dumps and declares replicas.

Sometimes, replicas can become unhealthy (either through corrupted data or incomplete transfers). A dump is created by the dumper daemon. The auditor checks these dumps and declares replicas.

voetberg · 2024-11-12T21:31:29Z

docs/index.md

@@ -27,6 +27,7 @@ and more can be found by browsing through the sub-sections of this topic.
 - [What is Rucio](started/what_is_rucio.md)
 - [Main Components](started/main_components.md)
 - [Additional Layers and Resources](started/additional_layers_and_resources.md)
+- [Rucio daemons/processes](started/daemons.md)


Suggested change

- [Rucio daemons/processes](started/daemons.md)

- [About Rucio Daemons](started/daemons.md)

voetberg · 2024-11-12T21:35:15Z

changes applied, thanks for your suggestions.

Thank you so much for dealing with this long review and making so many changes 🙏

labkode changed the title ~~draft docs for daemons~~ Docs for daemons Jul 18, 2024

labkode marked this pull request as ready for review July 18, 2024 09:16

labkode force-pushed the daemons branch 3 times, most recently from 300d24b to 910beb0 Compare July 18, 2024 09:27

labkode requested a review from bari12 July 18, 2024 09:28

rdimaio requested changes Jul 18, 2024

View reviewed changes

rdimaio reviewed Jul 18, 2024

View reviewed changes