Skip to content

Commit a3d7944

Browse files
author
Morgan Haskel
committed
README had outdated upgrade info
Info was on upgrading from 2.x->3.0, but this is 4.x.
1 parent d1c2144 commit a3d7944

File tree

1 file changed

+5
-96
lines changed

1 file changed

+5
-96
lines changed

README.md

Lines changed: 5 additions & 96 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,11 @@ Table of Contents
1010
* [PE 3.2 supported module](#pe-32-supported-module)
1111
* [Configuring the server](#configuring-the-server)
1212
4. [Usage - How to use the module for various tasks](#usage)
13-
5. [Upgrading - Guide for upgrading from older revisions of this module](#upgrading)
14-
6. [Reference - The classes, defines,functions and facts available in this module](#reference)
15-
7. [Limitations - OS compatibility, etc.](#limitations)
16-
8. [Development - Guide for contributing to the module](#development)
17-
9. [Transfer Notice - Notice of authorship change](#transfer-notice)
18-
10. [Contributors - List of module contributors](#contributors)
13+
5. [Reference - The classes, defines,functions and facts available in this module](#reference)
14+
6. [Limitations - OS compatibility, etc.](#limitations)
15+
7. [Development - Guide for contributing to the module](#development)
16+
8. [Transfer Notice - Notice of authorship change](#transfer-notice)
17+
9. [Contributors - List of module contributors](#contributors)
1918

2019
Overview
2120
--------
@@ -121,96 +120,6 @@ In this example, you would grant ALL privileges on the test1 database and on the
121120

122121
At this point, you would just need to plunk these database name/username/password values into your PuppetDB config files, and you are good to go.
123122

124-
Upgrading
125-
---------
126-
127-
###Upgrading from 2.x to version 3
128-
129-
*Note:* if you are upgrading for 2.x, you *must* read this, as just about everything has changed.
130-
131-
Version 3 was a major rewrite to fix some internal dependency issues, and to make the new Public API more clear. As a consequence a lot of things have changed for version 3 and older revisions that we will try to outline here.
132-
133-
####Server specific objects now moved under `postgresql::server::` namespace
134-
135-
To restructure server specific elements under the `postgresql::server::` namespaces the following objects were renamed as such:
136-
137-
* `postgresql::database` -> `postgresql::server::database`
138-
* `postgresql::database_grant` -> `postgresql::server::database_grant`
139-
* `postgresql::db` -> `postgresql::server::db`
140-
* `postgresql::grant` -> `postgresql::server::grant`
141-
* `postgresql::pg_hba_rule` -> `postgresql::server::pg_hba_rule`
142-
* `postgresql::plperl` -> `postgresql::server::plperl`
143-
* `postgresql::contrib` -> `postgresql::server::contrib`
144-
* `postgresql::role` -> `postgresql::server::role`
145-
* `postgresql::table_grant` -> `postgresql::server::table_grant`
146-
* `postgresql::tablespace` -> `postgresql::server::tablespace`
147-
148-
####New `postgresql::server::config_entry` resource for managing configuration
149-
150-
Previously we used the `file_line` resource to modify `postgresql.conf`. This new revision now adds a new resource named `postgresql::server::config_entry` for managing this file. For example:
151-
152-
postgresql::server::config_entry { 'check_function_bodies':
153-
value => 'off',
154-
}
155-
156-
If you were using `file_line` for this purpose, you should change to this new methodology.
157-
158-
####`postgresql_puppet_extras.conf` has been removed
159-
160-
Now that we have a methodology for managing `postgresql.conf`, and due to concerns over the file management methodology using an `exec { 'touch ...': }` as a way to create an empty file the existing postgresql\_puppet\_extras.conf file is no longer managed by this module.
161-
162-
If you wish to recreate this methodology yourself, use this pattern:
163-
164-
class { 'postgresql::server': }
165-
166-
$extras = "/tmp/include.conf"
167-
168-
file { $extras:
169-
content => 'max_connections = 123',
170-
notify => Class['postgresql::server::service'],
171-
}->
172-
postgresql::server::config_entry { 'include':
173-
value => $extras,
174-
}
175-
176-
####All uses of the parameter `charset` changed to `encoding`
177-
178-
Since PostgreSQL uses the terminology `encoding` not `charset` the parameter has been made consisent across all classes and resources.
179-
180-
####The `postgresql` base class is no longer how you set globals
181-
182-
The old global override pattern was less then optimal so it has been fixed, however we decided to demark this properly by specifying these overrides in the class `postgresql::globals`. Consult the documentation for this class now to see what options are available.
183-
184-
Also, some parameter elements have been moved between this and the `postgresql::server` class where it made sense.
185-
186-
####`config_hash` parameter collapsed for the `postgresql::server` class
187-
188-
Because the `config_hash` was really passing data through to what was in effect an internal class (`postgresql::config`). And since we don't want this kind of internal exposure the parameters were collapsed up into the `postgresql::server` class directly.
189-
190-
####Lots of changes to 'private' or 'undocumented' classes
191-
192-
If you were using these before, these have changed names. You should only use what is documented in this README.md, and if you don't have what you need you should raise a patch to add that feature to a public API. All internal classes now have a comment at the top indicating them as private to make sure the message is clear that they are not supported as Public API.
193-
194-
####`pg_hba_conf_defaults` parameter included to turn off default pg\_hba rules
195-
196-
The defaults should be good enough for most cases (if not raise a bug) but if you simply need an escape hatch, this setting will turn off the defaults. If you want to do this, it may affect the rest of the module so make sure you replace the rules with something that continues operation.
197-
198-
####`postgresql::database_user` has now been removed
199-
200-
Use `postgresql::server::role` instead.
201-
202-
####`postgresql::psql` resource has now been removed
203-
204-
Use `postgresql_psql` instead. In the future we may recreate this as a wrapper to add extra capability, but it will not match the old behaviour.
205-
206-
####`postgresql_default_version` fact has now been removed
207-
208-
It didn't make sense to have this logic in a fact any more, the logic has been moved into `postgresql::params`.
209-
210-
####`ripienaar/concat` is no longer used, instead we use `puppetlabs/concat`
211-
212-
The older concat module is now deprecated and moved into the `puppetlabs/concat` namespace. Functionality is more or less identical, but you may need to intervene during the installing of this package - as both use the same `concat` namespace.
213-
214123
Reference
215124
---------
216125

0 commit comments

Comments
 (0)