From cbd7ec3005db613cc23c96936e5fbc891fbbc819 Mon Sep 17 00:00:00 2001 From: Mason Sharp Date: Wed, 3 Dec 2025 14:51:08 -0800 Subject: [PATCH 1/2] Add pg_upgrade to docs --- README.md | 1 + docs/pg_upgrade_with_lolor.md | 29 +++++++++++++++++++++++++++++ mkdocs.yml | 3 ++- 3 files changed, 32 insertions(+), 1 deletion(-) create mode 100644 docs/pg_upgrade_with_lolor.md diff --git a/README.md b/README.md index fcf175d..ba26ea7 100644 --- a/README.md +++ b/README.md @@ -8,6 +8,7 @@ lolor is an extension that makes Postgres' Large Objects compatible with Logical - [Basic Configuration](README.md#configuring-lolor) - [Using lolor](docs/using_lolor.md) - [Limitations](README.md#limitations) +- [Using pg_upgrade with lolor](docs/pg_upgrade_with_lolor.md) - [Release Notes](docs/lolor_release_notes.md) PostgreSQL supports large objects as related chunks as described in the [pg_largeobject](https://www.postgresql.org/docs/current/catalog-pg-largeobject.html) table. Large objects provide stream-style access to user data stored in a special large-object structure in the catalog. Large objects stored in catalog tables require special handling during replication; the lolor extension allows for the storage of large objects in non-catalog tables, aiding in replication of large objects. diff --git a/docs/pg_upgrade_with_lolor.md b/docs/pg_upgrade_with_lolor.md new file mode 100644 index 0000000..b6ffe8b --- /dev/null +++ b/docs/pg_upgrade_with_lolor.md @@ -0,0 +1,29 @@ +# Using pg_upgrade with lolor + +The `pg_upgrade` utility is used for upgrading Postgres versions. + +You can use `pg_upgrade` with the `lolor` extension installed provided that you are using at least version 1.2.2. If using an older version, you will need to upgrade the extension first. + +Before running `pg_upgrade`, you must disable `lolor`. After executing, it can be enabled again. + +Use `psql` or another client to disable: + +``` +db1_17=# SELECT lolor.disable(); +``` + +Next, execute the upgrade. An example `pg_ugrade` command appears below: + +``` +# pg_upgrade --old-datadir=/data/db1_17 \ + --new-datadir=/data/db1_18 \ + --old-bindir=/usr/lib/postgresql/17/bin \ + --new-bindir=/usr/lib/postgresql/18/bin \ + --link +``` + +Finally, enable `lolor`: + +``` +db1_18=# SELECT lolor.enable(); +``` diff --git a/mkdocs.yml b/mkdocs.yml index e1909e0..41da73e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -52,4 +52,5 @@ nav: - lolor Overview: index.md - Building and Installing lolor: install_configure.md - Using lolor: using_lolor.md - - lolor Release Notes: lolor_release_notes.md \ No newline at end of file + - Using pg_upgrade with lolor: pg_upgrade_with_lolor.md + - lolor Release Notes: lolor_release_notes.md From 24dab414b96d3abf0b917089587b775a2b87e652 Mon Sep 17 00:00:00 2001 From: susan-pgedge <130390403+susan-pgedge@users.noreply.github.com> Date: Fri, 5 Dec 2025 11:49:05 -0500 Subject: [PATCH 2/2] Update pg_upgrade_with_lolor.md for clarity Clarified version requirements and instructions for using pg_upgrade with lolor. --- docs/pg_upgrade_with_lolor.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/pg_upgrade_with_lolor.md b/docs/pg_upgrade_with_lolor.md index b6ffe8b..b816190 100644 --- a/docs/pg_upgrade_with_lolor.md +++ b/docs/pg_upgrade_with_lolor.md @@ -2,17 +2,15 @@ The `pg_upgrade` utility is used for upgrading Postgres versions. -You can use `pg_upgrade` with the `lolor` extension installed provided that you are using at least version 1.2.2. If using an older version, you will need to upgrade the extension first. +You can use `pg_upgrade` with the `lolor` extension installed provided that you are using lolor version 1.2.2 or later. If you are using an older version of lolor, you will need to upgrade the extension first. -Before running `pg_upgrade`, you must disable `lolor`. After executing, it can be enabled again. - -Use `psql` or another client to disable: +Before running `pg_upgrade`, you must disable `lolor`. After executing pg_upgrade, you can enable lolor. Use `psql` or another client to disable lolor: ``` db1_17=# SELECT lolor.disable(); ``` -Next, execute the upgrade. An example `pg_ugrade` command appears below: +Next, execute the upgrade. A sample `pg_ugrade` command appears below: ``` # pg_upgrade --old-datadir=/data/db1_17 \ @@ -22,7 +20,7 @@ Next, execute the upgrade. An example `pg_ugrade` command appears below: --link ``` -Finally, enable `lolor`: +Then, use psql to enable `lolor`: ``` db1_18=# SELECT lolor.enable();