X-Git-Url: https://review.fuel-infra.org/gitweb?a=blobdiff_plain;f=website%2Freference%2Fbasic%2Fdaemon.md;fp=website%2Freference%2Fbasic%2Fdaemon.md;h=431244aed64d0167d65f1498b1ffc6f29f8e9c43;hb=b87d2f4e68281062df1913440ca5753ae63314a9;hp=0000000000000000000000000000000000000000;hpb=ab0ea530b8ac956091f17b104ab2311336cfc250;p=packages%2Fprecise%2Fmcollective.git

diff --git a/website/reference/basic/daemon.md b/website/reference/basic/daemon.md
new file mode 100644
index 0000000..431244a
--- /dev/null
+++ b/website/reference/basic/daemon.md
@@ -0,0 +1,156 @@
+---
+layout: default
+title: Controlling the Daemon
+---
+
+The main daemon that runs on nodes keeps internal stats and supports reloading of agents and changing
+logging level without restarting.
+
+If you want to reload all the agents without restarting the daemon you can just send it signal *USR1*
+and it will reload its agents.
+
+You can send *USR2* to cycle the log level through DEBUG to FATAL and back again, just keep sending
+the signal and look at the logs.
+
+Reloading agents work in most cases though we recommend a full daemon restart in production use
+due to the nature of the ruby class loading system.  If you are changing agent contents and relying
+on the reload behavior you might end up with agents not being in a consistent state.
+
+## Obtaining daemon statistics
+
+The daemon keeps a number of statistics about its operation, you can view these using the _inventory_
+application:
+
+{% highlight console %}
+% mco inventory example.com
+   Server Statistics:
+                      Version: 2.2.0
+                   Start Time: Mon Sep 24 17:37:28 +0100 2012
+                  Config File: /etc/mcollective/server.cfg
+                  Collectives: mcollective, fr_collective
+              Main Collective: mcollective
+                   Process ID: 24473
+               Total Messages: 52339
+      Messages Passed Filters: 44118
+            Messages Filtered: 8221
+             Expired Messages: 0
+                 Replies Sent: 29850
+         Total Processor Time: 527.06 seconds
+                  System Time: 349.32 seconds
+
+.
+.
+.
+{% endhighlight %}
+
+The statistics mean:
+
+|Statistic   |Meaning                                    |
+|------------|-------------------------------------------|
+|Start Time             |Local time on the node when the daemon started|
+|Collectives            |All known collectives this agent responds on|
+|Main Collective        |The primary collective|
+|Process ID             |The process ID of the mcollectived|
+|Total Messages         |Total messages received from the middleware|
+|Messages Passed Filters|Amount of messages that was determined to be applicable to this node based on filters|
+|Messages Filtered      |Messages that did not apply to this node|
+|Expired Messages       |Received messages that had expired their TTL values|
+|Replies Sent           |Not all received messages result in replies, this counts the actual replies sent|
+|Total Processor Time   |Processor time including user and system time consumed since start|
+|System Time            |System Processor time only|
+
+You can get the raw values using the *rpcutil* agent using the *daemon_stats* action.
+
+{% highlight console %}
+% mco rpc rpcutil daemon_stats
+Discovering hosts using the mongo method .... 26
+
+ * [ ============================================================> ] 26 / 26
+
+.
+.
+.
+
+example.com
+               Agents: ["stomputil",
+                        "nrpe",
+                        "package",
+                        "rpcutil",
+                        "rndc",
+                        "urltest",
+                        "iptables",
+                        "puppetd",
+                        "discovery",
+                        "service",
+                        "eximng",
+                        "filemgr",
+                        "process"]
+          Config File: /etc/mcollective/server.cfg
+        Failed Filter: 168432
+        Passed Filter: 91231
+                  PID: 1418
+              Replies: 91127
+           Start Time: 1347545937
+              Threads: ["#<Thread:0x7f44350964f8 sleep>",
+                        "#<Thread:0x7f4434f7f538 sleep>",
+                        "#<Thread:0x7f44390ce368 sleep>",
+                        "#<Thread:0x7f44350981b8 run>"]
+                Times: {:cutime=>1111.13, :utime=>3539.21, :cstime=>1243.64, :stime=>5045.21}
+       Total Messages: 259842
+          TTL Expired: 179
+      Failed Security: 0
+   Security Validated: 259842
+              Version: 2.2.0
+
+
+Summary of Agents:
+
+          package = 26
+          process = 26
+        discovery = 26
+          service = 26
+          puppetd = 26
+          filemgr = 26
+             nrpe = 26
+          rpcutil = 26
+        stomputil = 26
+         iptables = 11
+          urltest = 7
+          libvirt = 4
+           eximng = 4
+     registration = 3
+             rndc = 3
+    angelianotify = 2
+
+Summary of Version:
+
+    2.2.0 = 26
+
+Finished processing 26 / 26 hosts in 289.20 ms
+{% endhighlight %}
+
+## Obtaining running configuration settings
+
+All configuration settings of any mcollective daemon can be retrieved using the *get_config_item*
+action of the *rpcutil* agent:
+
+{% highlight console %}
+% mco rpc rpcutil get_config_item item=collectives -I example.com
+Discovering hosts using the mongo method .... 1
+
+ * [ ============================================================> ] 1 / 1
+
+
+example.com:
+   Property: collectives
+      Value: ["mcollective", "fr_collective"]
+
+
+Summary of Value:
+
+      mcollective = 1
+    fr_collective = 1
+
+
+Finished processing 1 / 1 hosts in 59.05 ms
+{% endhighlight %}