Skip to content

Commit

Permalink
Add docs to resolve exclusive lock error in pgx_ulid setup (#47)
Browse files Browse the repository at this point in the history
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).
  • Loading branch information
pksunkara authored Jun 11, 2024
1 parent 29a037e commit 2709478
Showing 1 changed file with 18 additions and 0 deletions.
18 changes: 18 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ A postgres extension to support [ulid][].
3. [Monotonicity](#monotonicity)
4. [Usage](#usage)
5. [Installation](#installation)
6. [Troubleshooting](#troubleshooting)

## Why should I use this?

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

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

## Troubleshooting

If you encounter the exclusive lock error while using `pgx_ulid`, follow these steps to resolve the issue:

1. Alter the system to set `shared_preload_libraries` to `ulid` by running the following SQL command:

```sql
ALTER SYSTEM SET shared_preload_libraries = 'ulid';
```

2. Restart the PostgreSQL service to apply the changes. The command to restart PostgreSQL depends on your system.
3. Verify that `ulid` is successfully loaded into shared libraries by executing:

```sql
SHOW shared_preload_libraries;
```

<!-- omit from toc -->
## Contributors

Expand Down

0 comments on commit 2709478

Please sign in to comment.