Skip to content

Commit

Permalink
Version 1.3.0
Browse files Browse the repository at this point in the history
  • Loading branch information
Jean-Paul Argudo committed Apr 24, 2024
1 parent b6c0b9a commit a0d9b1e
Show file tree
Hide file tree
Showing 43 changed files with 771 additions and 115 deletions.
14 changes: 7 additions & 7 deletions bin/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@ You'll find here binaries for your convenience.

```
md5sum pgSimload*
61c63e866796c53606cca227b33cbc9b pgSimload
97ebc3f14eae74b241f154752a6c6b9e pgSimload_mac
cbe9867b32840b6ad72dfa39a35e670b pgSimload_static
42f1028b3964599db54cb2feddd0aac5 pgSimload_win.exe
955227f4d8ce90ad24ae0c3bcfaf4cde pgSimload
06e2593b109dce0dd4bb608c3a513696 pgSimload_mac
ef46a6bf429a1e83748b7fe504069ee7 pgSimload_static
d340bddca2cd3fce7b64faf3715adf9e pgSimload_win.exe
```

# More information
Expand All @@ -29,9 +29,9 @@ If you're a Linux user, let me warn you that the binary has dependencies:

```
$ ldd bin/pgSimload
linux-vdso.so.1 (0x00007fff2d7be000)
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x00007ca096600000)
/lib64/ld-linux-x86-64.so.2 (0x00007ca096949000)
linux-vdso.so.1 (0x00007ffd1fdcf000)
libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x0000747478000000)
/lib64/ld-linux-x86-64.so.2 (0x000074747840e000)
```

Those depedencies would be OK if as an example you're using an up-to-date
Expand Down
Binary file modified bin/pgSimload
Binary file not shown.
Binary file modified bin/pgSimload_mac
Binary file not shown.
Binary file modified bin/pgSimload_static
Binary file not shown.
Binary file modified bin/pgSimload_win.exe
Binary file not shown.
25 changes: 18 additions & 7 deletions doc/01_overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,16 @@

Welcome to pgSimload !

pgSimload is a tool written in Go, and accepts 2 different modes of execution:
pgSimload is a tool written in Go, and accepts 3 different modes of execution:

- **SQL-Loop mode** to execute a script infintely on a given schema of a
- **SQL-Loop** mode to execute a script infintely on a given schema of a
given database with a given user

- **Patroni-Watcher mode** to execute a monitoring on a given Patroni
cluster. So you need one of such for this mode to be useful to you
- **Patroni-Watcher** mode to execute a monitoring on a given Patroni
cluster. This is usefull only if... you run Patroni

- **Kube-Watcher** mode to have a minimal monitoring of a given PostgreSQL
cluster in Kubernetes

Given the mode you choose, some parameters are mandatory or not. And the
contexts of executions are different. Please refer to the complete
Expand Down Expand Up @@ -79,9 +82,9 @@ listed here:

- if your database doesn't have a schema yet, you can create in a
`create.json` file. Look for examples on how to do that in the
`examples/` directory. It should straightforward. That file is **not**
mandatory, as pgSimload need at least a `-config <file>` and a `-script
<file>` to run, in SQL-Loop mode.
`examples/SQL-Loop/` directory. It should straightforward. That file is
**not** mandatory, as pgSimload need at least a `-config <file>` and a
`-script <file>` to run, in SQL-Loop mode.

- the SQL script of your choice. For that purpose you create a plain
SQL file, where you put everything you want in it. It will be run in an
Expand Down Expand Up @@ -155,6 +158,14 @@ listed here:
<patroni.json>` parameter. If set to `nogucs`, no extra GUCs are shown,
only the info from `pg_stat_replication` will be

- monitor a PostgreSQL cluster that runs in Kubernetes, wheter this
solution uses Patroni or not for HA: this mode only uses some `kubectl`
commands to gather only the relevant information to monitor things, like
who's primary, who's replica, the status of each, etc. This mode has been
tested against the Postgres Operator (aka PGO), from CrunchyData, and the
operator from CloudNativePG. You'll find in the `example/Kube-Watcher/`
directory proper configuration JSON to use in both cases

- demo [Crunchy Postgres](https://www.crunchydata.com/products/crunchy-high-availability-postgresql), a fully Open Source based PostgreSQL distribution
using extensively Ansible

Expand Down
11 changes: 6 additions & 5 deletions doc/02_examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@
You can find several examples of usage in the main directory of the project
under `examples/`.

## `examples/simple/`
## `examples/SQL-Loop/simple/`

This example is the simpliest one:
This example is the simpliest example of the SQL-Loop mode!

Prerequisites

Expand Down Expand Up @@ -53,9 +53,10 @@ $ pgSimload -config config.json -script script.sql -time 1s -loops 20
$ pgSimload -config config.json -script script.sql -time 10s -loops 20
```

## `examples/PG_15_Merge_command/`
## `examples/SQL-Loop/PG_15_Merge_command/`

This example is to test new MERGE command in PG 15.x
This example is to test the MERGE command first introduced in PostgreSQL
version 15.

Prerequisites

Expand Down Expand Up @@ -98,7 +99,7 @@ complex and heaven tho:
$ sh watcher.sh histogram
```

## `examples/testdb/`
## `examples/SQL-Loop/testdb/`

This is another example that shows one can:

Expand Down
Loading

0 comments on commit a0d9b1e

Please sign in to comment.