ilnmors-homelab/docs/services/infra/postgresql.md

Postgresql

Operation

Refer to Ansible playbook

File management

# console
## cluster
scp infra@infra:$POSTGRESQL_BACKUP_PATH/pg_cluster.sql $HOMELAB_PATH/data/backups/infra/postgresql/pg_cluster.sql
## data
scp infra@infra:$POSTGRESQL_BACKUP_PATH/pg_backup.sql $HOMELAB_PATH/data/backups/infra/postgresql/pg_backup.sql

## The data is managed by kopia.

Verification

# ... Start postgresql service

# Create user and database
podman exec -it -u postgres postgresql "psql -U postgres"
> CREATE USER service WITH PASSWORD 'abc';
> CREATE DATABASE service_db;
> ALTER DATABASE service_db OWNER TO service;
> \du
> \l
> \q

# Reset database
> SELECT pg_terminate_backend(pid) FROM pg_stat_activity WHERE datname = 'service_db'; # connection reset
> DROP DATABASE service_db;
> CREATE DATABASE service_db;
> ALTER DATABASE service_db OWNER TO service;
> \du
> \l
> \q

# Restore database (manually)
podman exec -u postgres postgresql "psql -U postgres -f $POSTGRESQL_BACKUP_PATH_IN_CONTAINER/script.sql"

# Backup service executes
systemctl --user start postgresql-cluster-backup.service

# Stop and remove all data
systemctl --user stop postgresql
sudo find "/home/infra/data/containers/postgresql/data" -mindepth 1 -delete

# Restore database
# Just locate sql files on data_path, and use playbooks

# Check restoring
podman exec -it -u postgres postgresql psql -U postgres
> \du
> \l

# Check extension
postgres=# SHOW shared_preload_libraries;
 shared_preload_libraries
--------------------------
 vchord.so
(1 row)

Update and upgrade version

Update version

Prerequisite

• Shutdown all related services on [infra, auth, app] vms.

  • service list
  • systemctl --user stop $SERVICE

• Run backup service unit on infra vm.

  • systemctl --user start postgresql-cluster-backup.service
  • systemctl --user start postgresql-data-backup@$SERVICE.service

• Modify postgresql and extension version and run ansible playbook

  • version info
  • ansible-playbook playbooks/infra/site.yaml --tags "postgresql"

• Check postgresql container and update extension

# immich example
# extension should be checked on each database which needs the extension
\c immich_db
\dx
# check the installed_version and default_version
ALTER EXTENSION vchord UPDATE;
REINDEX INDEX face_index;
REINDEX INDEX clip_index;

• Run playbook to start all services

  • ansible-playbook playbooks/[infra, auth, app]/site.yaml --tags "site"

• Check all services