File: INSTALL

package info (click to toggle)
percona-toolkit 3.1+dfsg-1.1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 63,140 kB
  • sloc: perl: 240,174; sql: 22,832; sh: 19,723; makefile: 347; awk: 38; python: 30; sed: 1
file content (70 lines) | stat: -rw-r--r-- 1,527 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
Installing Percona Toolkit
==========================

System Requirements
-------------------

Most tools require:

   * Perl v5.8 or newer
   * Bash v3 or newer
   * Core Perl modules like Time::HiRes

Tools that connect to MySQL require:

   * Perl modules DBI and DBD::mysql
   * MySQL 5.0 or newer

Percona Toolkit is only tested on UNIX systems, primarily Debian and
Red Hat derivatives; other operating systems are not supported.

Tools that connect to MySQL may work with MySQL v4.1, but this is not
test or supported.

Quick Install
-------------

   perl Makefile.PL
   make
   make test
   make install

Detailed Install
----------------

Extract the tarball and cd to the resulting directory:

   tar zxvf percona-toolkit-<version>.tar.gz
   cd percona-toolkit-<version>

Generate the Makefile, which will check Perl module dependencies and
so forth:

   perl Makefile.PL

Build the tools' man pages and prep for test and install:

   make

Test that the tools can run:

   make test

All tests should pass.  If not, then your system may be missing a Perl module
required by a tool.  The tests are not comprehensive; they only test that the
tools can be executed by Perl and Bash.

Finally, install all tools and their man pages:

   make install

On most systems, the tools are installed in /usr/local/bin.

Installation Options
--------------------

To install to a directory other than your system's default, such as your
home directory, generate the Makefile with a prefix:

   perl Makefile.PL PREFIX=${HOME}