1cmannotifyd(8)             CMAN Notification Daemon             cmannotifyd(8)
2
3
4

NAME

6       cmannotifyd - CMAN Notification Daemon
7

SYNOPSIS

9       cmannotifyd [-f] [-d]
10

DESCRIPTION

12       The cmannotifyd daemon talks to CMAN and provides a mechanism to notify
13       external entities about cluster changes.
14
15       CMAN dispatches 3 kind of notifications:
16
17       - CMAN_REASON_TRY_SHUTDOWN when cman requests to all clients if  it  is
18       allowed to shutdown.
19
20       -  CMAN_REASON_STATECHANGE  when cman detects a node joining or leaving
21       the cluster.
22
23       - CMAN_REASON_CONFIG_UPDATE when a configuration change event has  been
24       detected/requested.
25
26       These notifications are then dispatched to the shell script cman_notify
27       in the environment variable CMAN_NOTIFICATION.
28
29       cman_notify will then execute all the scripts in the configured notifi‐
30       cation  directory  (default: /etc/cluster/cman-notify.d) passing a very
31       minimal set of envvars including,  of  course,  the  CMAN_NOTIFICATION=
32       type.  The execution order is set by the filename as shown by "LC_ALL=C
33       ls -las".
34
35       cmannotifyd logs are stored in the  default  log  file  (/var/log/clus‐
36       ter/cmannotifyd.log).
37
38       cman_notify  logs  are  stored  in the default log file (/var/log/clus‐
39       ter/cman_notify.log). By default the output from the  scripts  executed
40       by  cman_notify  is  redirected  to  /dev/null.   Users  can either set
41       CMAN_NOTIFICATION_DEBUG=1 in their environment or set proper debug con‐
42       figuration   in   cluster.conf   to  redirect  scripts  output  to  the
43       cman_notify log file.
44
45

NOTES

47       cmannotifyd does not block on cman_notify nor check the exit status  of
48       the script.
49
50       Notifications  are  dispatched in the same order as they arrive, one by
51       one.
52
53       CMAN_REASON_TRY_SHUTDOWN is passed to  scripts  for  information  only,
54       they  can  not  influence  cman's  decsion about whether or not to shut
55       down.
56
57       CMAN_REASON_STATECHANGE also implies CMAN_NOTIFICATION_QUORUM  exported
58       in the environment. CMAN_NOTIFICATION_QUORUM will be set to 1 (when the
59       node is part of a quorate cluster) or 0 (otherwise).
60
61       A template for cman_notify scripts can be found in the doc/ directory.
62
63

OPTIONS

65       -f     Run in the foreground (do not fork / daemonize).
66
67       -d     Enable debug output.
68
69
70
71                                 November 2008                  cmannotifyd(8)