\npsql --version\n# Expected: psql (PostgreSQL) 18.x\n\nrepmgr --version\n# Expected: repmgr 5.x\n<\/pre><\/div>\n\n\nEn server2, detenga PostgreSQL y elimine el directorio de datos predeterminado.
repmgr clonar\u00e1 el directorio de datos del primario a server2 en un paso posterior; si ya existe un directorio de datos, clonar r\u00e9plica de repmgr<\/code> se negar\u00e1 a proceder.<\/p>\n\n\n\n# On server2\nsudo systemctl stop postgresql\nsudo rm -rf \/var\/lib\/postgresql\/18\/main\n<\/pre><\/div>\n\n\n
\n\n\n\nPaso 2 \u2014 Configurar PostgreSQL para la replicaci\u00f3n por streaming<\/h2>\n\n\n\n
Estos par\u00e1metros deben configurarse en \/etc\/postgresql\/18\/main\/postgresql.conf<\/code> en ambos servidores antes de configurar la replicaci\u00f3n.
repmgr requiere wal_log_hints<\/code> y shared_preload_libraries<\/code> \u2014 sin ellos, el proceso de reincorporaci\u00f3n del nodo (pg_rewind) y el demonio repmgrd no funcionar\u00e1n.<\/p>\n\n\n\nEn ambos servidores, edita \/etc\/postgresql\/18\/main\/postgresql.conf<\/code>:<\/p>\n\n\n\nlisten_addresses = ‘*'\nwal_level = replica\nmax_wal_senders = 10\nmax_replication_slots = 10\nhot_standby = on\nwal_log_hints = on\nshared_preload_libraries = ‘repmgr'\n<\/div>\n\n\n
Estos par\u00e1metros requieren un reinicio de PostgreSQL para que surtan efecto.
No reinicies todav\u00eda \u2014 a\u00f1ade la pg_hba.conf<\/code> entrar primero para que no reinicie dos veces.<\/p>\n\n\n\n
\n\n\n\nPaso 3 \u2014 Permitir conexiones de replicaci\u00f3n en pg_hba.conf<\/h2>\n\n\n\n
En ambos servidores, adjunta estas l\u00edneas a \/etc\/postgresql\/18\/main\/pg_hba.conf<\/code>.
Estos permiten la repmgr<\/code> para conectarse tanto a consultas de gesti\u00f3n como a streaming de WAL desde cualquier nodo.<\/p>\n\n\n\nsudo tee -a \/etc\/postgresql\/18\/main\/pg_hba.conf > \/dev\/null << 'EOF'\n\nhost repmgr repmgr 192.168.0.181\/32 scram-sha-256\nhost repmgr repmgr 192.168.0.182\/32 scram-sha-256\nhost replication repmgr 192.168.0.181\/32 scram-sha-256\nhost replication repmgr 192.168.0.182\/32 scram-sha-256\nEOF\n<\/pre><\/div>\n\n\nAhora reinicia PostgreSQL en server1 (server2 a\u00fan no tiene directorio de datos):<\/p>\n\n\n
\n# On server1\nsudo systemctl restart postgresql\n<\/pre><\/div>\n\n\n
\n\n\n\nPaso 4: Cree el usuario y la base de datos repmgr<\/h2>\n\n\n\n
Ejecuta estos comandos en server1 (el principal) solamente.
El standby recibir\u00e1 el esquema repmgr a trav\u00e9s de la replicaci\u00f3n en un paso posterior.<\/p>\n\n\n
\nsudo -u postgres psql -c "CREATE USER repmgr WITH SUPERUSER REPLICATION LOGIN PASSWORD 'repmgr';"\nsudo -u postgres psql -c "CREATE DATABASE repmgr OWNER repmgr;"\n<\/pre><\/div>\n\n\nA\u00f1adir un .pgpass<\/code> archivo para el usuario del sistema operativo postgres en ambos servidores para que repmgr pueda conectarse sin solicitud de contrase\u00f1a.<\/p>\n\n\n\nEn server1:<\/p>\n\n\n
\nsudo -u postgres bash -c 'cat > \/var\/lib\/postgresql\/.pgpass <<EOF\n192.168.0.181:5432:repmgr:repmgr:repmgr\n192.168.0.182:5432:repmgr:repmgr:repmgr\n192.168.0.181:5432:replication:repmgr:repmgr\n192.168.0.182:5432:replication:repmgr:repmgr\nEOF'\nsudo chmod 600 \/var\/lib\/postgresql\/.pgpass\n<\/pre><\/div>\n\n\nEn server2:<\/p>\n\n\n
\nsudo -u postgres bash -c 'cat > \/var\/lib\/postgresql\/.pgpass <<EOF\n192.168.0.181:5432:repmgr:repmgr:repmgr\n192.168.0.182:5432:repmgr:repmgr:repmgr\n192.168.0.181:5432:replication:repmgr:repmgr\n192.168.0.182:5432:replication:repmgr:repmgr\nEOF'\nsudo chmod 600 \/var\/lib\/postgresql\/.pgpass\n<\/pre><\/div>\n\n\n
\n\n\n\nCrear \/etc\/repmgr.conf<\/code> en cada servidor.
En pg_bindir<\/code> par\u00e1metro es requerido en Ubuntu \u2014 el pg_rewind<\/code> binario no est\u00e1 en el PATH predeterminado para el usuario del sistema operativo postgres, y repmgr lo necesita durante la reintegraci\u00f3n de nodos despu\u00e9s de una conmutaci\u00f3n por error.
En comando_inicio_servicio<\/code> y comando_detener_servicio<\/code> par\u00e1metros son requeridos: sin comando_detener_servicio<\/code>, los cambios de sistema planeados fallan con el mensaje \u201cno se pudo confirmar el apagado primario\u201d; sin comando_inicio_servicio<\/code>, un nodo no puede volver a unirse autom\u00e1ticamente al cl\u00faster despu\u00e9s de ser rebobinado.<\/p>\n\n\n\nEn server1:<\/p>\n\n\n
\nsudo tee \/etc\/repmgr.conf > \/dev\/null << 'EOF'\nnode_id=1\nnode_name='server1'\nconninfo='host=192.168.0.181 user=repmgr dbname=repmgr connect_timeout=2'\ndata_directory='\/var\/lib\/postgresql\/18\/main'\n\nfailover=automatic\npromote_command='repmgr standby promote -f \/etc\/repmgr.conf --log-to-file'\nfollow_command='repmgr standby follow -f \/etc\/repmgr.conf --upstream-node-id=%n --log-to-file'\n\nuse_replication_slots=yes\nmonitoring_history=yes\nlog_file='\/var\/log\/repmgr\/repmgr.log'\n\npg_bindir='\/usr\/lib\/postgresql\/18\/bin'\nservice_start_command='sudo systemctl start postgresql'\nservice_stop_command='sudo systemctl stop postgresql'\n\nnode_rejoin_timeout=120\nstandby_reconnect_timeout=120\nEOF\n\nsudo chown postgres:postgres \/etc\/repmgr.conf\nsudo chmod 640 \/etc\/repmgr.conf\n<\/pre><\/div>\n\n\nEn server2, solo node_id<\/code> y nombre_nodo<\/code> diferir<\/p>\n\n\n\nsudo tee \/etc\/repmgr.conf > \/dev\/null << 'EOF'\nnode_id=2\nnode_name='server2'\nconninfo='host=192.168.0.182 user=repmgr dbname=repmgr connect_timeout=2'\ndata_directory='\/var\/lib\/postgresql\/18\/main'\n\nfailover=automatic\npromote_command='repmgr standby promote -f \/etc\/repmgr.conf --log-to-file'\nfollow_command='repmgr standby follow -f \/etc\/repmgr.conf --upstream-node-id=%n --log-to-file'\n\nuse_replication_slots=yes\nmonitoring_history=yes\nlog_file='\/var\/log\/repmgr\/repmgr.log'\n\npg_bindir='\/usr\/lib\/postgresql\/18\/bin'\nservice_start_command='sudo systemctl start postgresql'\nservice_stop_command='sudo systemctl stop postgresql'\n\nnode_rejoin_timeout=120\nstandby_reconnect_timeout=120\nEOF\n\nsudo chown postgres:postgres \/etc\/repmgr.conf\nsudo chmod 640 \/etc\/repmgr.conf\n<\/pre><\/div>\n\n\nCrea el directorio de registros en ambos servidores:<\/p>\n\n\n
\nsudo mkdir -p \/var\/log\/repmgr\nsudo chown postgres:postgres \/var\/log\/repmgr\n<\/pre><\/div>\n\n\n
\n\n\n\nPaso 6 \u2014 Configurar claves SSH y sudo sin contrase\u00f1a<\/h2>\n\n\n\n
Los cambios de configuraci\u00f3n planificados requieren que repmgr se conecte por SSH desde un nodo al otro como el usuario del sistema operativo postgres y ejecute systemctl stop postgresql<\/code>.
Este paso es obligatorio; sin \u00e9l, los conmutadores fallan en el punto donde repmgr intenta detener el primario actual de forma remota.<\/p>\n\n\n\nConfiguraci\u00f3n de claves SSH:<\/strong><\/p>\n\n\n\nEn server1 \u2014 generar una clave y mostrar la clave p\u00fablica:<\/p>\n\n\n
\n# On server1\nsudo -u postgres ssh-keygen -t ed25519 -N '' -f \/var\/lib\/postgresql\/.ssh\/id_ed25519\nsudo -u postgres cat \/var\/lib\/postgresql\/.ssh\/id_ed25519.pub\n<\/pre><\/div>\n\n\nEn server2 \u2014 autoriza la clave p\u00fablica de server1:<\/p>\n\n\n
\n# On server2\nsudo -u postgres mkdir -p \/var\/lib\/postgresql\/.ssh\n# Paste the public key from server1 in place of <server1-public-key>\nsudo -u postgres bash -c 'echo "<server1-public-key>" >> \/var\/lib\/postgresql\/.ssh\/authorized_keys'\nsudo chmod 700 \/var\/lib\/postgresql\/.ssh\nsudo chmod 600 \/var\/lib\/postgresql\/.ssh\/authorized_keys\nsudo chown -R postgres:postgres \/var\/lib\/postgresql\/.ssh\n<\/pre><\/div>\n\n\nRepite en la otra direcci\u00f3n: genera una clave en server2 y luego autor\u00edzala en server1:<\/p>\n\n\n
\n# On server2\nsudo -u postgres ssh-keygen -t ed25519 -N '' -f \/var\/lib\/postgresql\/.ssh\/id_ed25519\nsudo -u postgres cat \/var\/lib\/postgresql\/.ssh\/id_ed25519.pub\n<\/pre><\/div>\n\n\n# On server1\nsudo -u postgres mkdir -p \/var\/lib\/postgresql\/.ssh\nsudo -u postgres bash -c 'echo "<server2-public-key>" >> \/var\/lib\/postgresql\/.ssh\/authorized_keys'\nsudo chmod 700 \/var\/lib\/postgresql\/.ssh\nsudo chmod 600 \/var\/lib\/postgresql\/.ssh\/authorized_keys\nsudo chown -R postgres:postgres \/var\/lib\/postgresql\/.ssh\n<\/pre><\/div>\n\n\nVerificar desde cada nodo (tipo s\u00ed<\/code> si se le pide que acepte la clave del host \u2014solo la primera vez):<\/p>\n\n\n\n# On server1\nsudo -u postgres ssh postgres@192.168.0.182 "echo OK"\n# Expected: OK\n<\/pre><\/div>\n\n\n# On server2\nsudo -u postgres ssh postgres@192.168.0.181 "echo OK"\n# Expected: OK\n<\/pre><\/div>\n\n\nSudo sin contrase\u00f1a \u2014 en ambos servidores:<\/strong><\/p>\n\n\n\nCrear \/etc\/sudoers.d\/postgres-repmgr<\/code> para permitir que el usuario postgres inicie y detenga PostgreSQL sin contrase\u00f1a.
El camino debe ser \/usr\/bin\/systemctl<\/code> \u2014 en Ubuntu 24.04 aqu\u00ed es donde vive systemctl, y sudo valida la ruta exacta.
El archivo debe tener permisos 440 \u2014 sudo ignora silenciosamente los archivos con permisos legibles por el mundo.<\/p>\n\n\n\nsudo tee \/etc\/sudoers.d\/postgres-repmgr > \/dev\/null << 'EOF'\npostgres ALL=(ALL) NOPASSWD: \/usr\/bin\/systemctl start postgresql, \/usr\/bin\/systemctl stop postgresql, \/usr\/bin\/systemctl restart postgresql\nEOF\nsudo chmod 440 \/etc\/sudoers.d\/postgres-repmgr\n<\/pre><\/div>\n\n\nVerificar \u2014 no se espera solicitud de contrase\u00f1a:<\/p>\n\n\n
\nsudo -u postgres sudo systemctl status postgresql@18-main\n<\/pre><\/div>\n\n\n
\n\n\n\nPaso 7 \u2014 Registrar el Primario y Clonar el Secundario<\/h2>\n\n\n\n
En server1, registre la instancia de PostgreSQL en ejecuci\u00f3n como nodo primario:<\/p>\n\n\n
\n# On server1\nsudo -u postgres repmgr -f \/etc\/repmgr.conf primary register\n<\/pre><\/div>\n\n\nEn server2, ejecuta primero una simulaci\u00f3n para confirmar la conectividad:<\/p>\n\n\n
\n# On server2\nsudo -u postgres repmgr -h 192.168.0.181 -U repmgr -d repmgr \\\n -f \/etc\/repmgr.conf standby clone --dry-run\n# Expected: "STANDBY CLONE (target node \\"server2\\") would complete successfully"\n<\/pre><\/div>\n\n\nLuego, ejecuta el clon real:<\/p>\n\n\n
\n# On server2\nsudo -u postgres repmgr -h 192.168.0.181 -U repmgr -d repmgr \\\n -f \/etc\/repmgr.conf standby clone\n<\/pre><\/div>\n\n\nEn Ubuntu, postgresql.conf<\/code> y pg_hba.conf<\/code> vivir en \/etc\/postgresql\/18\/main\/<\/code> \u2014 fuera del directorio de datos.
pg_basebackup<\/code> solo clona el directorio de datos, por lo que estos archivos de configuraci\u00f3n no se copian autom\u00e1ticamente.
C\u00f3pialos del servidor1 al servidor2:<\/p>\n\n\n\n# On server1 \u2014 stage the files for transfer\nsudo cp \/etc\/postgresql\/18\/main\/postgresql.conf \/tmp\/postgresql.conf\nsudo cp \/etc\/postgresql\/18\/main\/pg_hba.conf \/tmp\/pg_hba.conf\nsudo chmod 644 \/tmp\/postgresql.conf \/tmp\/pg_hba.conf\n<\/pre><\/div>\n\n\n# On server2 \u2014 copy and install\nscp fernando@192.168.0.181:\/tmp\/postgresql.conf \/tmp\/postgresql.conf\nscp fernando@192.168.0.181:\/tmp\/pg_hba.conf \/tmp\/pg_hba.conf\nsudo cp \/tmp\/postgresql.conf \/etc\/postgresql\/18\/main\/postgresql.conf\nsudo cp \/tmp\/pg_hba.conf \/etc\/postgresql\/18\/main\/pg_hba.conf\n<\/pre><\/div>\n\n\nInicie PostgreSQL en el servidor2 y reg\u00edstrelo como un respaldo:<\/p>\n\n\n
\n# On server2\nsudo systemctl start postgresql\nsudo -u postgres repmgr -f \/etc\/repmgr.conf standby register\n<\/pre><\/div>\n\n\nVerifica el cl\u00faster desde cualquiera de los nodos:<\/p>\n\n\n
\nsudo -u postgres repmgr -f \/etc\/repmgr.conf cluster show\n<\/pre><\/div>\n\n\nSalida esperada:<\/p>\n\n\n
\n ID | Name | Role | Status | Upstream | Location | Priority | Timeline | Connection string\n----+---------+---------+-----------+----------+----------+----------+----------+----------------------------------------------------------\n 1 | server1 | primary | * running | | default | 100 | 1 | host=192.168.0.181 user=repmgr dbname=repmgr connect_timeout=2\n 2 | server2 | standby | running | server1 | default | 100 | 1 | host=192.168.0.182 user=repmgr dbname=repmgr connect_timeout=2\n<\/pre><\/div>\n\n\n
\n\n\n\nPaso 8. Inicie repmgrd para la conmutaci\u00f3n por error autom\u00e1tica<\/h2>\n\n\n\n
repmgrd es el demonio de monitoreo que activa la conmutaci\u00f3n autom\u00e1tica por error.
En Ubuntu 24.04, repmgr no incluye un archivo de unidad de systemd para repmgrd \u2014 in\u00edcielo manualmente utilizando --demonio<\/code>.<\/p>\n\n\n\nEn ambos servidores:<\/p>\n\n\n
\nsudo -u postgres repmgrd -f \/etc\/repmgr.conf --daemonize\n<\/pre><\/div>\n\n\nVerifica que el demonio est\u00e9 en ejecuci\u00f3n y no en pausa:<\/p>\n\n\n
\nsudo -u postgres repmgr daemon status\n<\/pre><\/div>\n\n\nSalida esperada:<\/p>\n\n\n
\n ID | Name | Role | Status | repmgrd Active | PID | Paused? | Upstream\n----+---------+---------+-----------+----------------+------+---------+---------\n 1 | server1 | primary | * running | yes | XXXX | no | n\/a\n 2 | server2 | standby | running | yes | XXXX | no | server1\n<\/pre><\/div>\n\n\nEn \u00bfPausado? no<\/code> la columna es cr\u00edtica \u2014 repmgrd se pausa a s\u00ed mismo despu\u00e9s de un intento fallido de failover y no intentar\u00e1 otro failover mientras est\u00e9 pausado.
Antes de cualquier prueba de conmutaci\u00f3n por error, verifique que ambos nodos muestren \u00bfPausado? no<\/code>.
Si un nodo muestra \u00bfPausado? s\u00ed<\/code>, ejecutar:<\/p>\n\n\n\nsudo -u postgres repmgr daemon unpause\n<\/pre><\/div>\n\n\n
\n\n\n\nPaso 9 \u2014 Probar la conmutaci\u00f3n por error autom\u00e1tica<\/h2>\n\n\n\n
Detener PostgreSQL en server1 para simular un fallo primario:<\/p>\n\n\n
\n# On server1\nsudo systemctl stop postgresql\n<\/pre><\/div>\n\n\nEn server2, observa la reacci\u00f3n de repmgrd:<\/p>\n\n\n
\n# On server2\nsudo tail -f -n 50 \/var\/log\/repmgr\/repmgr.log\n<\/pre><\/div>\n\n\nrepmgrd espera un n\u00famero configurable de intentos de reconexi\u00f3n (predeterminado: 6 intentos \u00d7 10 segundos = ~60 segundos) antes de promover el standby.
Cuando la promoci\u00f3n se completa, el registro muestra:<\/p>\n\n\n
\nNOTICE: promoting standby to primary\nNOTICE: STANDBY PROMOTE successful\n<\/pre><\/div>\n\n\nVerificar la nueva topolog\u00eda:<\/p>\n\n\n
\n# On server2\nsudo -u postgres repmgr -f \/etc\/repmgr.conf cluster show\n<\/pre><\/div>\n\n\nserver2 es ahora el principal, server1 aparece como no disponible.<\/p>\n\n\n\n
\n\n\n\nPaso 10: Reincorporar el nodo fallido como en espera<\/h2>\n\n\n\n
Despu\u00e9s de la conmutaci\u00f3n por error, server1 necesita ser reintegrado.
PostgreSQL puede haber avanzado en server2 mientras server1 estaba ca\u00eddo; los directorios de datos ahora divergieron.
repmgr usa pg_rewind<\/code> para sincronizar server1 con la l\u00ednea de tiempo del nuevo primario antes de iniciar la replicaci\u00f3n.<\/p>\n\n\n\nEn server1, verifica que PostgreSQL est\u00e9 detenido, luego ejecuta:<\/p>\n\n\n
\n# On server1\nsudo systemctl status postgresql@18-main\n# Expected: inactive (dead) \u2014 if active, stop it first: sudo systemctl stop postgresql\n\nsudo -u postgres repmgr node rejoin \\\n -d 'host=192.168.0.182 user=repmgr dbname=repmgr' \\\n -f \/etc\/repmgr.conf \\\n --force-rewind \\\n --verbose\n<\/pre><\/div>\n\n\n--forzar-rebobinado<\/code> indicar a repmgr que se ejecute pg_rewind<\/code> independientemente de la verificaci\u00f3n de divergencia temporal.
En Ubuntu 24.04, la reconexi\u00f3n a veces falla por tiempo de espera antes de que PostgreSQL termine de iniciarse como respaldo.
Si el comando sale con un mensaje de tiempo de espera agotado pero el registro muestra que pg_rewind se complet\u00f3 con \u00e9xito, inicia PostgreSQL manualmente:<\/p>\n\n\n\nsudo systemctl start postgresql\n<\/pre><\/div>\n\n\nRegistrar el servidor server1 en los metadatos de repmgr e iniciar el demonio repmgrd.
En --forzar<\/code> se requiere el indicador porque server1 se registr\u00f3 previamente como el principal:<\/p>\n\n\n\nsudo -u postgres repmgr -f \/etc\/repmgr.conf standby register --force\nsudo -u postgres repmgrd -f \/etc\/repmgr.conf --daemonize\n<\/pre><\/div>\n\n\nVerifica que ambos nodos est\u00e9n ejecut\u00e1ndose:<\/p>\n\n\n
\nsudo -u postgres repmgr -f \/etc\/repmgr.conf cluster show\n<\/pre><\/div>\n\n\nEsperado: server1 listado como en espera, server2 como principal.<\/p>\n\n\n\n
\n\n\n\n