File: INSTALL.md

package info (click to toggle)
check-pgbackrest 1.9-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye
  • size: 716 kB
  • sloc: sh: 1,238; perl: 868; makefile: 41; sql: 25
file content (56 lines) | stat: -rw-r--r-- 1,632 bytes parent folder | download
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
## RPM

To install check_pgbackrest with the provided rpm file:

```
yum install -y epel-release
yum install -y nagios-plugins-pgbackrest-*.noarch.rpm
```

The rpm will also require nagios-plugins to be installed and put the 
`check_pgbackrest` script there. 
That's why the epel-release package is needed too.

The provided rpm doesn't install the modules needed for Amazon S3 compatibility. 
See below which modules to install manually.


## Manual installation

To handle the json output format of the pgBackRest info command, you need to
install the following module:

- on RedHat-like: `perl-JSON`
- on Debian-like: `libjson-perl` 

To list archived WALs using SFTP, you need to install the following module:

- On RedHat-like: `perl-Net-SFTP-Foreign`
- On Debian-like: `libnet-sftp-foreign-perl`

The Data::Dump perl module is also needed:

- On RedHat-like: `perl-Data-Dumper`
- On Debian-like: `libdata-dump-perl`


## Amazon S3 compatibility

To handle the S3 connection, two modules are needed:

- On RedHat-like: `perl-Config-IniFiles` and `perl-Net-Amazon-S3`
- On Debian-like: `libconfig-inifiles-perl` and `libnet-amazon-s3-perl`

Unfortunately, the `perl-Net-Amazon-S3` (on CentOS 7) can, for the time being, 
only be found in the Open Fusion repositories. To install it on CentOS 7, use:

```
yum install -y http://repo.openfusion.net/centos7-x86_64/\
openfusion-release-0.7-1.of.el7.noarch.rpm
```

## Unneeded Perl dependencies with pgBackRest >= 2.28

Using the `--enable-internal-pgbr-cmds` argument will use pgBackRest internal
commands. SFTP or Amazon S3 specific Perl dependencies are then not needed
anymore.