5 commits - README.rst src/sanlock.8
by David Teigland
README.rst | 3 ++
src/sanlock.8 | 59 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 62 insertions(+)
New commits:
commit 467a97b475203e2f25423b49c6c357e73df61af8
Author: David Teigland <teigland(a)redhat.com>
Date: Tue Feb 28 15:50:52 2017 -0600
source moved to https://pagure.io/sanlock
diff --git a/README.rst b/README.rst
index 982d36d..c197d46 100644
--- a/README.rst
+++ b/README.rst
@@ -1,2 +1,3 @@
+| ``See https://pagure.io/sanlock
| ``See sanlock(8) at sanlock.git/src/sanlock.8``
| ``See wdmd(8) at sanlock.git/wdmd/wdmd.8``
commit 8a564c25c691ec01de760abb1d802a8e2f13019d
Author: David Teigland <teigland(a)redhat.com>
Date: Thu Feb 23 12:58:25 2017 -0600
sanlock: add man page info about renewal history
diff --git a/src/sanlock.8 b/src/sanlock.8
index c62edaa..25b6b49 100644
--- a/src/sanlock.8
+++ b/src/sanlock.8
@@ -563,6 +563,7 @@ added or removed. Add -h 1 to also show hosts in each lockspace.
.BR "sanlock client renewal -s" " LOCKSPACE"
Print a history of renewals with timing details.
+See the Renewal history section below.
.B sanlock client log_dump
@@ -875,6 +876,64 @@ using the ORPHAN flag (-O 1), or release the orphan lease using the ORPHAN
flag (-O 1). All orphan leases can be released by setting the lockspace
name (-s lockspace_name) with no resource name.
+.P
+
+.SS Renewal history
+
+sanlock saves a limited history of lease renewal information in each lockspace.
+See sanlock.conf renewal_history_size to set the amount of history or to
+disable (set to 0).
+
+IO times are measured in delta lease renewal (each delta lease renewal
+includes one read and one write).
+
+For each successful renewal, a record is saved that includes:
+.IP \[bu] 2
+the timestamp written in the delta lease by the renewal
+.IP \[bu] 2
+the time in milliseconds taken by the delta lease read
+.IP \[bu] 2
+the time in milliseconds taken by the delta lease write
+
+.P
+
+Also counted and recorded are the number io timeouts and
+other io errors that occur between successful renewals.
+
+Two consecutive successful renewals would be recorded as:
+.br
+.nf
+timestamp=5332 read_ms=482 write_ms=5525 next_timeouts=0 next_errors=0
+timestamp=5353 read_ms=99 write_ms=3161 next_timeouts=0 next_errors=0
+.fi
+
+Those fields are:
+
+.IP \[bu] 2
+timestamp is the value written into the delta lease during
+that renewal.
+
+.IP \[bu] 2
+read_ms/write_ms are the milliseconds taken for the renewal
+read/write ios.
+
+.IP \[bu] 2
+next_timeouts are the number of io timeouts that occured
+after the renewal recorded on that line, and before the next
+successful renewal on the following line.
+
+.IP \[bu] 2
+next_errors are the number of io errors (not timeouts) that
+occured after renewal recorded on that line, and before the
+next successful renewal on the following line.
+
+.P
+
+The command 'sanlock client renewal -s lockspace_name' reports
+the full history of renewals saved by sanlock, which by default
+is 180 records, about 1 hour of history when using a 20 second
+renewal interval for a 10 second io timeout.
+
.SH INTERNALS
.SS Disk Format
commit 9d2828a4e14baeb5cfee343ee2486982b538830d
Author: David Teigland <teigland(a)redhat.com>
Date: Thu Feb 23 11:31:51 2017 -0600
update test readme
diff --git a/README.rst b/README.rst
index 5e0b89b..982d36d 100644
--- a/README.rst
+++ b/README.rst
@@ -1,2 +1,2 @@
-``See sanlock(8) at sanlock.git/src/sanlock.8``
-``See wdmd(8) at sanlock.git/wdmd/wdmd.8``
+| ``See sanlock(8) at sanlock.git/src/sanlock.8``
+| ``See wdmd(8) at sanlock.git/wdmd/wdmd.8``
commit 05b15e19f215b1b34207cc7e5eb2fc2a36898ef3
Author: David Teigland <teigland(a)redhat.com>
Date: Thu Feb 23 11:29:54 2017 -0600
update test readme
diff --git a/README.rst b/README.rst
index 557c416..5e0b89b 100644
--- a/README.rst
+++ b/README.rst
@@ -1,4 +1,2 @@
-``
-See sanlock(8) at sanlock.git/src/sanlock.8
-See wdmd(8) at sanlock.git/wdmd/wdmd.8
-``
+``See sanlock(8) at sanlock.git/src/sanlock.8``
+``See wdmd(8) at sanlock.git/wdmd/wdmd.8``
commit 714d6854a46f1276b87389a2048e8e2ad9c76197
Author: David Teigland <teigland(a)redhat.com>
Date: Thu Feb 23 11:28:10 2017 -0600
add test readme
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..557c416
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,4 @@
+``
+See sanlock(8) at sanlock.git/src/sanlock.8
+See wdmd(8) at sanlock.git/wdmd/wdmd.8
+``
6 years, 9 months
[sanlock] branch master updated (8a564c2 -> 467a97b)
by git repository hosting
This is an automated email from the git hooks/post-receive script.
teigland pushed a change to branch master
in repository sanlock.
from 8a564c2 sanlock: add man page info about renewal history
new 467a97b source moved to https://pagure.io/sanlock
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "adds" were already present in the repository and have only
been added to this reference.
Summary of changes:
README.rst | 1 +
1 file changed, 1 insertion(+)
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
6 years, 9 months
[sanlock] branch master updated (9d2828a -> 8a564c2)
by git repository hosting
This is an automated email from the git hooks/post-receive script.
teigland pushed a change to branch master
in repository sanlock.
from 9d2828a update test readme
new 8a564c2 sanlock: add man page info about renewal history
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "adds" were already present in the repository and have only
been added to this reference.
Summary of changes:
src/sanlock.8 | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 59 insertions(+)
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
6 years, 9 months
[sanlock] branch master updated (05b15e1 -> 9d2828a)
by git repository hosting
This is an automated email from the git hooks/post-receive script.
teigland pushed a change to branch master
in repository sanlock.
from 05b15e1 update test readme
new 9d2828a update test readme
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "adds" were already present in the repository and have only
been added to this reference.
Summary of changes:
README.rst | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
6 years, 9 months
[sanlock] branch master updated (714d685 -> 05b15e1)
by git repository hosting
This is an automated email from the git hooks/post-receive script.
teigland pushed a change to branch master
in repository sanlock.
from 714d685 add test readme
new 05b15e1 update test readme
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "adds" were already present in the repository and have only
been added to this reference.
Summary of changes:
README.rst | 6 ++----
1 file changed, 2 insertions(+), 4 deletions(-)
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
6 years, 9 months
[sanlock] branch master updated (b79bd2a -> 714d685)
by git repository hosting
This is an automated email from the git hooks/post-receive script.
teigland pushed a change to branch master
in repository sanlock.
from b79bd2a python: Use error description in SanlockException
new 714d685 add test readme
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "adds" were already present in the repository and have only
been added to this reference.
Summary of changes:
README.rst | 4 ++++
1 file changed, 4 insertions(+)
create mode 100644 README.rst
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
6 years, 9 months