Project

General

Profile

Actions

Documentation #47142

closed

docs: explain the difference between services and daemons

Added by Zac Dover over 3 years ago. Updated over 2 years ago.

Status:
Resolved
Priority:
Normal
Category:
-
Target version:
-
% Done:

0%

Tags:
documentation
Backport:
Reviewed:
Affected Versions:
Pull request ID:

Description

26 Aug 2020, ~1700 AEST:
<wowas> https://tracker.ceph.com/issues/46082 (...)`orch ps` will list the cephadm daemons, whereas `orch ls` should be used to list the cephadm services.(...)
<wowas> whats the f*** difference?! :D I always thought services and daemons are the same thing :)
<cervigni> wowas: ahah I don't know... ceph is not really famous to write doco in a correct way
<cervigni> try to ask zdover
<cervigni> apparently you can blame him for anything doco related, isn't it zdover ?

Actions #2

Updated by Zac Dover over 3 years ago

Sebastian Wagner wrote:

https://docs.ceph.com/docs/master/mgr/orchestrator/#orchestrator-cli ??

That's a good find, but at the minimum we can make this text clearer:

A logical service, Typically comprised of multiple service instances on multiple hosts for HA
fs_name for mds type
rgw_zone for rgw type
ganesha_cluster_id for nfs type

and

A single instance of a service. Usually a daemon, but maybe not (e.g., might be a kernel service like LIO or knfsd or whatever)
This identifier should uniquely identify the instance
Actions #3

Updated by Sebastian Wagner over 3 years ago

Let's define things for cephadm a bit more in detail:

  • a service_type is something like mon, mgr, alertmanager etc.
  • a service_id is the name of the service. Some services don't have names.
  • a service_name is <service_type>.<service_id>
  • a daemon_type is the same as the service_type
  • a daemon_id is typically <service_id>.<hostname>.<random-string>. (Not the case for e.g. OSDs. OSDs are always called OSD.N)
  • a daemon_name is <daemon_type>.<daemon_id>
Actions #4

Updated by Nathan Cutler over 3 years ago

While the previous comment has a technical definition of various terms, it doesn't make clear the difference between a "service" and a "daemon". This distinction is easy to understand, though:

A service (e.g. "osd service", "mon service", etc.) is a cluster-wide term meaning all daemons of a given type (e.g. "osd", "mon", etc.), no matter where they happen to be in the cluster.

A daemon (e.g. "osd daemon") is just that: an individual daemon supposed to be running on a cluster node.

Actions #5

Updated by Juan Miguel Olmo Martínez about 3 years ago

  • Tracker changed from Bug to Documentation
Actions #6

Updated by Sebastian Wagner almost 3 years ago

  • Status changed from New to Fix Under Review
  • Assignee changed from Zac Dover to Sebastian Wagner
  • Pull request ID set to 42209
Actions #7

Updated by Sebastian Wagner over 2 years ago

  • Status changed from Fix Under Review to Resolved
Actions

Also available in: Atom PDF