You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This module provides tuning, maintenance, and backups for PE PostgreSQL.
23
+
This module provides tuning, and maintenance for PE PostgreSQL.
27
24
28
25
## What does this module provide?
29
26
30
27
This module provides the following functionaility
31
28
32
29
1. Customized settings for PE PostgreSQL
33
30
1. Maintenance to keep the `pe-puppetdb` database lean and fast
34
-
1. Backups for all PE PostgreSQL databases, disabled by default
35
-
- The `pe-puppetdb` database is backed up every week
36
-
- Other databases are backed up every night
37
31
38
32
## Usage
39
33
@@ -46,34 +40,12 @@ It is not recommended to classify using a pre-existing node group in the PE Cons
46
40
47
41
## Items you may want to configure
48
42
49
-
### Backup Schedule
50
43
51
-
> WARNING: The backup functionality in this module has been deprecated and will be removed in a future release.
44
+
> WARNING: The backup functionality in this module has been removed.
52
45
Please refer to the [PE Backup and Restore documentation](https://puppet.com/docs/pe/latest/backing_up_and_restoring_pe.html) for details on how to backup.
53
46
You should ensure the parameter `pe_databases::manage_database_backups` and any parameters from the `pe_databases::backup` class are removed from classification or hiera.
54
47
You should also clean up associated crontab entries.
55
48
56
-
Backups are not activated by default but can be enabled by setting the following parameter:
57
-
58
-
Hiera classification example
59
-
60
-
```
61
-
pe_databases::manage_database_backups:: true
62
-
```
63
-
64
-
You can modify the default backup schedule by provide an array of hashes that describes the databases to backup and their backup schedule.
65
-
Please refer to the [hieradata_examples](https://github.com/puppetlabs/puppetlabs-pe_databases/tree/main/hieradata_examples) directory of this repository for examples.
66
-
67
-
> IMPORTANT NOTE: If you change the default schedule, it will stop managing the associated crontab entries, and there's not a clean way to automatically remove unmanaged crontab entries.
68
-
So you should delete all pe-postgres crontab entries via `crontab -r -u pe-postgres` and let Puppet repopulate them if you change the default schedule.
69
-
Otherwise, you will create duplicate backups.
70
-
71
-
### Backup Retention Policy
72
-
73
-
By default, the backup script will retain two backups for each database.
74
-
When the backup script runs, it will remove the older of the two backups before starting the backup itself.
75
-
You can configure the retention policy by setting `pe_databases::backup::retention_policy: <NUMBER_OF_BACKUPS_TO_RETAIN>`.
76
-
77
49
### Disable Maintenance
78
50
79
51
The maintenance systemd timers will perform a `pg_repack` on various `pe-puppetdb` tables to keep them lean and fast.
@@ -93,27 +65,6 @@ If you are using a dedicated node for PE PostgreSQL, then some of the settings c
93
65
This module attempts to provide default settings that accommodate both a Monolithic install and a dedicated PE PostgreSQL instance.
94
66
Those defaults change based on the `$all_in_one_pe` parameter.
95
67
96
-
## Backups
97
-
98
-
> WARNING: The backup functionality in this module has been deprecated and will be removed in a future release.
99
-
Please refer to the [PE Backup and Restore documentation](https://puppet.com/docs/pe/latest/backing_up_and_restoring_pe.html) for details on how to backup.
100
-
You should ensure the parameter `pe_databases::manage_database_backups` and any parameters from the `pe_databases::backup` class are removed from classification or hiera.
101
-
You should also clean up associated crontab entries.
102
-
103
-
This is the documentation for Pupet Enterprise backups:
This module provides an alternative to backup just the PE PostgreSQL databases.
108
-
109
-
It is recommended that you backup each database individually so that if you have an issue with one database you do not have to restore all databases.
110
-
111
-
Under ideal conditions you would backup all databases daily, however, backing up large databases such as `pe-puppetdb`, results in excessive disk I/O so you may prefer to backup `pe-puppetdb` weekly while backing up the rest of the smaller databases daily.
112
-
113
-
The choice to backup `pe-puppetdb` more frequently should be based on the business needs.
114
-
115
-
This module provides a script for backing up PE PostgreSQL databases and two default cron jobs: one weekly to back up the `pe-puppetdb` database, and one daily to backup every database except `pe-puppetdb`.
116
-
117
68
## Maintenance
118
69
119
70
This module provides systemd timers to pg_repack tables in the `pe-puppetdb` database:
0 commit comments