KCC: clarify setup-vertices docstring, remove TODO
[Samba.git] / ctdb / config / statd-callout
blob347af41a7cd5fdc9a84c3d9f95f1abca068ed07f
1 #!/bin/sh
3 # This must run as root as CTDB tool commands need to access CTDB socket
4 [ $(id -u) -eq 0 ] || exec sudo "$0" "$@"
6 # this script needs to be installed so that statd points to it with the -H
7 # command line argument. The easiest way to do that is to put something like this in
8 # /etc/sysconfig/nfs:
9 # STATD_HOSTNAME="myhostname -H /etc/ctdb/statd-callout"
11 [ -n "$CTDB_BASE" ] || \
12 export CTDB_BASE=$(cd -P $(dirname "$0") ; echo "$PWD")
14 . $CTDB_BASE/functions
16 # Overwrite this so we get some logging
17 die ()
19 script_log "statd-callout" "$@"
20 exit 1
23 loadconfig ctdb
24 loadconfig nfs
26 [ -n "$NFS_HOSTNAME" ] || \
27 die "NFS_HOSTNAME is not configured. statd-callout failed"
29 # A handy newline
30 nl="
33 ctdb_setup_service_state_dir "statd-callout"
35 cd "$service_state_dir" || \
36 die "Failed to change directory to \"${service_state_dir}\""
38 case "$1" in
39 # Keep a single file to keep track of the last "add-client" or
40 # "del-client'. These get pushed to ctdb.tdb during "update",
41 # which will generally be run once each "monitor" cycle. In this
42 # way we avoid scalability problems with flood of persistent
43 # transactions after a "notify" when all the clients re-take their
44 # locks.
46 add-client)
47 # statd does not tell us to which IP the client connected so
48 # we must add it to all the IPs that we serve
49 cip="$2"
50 ctdb_get_pnn
51 date=$(date '+%s')
52 ctdb ip -X |
53 tail -n +2 |
54 while IFS="|" read x sip node x ; do
55 [ "$node" = "$pnn" ] || continue # not us
56 key="statd-state@${sip}@${cip}"
57 echo "\"${key}\" \"${date}\"" >"$key"
58 done
61 del-client)
62 # statd does not tell us from which IP the client disconnected
63 # so we must add it to all the IPs that we serve
64 cip="$2"
65 ctdb_get_pnn
66 ctdb ip -X |
67 tail -n +2 |
68 while IFS="|" read x sip node x ; do
69 [ "$node" = "$pnn" ] || continue # not us
70 key="statd-state@${sip}@${cip}"
71 echo "\"${key}\" \"\"" >"$key"
72 done
75 update)
76 files=$(echo statd-state@*)
77 if [ "$files" = "statd-state@*" ] ; then
78 # No files!
79 exit 0
81 # Filter out lines for any IP addresses that are not currently
82 # hosted public IP addresses.
83 ctdb_get_pnn
84 ctdb_ips=$(ctdb ip | tail -n +2)
85 sed_expr=$(echo "$ctdb_ips" |
86 awk -v pnn=$pnn 'pnn == $2 { \
87 ip = $1; gsub(/\./, "\\.", ip); \
88 printf "/statd-state@%s@/p\n", ip }')
89 if cat $files | sed -n "$sed_expr" | ctdb ptrans "ctdb.tdb" ; then
90 rm $files
94 notify)
95 # we must restart the lockmanager (on all nodes) so that we get
96 # a clusterwide grace period (so other clients dont take out
97 # conflicting locks through other nodes before all locks have been
98 # reclaimed)
100 # we need these settings to make sure that no tcp connections survive
101 # across a very fast failover/failback
102 #echo 10 > /proc/sys/net/ipv4/tcp_fin_timeout
103 #echo 0 > /proc/sys/net/ipv4/tcp_max_tw_buckets
104 #echo 0 > /proc/sys/net/ipv4/tcp_max_orphans
106 # Delete the notification list for statd, we dont want it to
107 # ping any clients
108 rm -f /var/lib/nfs/statd/sm/*
109 rm -f /var/lib/nfs/statd/sm.bak/*
111 # we must keep a monotonically increasing state variable for the entire
112 # cluster so state always increases when ip addresses fail from one
113 # node to another
114 # We use epoch and hope the nodes are close enough in clock.
115 # Even numbers mean service is shut down, odd numbers mean
116 # service is started.
117 state_even=$(( $(date '+%s') / 2 * 2))
119 # we must also let some time pass between stopping and restarting the
120 # lockmanager since othervise there is a window where the lockmanager
121 # will respond "strangely" immediately after restarting it, which
122 # causes clients to fail to reclaim the locks.
124 if [ "${CTDB_NFS_SERVER_MODE:-${NFS_SERVER_MODE}}" != "ganesha" ] ; then
125 startstop_nfslock stop >/dev/null 2>&1
126 sleep 2
127 startstop_nfslock start >/dev/null 2>&1
130 # we now need to send out additional statd notifications to ensure
131 # that clients understand that the lockmanager has restarted.
132 # we have three cases:
133 # 1, clients that ignore the ip address the stat notification came from
134 # and ONLY care about the 'name' in the notify packet.
135 # these clients ONLY work with lock failover IFF that name
136 # can be resolved into an ipaddress that matches the one used
137 # to mount the share. (==linux clients)
138 # This is handled when starting lockmanager above, but those
139 # packets are sent from the "wrong" ip address, something linux
140 # clients are ok with, buth other clients will barf at.
141 # 2, Some clients only accept statd packets IFF they come from the
142 # 'correct' ip address.
143 # 2a,Send out the notification using the 'correct' ip address and also
144 # specify the 'correct' hostname in the statd packet.
145 # Some clients require both the correct source address and also the
146 # correct name. (these clients also ONLY work if the ip addresses
147 # used to map the share can be resolved into the name returned in
148 # the notify packet.)
149 # 2b,Other clients require that the source ip address of the notify
150 # packet matches the ip address used to take out the lock.
151 # I.e. that the correct source address is used.
152 # These clients also require that the statd notify packet contains
153 # the name as the ip address used when the lock was taken out.
155 # Both 2a and 2b are commonly used in lockmanagers since they maximize
156 # probability that the client will accept the statd notify packet and
157 # not just ignore it.
158 # For all IPs we serve, collect info and push to the config database
159 ctdb_get_pnn
161 # Construct a sed expression to take catdb output and produce pairs of:
162 # server-IP client-IP
163 # but only for the server-IPs that are hosted on this node.
164 ctdb_all_ips=$(ctdb ip -n all | tail -n +2)
165 sed_expr=$(echo "$ctdb_all_ips" |
166 awk -v pnn=$pnn 'pnn == $2 { \
167 ip = $1; gsub(/\./, "\\.", ip); \
168 printf "s/^key.*=.*statd-state@\\(%s\\)@\\([^\"]*\\).*/\\1 \\2/p\n", ip }')
170 statd_state=$(ctdb catdb ctdb.tdb | sed -n "$sed_expr" | sort)
171 [ -n "$statd_state" ] || exit 0
173 prev=""
174 echo "$statd_state" | {
175 # This all needs to be in the same command group at the
176 # end of the pipe so it doesn't get lost when the loop
177 # completes.
178 items=""
179 while read sip cip ; do
180 # Collect item to delete from the DB
181 key="statd-state@${sip}@${cip}"
182 item="\"${key}\" \"\""
183 items="${items}${items:+${nl}}${item}"
185 # NOTE: Consider optimising smnotify to read all the
186 # data from stdin and then run it in the background.
188 # Reset stateval for each serverip
189 [ "$sip" = "$prev" ] || stateval="$state_even"
190 # Send notifies for server shutdown
191 smnotify --client=$cip --ip=$sip --server=$sip --stateval=$stateval
192 smnotify --client=$cip --ip=$sip --server=$NFS_HOSTNAME --stateval=$stateval
193 # Send notifies for server startup
194 stateval=$(($stateval + 1))
195 smnotify --client=$cip --ip=$sip --server=$sip --stateval=$stateval
196 smnotify --client=$cip --ip=$sip --server=$NFS_HOSTNAME --stateval=$stateval
197 done
199 echo "$items" | ctdb ptrans "ctdb.tdb"
202 # Remove any stale touch files (i.e. for IPs not currently
203 # hosted on this node and created since the last "update").
204 # There's nothing else we can do with them at this stage.
205 echo "$ctdb_all_ips" |
206 awk -v pnn=$pnn 'pnn != $2 { print $1 }' |
207 while read sip ; do
208 rm -f "statd-state@${sip}@"*
209 done
211 esac