Skip to content

Commit 2709478

Browse files
authored
Add docs to resolve exclusive lock error in pgx_ulid setup (#47)
Fixes #12 Adds a troubleshooting section to the README.md to address the exclusive lock error when using `pgx_ulid`. - Introduces a "Troubleshooting" section before the "License" section, providing clear steps to resolve the exclusive lock error by altering the system to set `shared_preload_libraries` to `ulid`. - Details the process of restarting the PostgreSQL service after altering `shared_preload_libraries` to ensure changes take effect. - Recommends verifying the change with `SHOW shared_preload_libraries;` to confirm `ulid` is successfully loaded. --- For more details, open the [Copilot Workspace session](https://copilot-workspace.githubnext.com/pksunkara/pgx_ulid/issues/12?shareId=9b0fd900-91fe-4a49-8edb-f157744e49e4).
1 parent 29a037e commit 2709478

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

README.md

+18
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ A postgres extension to support [ulid][].
88
3. [Monotonicity](#monotonicity)
99
4. [Usage](#usage)
1010
5. [Installation](#installation)
11+
6. [Troubleshooting](#troubleshooting)
1112

1213
## Why should I use this?
1314

@@ -239,6 +240,23 @@ Use [pgrx][]. You can clone this repo and install this extension locally by foll
239240

240241
You can also download relevant files from [releases](https://github.com/pksunkara/pgx_ulid/releases) page.
241242

243+
## Troubleshooting
244+
245+
If you encounter the exclusive lock error while using `pgx_ulid`, follow these steps to resolve the issue:
246+
247+
1. Alter the system to set `shared_preload_libraries` to `ulid` by running the following SQL command:
248+
249+
```sql
250+
ALTER SYSTEM SET shared_preload_libraries = 'ulid';
251+
```
252+
253+
2. Restart the PostgreSQL service to apply the changes. The command to restart PostgreSQL depends on your system.
254+
3. Verify that `ulid` is successfully loaded into shared libraries by executing:
255+
256+
```sql
257+
SHOW shared_preload_libraries;
258+
```
259+
242260
<!-- omit from toc -->
243261
## Contributors
244262

0 commit comments

Comments
 (0)