aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2009-05-16 10:23:24 +0300
committerSergey Poznyakoff <gray@gnu.org.ua>2009-05-16 10:24:16 +0300
commit5e2bb39d15949292bca19362eb8821b8bbee1b88 (patch)
tree3007b0ef5d9e7fe4f06aaf721edb728618e39355
parent168463b46dd58dd24009f2aacef604bab01300a5 (diff)
downloadgrot-5e2bb39d15949292bca19362eb8821b8bbee1b88.tar.gz
grot-5e2bb39d15949292bca19362eb8821b8bbee1b88.tar.bz2
Finish the docs
-rw-r--r--cmdline.opt2
-rw-r--r--grot.126
-rw-r--r--grot.cfg.52
3 files changed, 26 insertions, 4 deletions
diff --git a/cmdline.opt b/cmdline.opt
index 16956d7..151dfb4 100644
--- a/cmdline.opt
+++ b/cmdline.opt
@@ -92,3 +92,3 @@ END
OPTION(keep,k,NUMBER,
- [<keep NUMBER of files before oldest>])
+ [<keep NUMBER of files before the oldest>])
BEGIN
diff --git a/grot.1 b/grot.1
index 95e1d4f..c2582a4 100644
--- a/grot.1
+++ b/grot.1
@@ -15,3 +15,3 @@
.\" along with grot. If not, see <http://www.gnu.org/licenses/>.
-.TH grot "1" "May 15, 2009" "grot (grot 1.0)" "User Commands"
+.TH grot "1" "May 16, 2009" "grot (grot 1.0)" "System Administrator's Manual"
.SH NAME
@@ -41,3 +41,24 @@ grot \- Gray's Rotation Tool for MySQL binary logs
.SH DESCRIPTION
-\fBGrot\fR rotates MySQL binary log files.
+\fBGrot\fR rotates MySQL binary log files on replication master
+server. It works by first determining what slaves are connected to
+the server. Then it connects to each slave and determines what
+master log file it currently uses. Finally, it removes those logs
+on master that are older than the oldest of logs used by slaves.
+
+Normally, \fBgrot\fR is executed as a cron job. It is not necessary
+to run it on the master server, it may as well be run on any machine
+that can connect to the master SQL.
+
+An account must be set up on master and each of the slaves for
+\fBgrot\fR to operate. The account on master must have the
+\fBSUPER\fR, \fBPROCESS\fR and \fBRELOAD\fRprivileges. However, the
+latter is not necessary if you use the \fB\-\-no\-flush\fR command
+line option.
+
+The slave accounts must be granted the \fBREPLICATION CLIENT\fR
+privilege.
+
+\fBGrot\fR uses configuration files to obtain the connection
+parameters and account credentials of the master and slave servers.
+See below for a descripton of these.
@@ -110,2 +131,3 @@ This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
+
.\" Local variables:
diff --git a/grot.cfg.5 b/grot.cfg.5
index 56e12eb..334b0d4 100644
--- a/grot.cfg.5
+++ b/grot.cfg.5
@@ -15,3 +15,3 @@
.\" along with grot. If not, see <http://www.gnu.org/licenses/>.
-.TH grot.cfg "5" "May 15, 2009" "grot (grot 1.0)"
+.TH grot.cfg "5" "May 16, 2009" "grot (grot 1.0)" "System Administrator's Manual"
.SH NAME

Return to:

Send suggestions and report system problems to the System administrator.