~percona-toolkit-dev/percona-toolkit/docu-ptc-rbr-limitation

« back to all changes in this revision

Viewing changes to docs/user/pt-mext.rst

  • Committer: Daniel Nichter
  • Date: 2011-07-14 19:08:47 UTC
  • Revision ID: daniel@percona.com-20110714190847-lggalkuvdrh7c4jp
Add standard pkg files (COPYING, README, etc.), percona-toolkit.pod, and user docs.  Remove dev/docs/html.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
 
 
2
#######
 
3
pt-mext
 
4
#######
 
5
 
 
6
.. highlight:: perl
 
7
 
 
8
 
 
9
****
 
10
NAME
 
11
****
 
12
 
 
13
 
 
14
pt-mext - Aggregate and summarize mysqladmin extended output.
 
15
 
 
16
 
 
17
********
 
18
SYNOPSIS
 
19
********
 
20
 
 
21
 
 
22
Usage: pt-mext [OPTION...]
 
23
 
 
24
 
 
25
***********
 
26
DESCRIPTION
 
27
***********
 
28
 
 
29
 
 
30
pt-mext aggregates and summarizes mysqladmin extended output.
 
31
 
 
32
 
 
33
***********
 
34
DOWNLOADING
 
35
***********
 
36
 
 
37
 
 
38
Visit `http://www.percona.com/software/ <http://www.percona.com/software/>`_ to download the latest release of
 
39
Percona Toolkit.  Or, to get the latest release from the command line:
 
40
 
 
41
 
 
42
.. code-block:: perl
 
43
 
 
44
    wget percona.com/latest/percona-toolkit/PKG
 
45
 
 
46
 
 
47
Replace \ ``PKG``\  with \ ``tar``\ , \ ``rpm``\ , or \ ``deb``\  to download the package in that
 
48
format.  You can also get individual tools from the latest release:
 
49
 
 
50
 
 
51
.. code-block:: perl
 
52
 
 
53
    wget percona.com/latest/percona-toolkit/TOOL
 
54
 
 
55
 
 
56
Replace \ ``TOOL``\  with the name of any tool.
 
57
 
 
58
 
 
59
***********
 
60
ENVIRONMENT
 
61
***********
 
62
 
 
63
 
 
64
The environment variable \ ``PTDEBUG``\  enables verbose debugging output to STDERR.
 
65
To enable debugging and capture all output to a file, run the tool like:
 
66
 
 
67
 
 
68
.. code-block:: perl
 
69
 
 
70
    PTDEBUG=1 pt-mext ... > FILE 2>&1
 
71
 
 
72
 
 
73
Be careful: debugging output is voluminous and can generate several megabytes
 
74
of output.
 
75
 
 
76
 
 
77
*******************
 
78
SYSTEM REQUIREMENTS
 
79
*******************
 
80
 
 
81
 
 
82
You need Bash.
 
83
 
 
84
 
 
85
****
 
86
BUGS
 
87
****
 
88
 
 
89
 
 
90
For a list of known bugs, see `http://www.percona.com/bugs/pt-mext <http://www.percona.com/bugs/pt-mext>`_.
 
91
 
 
92
Please report bugs at `https://bugs.launchpad.net/percona-toolkit <https://bugs.launchpad.net/percona-toolkit>`_.
 
93
Include the following information in your bug report:
 
94
 
 
95
 
 
96
\* Complete command-line used to run the tool
 
97
 
 
98
 
 
99
 
 
100
\* Tool "--version"
 
101
 
 
102
 
 
103
 
 
104
\* MySQL version of all servers involved
 
105
 
 
106
 
 
107
 
 
108
\* Output from the tool including STDERR
 
109
 
 
110
 
 
111
 
 
112
\* Input files (log/dump/config files, etc.)
 
113
 
 
114
 
 
115
 
 
116
If possible, include debugging output by running the tool with \ ``PTDEBUG``\ ;
 
117
see "ENVIRONMENT".
 
118
 
 
119
 
 
120
*******
 
121
AUTHORS
 
122
*******
 
123
 
 
124
 
 
125
Baron Schwartz
 
126
 
 
127
 
 
128
*********************
 
129
ABOUT PERCONA TOOLKIT
 
130
*********************
 
131
 
 
132
 
 
133
This tool is part of Percona Toolkit, a collection of advanced command-line
 
134
tools developed by Percona for MySQL support and consulting.  Percona Toolkit
 
135
was forked from two projects in June, 2011: Maatkit and Aspersa.  Those
 
136
projects were created by Baron Schwartz and developed primarily by him and
 
137
Daniel Nichter, both of whom are employed by Percona.  Visit
 
138
`http://www.percona.com/software/ <http://www.percona.com/software/>`_ for more software developed by Percona.
 
139
 
 
140
 
 
141
********************************
 
142
COPYRIGHT, LICENSE, AND WARRANTY
 
143
********************************
 
144
 
 
145
 
 
146
This program is copyright 2010 Baron Schwartz, 2011 Percona Inc.
 
147
Feedback and improvements are welcome.
 
148
 
 
149
THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED
 
150
WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
 
151
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 
152
 
 
153
This program is free software; you can redistribute it and/or modify it under
 
154
the terms of the GNU General Public License as published by the Free Software
 
155
Foundation, version 2; OR the Perl Artistic License.  On UNIX and similar
 
156
systems, you can issue \`man perlgpl' or \`man perlartistic' to read these
 
157
licenses.
 
158
 
 
159
You should have received a copy of the GNU General Public License along with
 
160
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
 
161
Place, Suite 330, Boston, MA  02111-1307  USA.
 
162
 
 
163
 
 
164
*******
 
165
VERSION
 
166
*******
 
167
 
 
168
 
 
169
Percona Toolkit v1.0.0 released 2011-08-01
 
170