dribbled 0.8.0 → 0.8.1
Sign up to get free protection for your applications and to get access to all the features.
- data/README.md +47 -4
- data/lib/dribbled/version.rb +1 -1
- metadata +1 -1
data/README.md
CHANGED
|
@@ -6,11 +6,11 @@
|
|
|
6
6
|
|
|
7
7
|
# SYNOPSIS
|
|
8
8
|
|
|
9
|
-
dribbled [options] <action> [
|
|
9
|
+
dribbled [options] <action> [action_options] [action_arguments]
|
|
10
10
|
|
|
11
|
-
Actions are one of `show`, `check`, `snap`.
|
|
11
|
+
Actions are one of `show`, `check`, `watch` and `snap`.
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
General options are as follows:
|
|
14
14
|
|
|
15
15
|
General options:
|
|
16
16
|
-D, --drbdadm DRBDADM Path to drbdadm binary
|
|
@@ -32,7 +32,7 @@ With no options or arguments, `dribbled` displays help as shown above (unless ca
|
|
|
32
32
|
|
|
33
33
|
## Show
|
|
34
34
|
|
|
35
|
-
The `show` action displays information about DRBD devices in the system. This action
|
|
35
|
+
The `show` action displays information about DRBD devices in the system. This action accepts one optional argument and no options. With no arguments, it shows information about all known resources (runtime and configured):
|
|
36
36
|
|
|
37
37
|
gerir@boxie:~:dribbled show
|
|
38
38
|
0 r0 Connected UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd0 desthost /dev/drbd0
|
|
@@ -40,6 +40,49 @@ The `show` action displays information about DRBD devices in the system. This ac
|
|
|
40
40
|
5 r5 Connected UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd5 desthost /dev/drbd5
|
|
41
41
|
6 r6 SyncTarget [ 4%] Inconsistent/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
|
|
42
42
|
|
|
43
|
+
Arguments can be either a resource name or the word `version`. In the first case, it will display information about the resource specified:
|
|
44
|
+
|
|
45
|
+
gerir@boxie:~:dribbled show r0
|
|
46
|
+
0 r0 Connected UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd0 desthost /dev/drbd0
|
|
47
|
+
|
|
48
|
+
Note that the information provided about a resource is augmented with progress and estimated time to completion when the connection state is one of `SyncSource`, `SyncTarget`, `VerifyS` or `VerifyT`. The examples shown in this document only show percentages for brevity.
|
|
49
|
+
|
|
50
|
+
In the second case, it will show the DRBD version in use:
|
|
51
|
+
|
|
52
|
+
gerir@boxie:~:dribbled version
|
|
53
|
+
8.0.14
|
|
54
|
+
|
|
55
|
+
## Watch
|
|
56
|
+
|
|
57
|
+
It is sometimes useful to watch a given resources as it changes over time, for instance, as it is initialized or verified. One way to do this is running `watch -d -t -n 15 ‘dribbled show | grep Sync’`. *Dribbled* can do this by itself.
|
|
58
|
+
|
|
59
|
+
Watch Arguments
|
|
60
|
+
interval: amount of time in seconds between each report (default: 60)
|
|
61
|
+
count: number of reports to produce
|
|
62
|
+
|
|
63
|
+
Watch Options
|
|
64
|
+
-r, --resource RESOURCE Resource
|
|
65
|
+
-c, --cstate CSTATE_RE CState (partial match)
|
|
66
|
+
-d, --dstate DSTATE_RE DState (partial match)
|
|
67
|
+
|
|
68
|
+
In its simplest form:
|
|
69
|
+
|
|
70
|
+
gerir@boxie:~:dribbled watch 15
|
|
71
|
+
6 r6 SyncTarget [ 4%] Inconsistent/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
|
|
72
|
+
6 r6 SyncTarget [ 6%] Inconsistent/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
|
|
73
|
+
6 r6 SyncTarget [ 8%] Inconsistent/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
|
|
74
|
+
6 r6 SyncTarget [ 10%] Inconsistent/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
|
|
75
|
+
|
|
76
|
+
By default, `dribbled` will match resources where the connection state is `Sync` and the disk state is `Inconsistent` (as regular expressions). To watch resources being verified:
|
|
77
|
+
|
|
78
|
+
gerir@boxie:~:dribbled watch -c Verify 15
|
|
79
|
+
6 r6 VerifyS [ 8%] UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
|
|
80
|
+
6 r6 VerifyS [ 10%] UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
|
|
81
|
+
6 r6 VerifyS [ 13%] UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
|
|
82
|
+
6 r6 VerifyS [ 15%] UpToDate/UpToDate Secondary/Primary sourcehost /dev/drbd6 desthost /dev/drbd6
|
|
83
|
+
|
|
84
|
+
The interval is specified in seconds, and defaults to 60. An optional second argument can be provided and specifies a count of iterations.
|
|
85
|
+
|
|
43
86
|
## Check
|
|
44
87
|
|
|
45
88
|
The `check` action enables Nagios plugin mode, in which a single line of output is produced on `STDOUT` with the status of the devices.
|
data/lib/dribbled/version.rb
CHANGED