walmgr3 - En ligne dans le Cloud

PROGRAMME:

Nom

walmgr3 - outil de gestion de la réplication basée sur WAL pour PostgreSQL.

SYNOPSIS

walmgr3 commande [--pas-vraiment] [options]

DESCRIPTION

Walmgr3 est un outil pour gérer la réplication de PostgreSQL avec PITR (également connu sous le nom de Log
Expédition).

Ce script permet de configurer et d'administrer la réplication, il est également utilisé par PostgreSQL
pour archiver et restaurer les fichiers WAL.

Voir DÉMARRAGE RAPIDE ci-dessous pour démarrer votre première expédition de journal en quelques étapes.

L' commander est l'une des commandes Maître, Esclave, Commun ou Interne répertoriées ci-dessous.

GÉNÉRAL OPTIONS

-V, --version
Imprimer les informations sur la version et quitter.

-h, --aide
Affichez ce message d'aide et quittez.

-q, --calme
Enregistrez uniquement les erreurs et les avertissements.

-v, --verbeux
Connectez-vous en détail.

-d, --démon
Exécuter en mode démon (aller en arrière-plan).

-n, --pas-vraiment
Montrez ce qui serait fait sans rien faire.

SPÉCIFIQUE OPTIONS

--ini
Afficher un exemple de fichier ini.

--set="param=val[,param=valeur]"
Remplacer le paramètre de configuration

--init-maître
Initialisez la configuration principale de walmgr3.

--init-esclave
Initialisez la configuration de l'esclave walmgr3.

--config-dir=chemin du fichier
Emplacement du fichier de configuration pour les commandes --init-X.

--esclave=nom d'hôte
Nom d'hôte esclave.

--pgdata=chemin
Répertoire de données PostgreSQL.

--ssh-keygen
Générez une paire de clés SSH si nécessaire (utilisée dans Master).

--ssh-add-key=fichier_clé.pub
Ajoutez le fichier de clé publique au fichierauthorized_hosts (utilisé dans Slave).

--ssh-remove-key=clé_ssh
Supprimez la clé ssh principale du fichierauthorized_hosts (utilisé dans l'esclave).

--primary-conninfo=chaîne de connexion
Fournissez la chaîne de connexion au maître de réplication en streaming (utilisé en esclave).

--ajouter-mot de passe=fichier_texte_plain
Ajoutez un mot de passe pour la réplication en continu du fichier texte brut vers .pgpass. Supplémentaire
les champs pour la saisie du fichier de mot de passe seront extraits de primary-conninfo (utilisé dans
Trimer).

--supprimer le mot de passe
Supprimer l'entrée .pgpass, qui était utilisée pour la réplication en continu (utilisée dans l'esclave)

--synch-standby=noms_de_veille_synchrone
Faites la même chose que la commande synchro-standby, mais le fichier ini walmgr n'est pas utilisé. Cette
L'option peut être utilisée lorsque walmgr ini n'est pas disponible. Il essaie de deviner le postgres
emplacement de configuration, l'option --pgdata peut également être nécessaire. (utilisé dans Master)

DÉMON OPTIONS

-r, --recharger
Recharger la configuration (envoyer SIGHUP).

-s, --stop
Arrêtez le programme en toute sécurité (envoyez SIGINT).

-k, --kill
Tuez le programme immédiatement (envoyez SIGTERM).

MASTER COMMANDES

installation
Configure PostgreSQL pour l'archivage WAL, crée les structures de répertoires nécessaires sur l'esclave.

synchroniser
Copie les fichiers WAL en cours vers l'esclave.

démon de synchronisation
Démarrez la synchronisation WAL en mode démon. Cela commencera périodiquement à synchroniser le
fichiers WAL en cours vers l'esclave.

Les paramètres de configuration suivants sont utilisés pour piloter le syncdaemon :

· boucle_delay - combien de temps dormir entre les synchronisations.

· use_xlog_functions - utiliser l'expédition basée sur les enregistrements pour synchroniser les WAL en cours
segments.

Arrêtez
Arrêtez l'archivage et déconfigurez l'archivage PostgreSQL.

périodique
Exécute la commande périodique si configuré. Cela permet d'exécuter des commandes arbitraires sur
intervalle, utile pour synchroniser les scripts, les fichiers de configuration, les crontabs, etc.

synchronisation-veille
Active/désactive la réplication de streaming synchrone pour le(s) nom(s) d'application donné(s). Fait
vérification supplémentaire avant d'activer le mode synchrone.

ESCLAVE COMMANDES

botte
Arrêtez la lecture WAL et ouvrez la base de données afin qu'elle puisse accepter les requêtes.

pause
Suspend la lecture WAL.

continuer
Continue la lecture WAL précédemment mise en pause.

créer un esclave
Crée une sauvegarde à partir de la base de données principale à l'aide de la réplication en continu. crée également
recovery.conf et démarre la veille esclave. La sauvegarde est créée avec pg_basebackup et
pg_receivexlog (disponible en 9.2 et plus).

COMMUNE COMMANDES

liste de sauvegardes
Répertorie les sauvegardes disponibles sur le nœud esclave.

sauvegarde
Crée une nouvelle sauvegarde de base à partir de la base de données principale. Purgera les sauvegardes expirées et les fichiers WAL
sur l'esclave si keep_backups n'est pas spécifié. Lors d'une sauvegarde, un fichier de verrouillage est créé dans Slave
répertoire complete_wals. Ceci afin d'éviter les sauvegardes simultanées et les
la corruption. Si l'exécution de la sauvegarde est interrompue, le fichier BACKUPLOCK devra peut-être être supprimé
manuellement.

EXPÉRIMENTAL : S'il est exécuté sur l'esclave, crée une sauvegarde à partir des données de l'esclave en cours de récupération. La lecture WAL est
en pause, le répertoire de données esclave est sauvegardé dans le répertoire full_backup et la lecture WAL est
a repris. Les sauvegardes sont alternées selon les besoins. L'idée est de déplacer la charge de sauvegarde loin de
nœud de production. Utilisable à partir de PostgreSQL 8.2 et versions ultérieures.

restaurer [src[heure d'été]]
Restaure le jeu de sauvegarde spécifié dans le répertoire cible. Si spécifié sans arguments, le
la dernière sauvegarde est déménagé vers le répertoire de données de l'esclave (n'obéit pas aux règles de conservation). Si src
backup est spécifié, la sauvegarde est copiée (au lieu d'être déplacée). Destination alternative
répertoire peut être spécifié avec dst.

nettoyage
Nettoyez tous les fichiers walmgr3 après l'arrêt.

INTERNE COMMANDES

xarchive
Sur Master, archivez un fichier WAL.

xrestaurer [dernier point de redémarrage wal]
Sur l'esclave, restaurez un fichier WAL.

xlock
Sur Master, créez un fichier de verrouillage pour refuser d'autres sauvegardes simultanées.

xversion
Sur l'esclave, supprimez le fichier de verrouillage de sauvegarde, autorisez l'exécution d'une autre sauvegarde.

xrotation
Faites pivoter les sauvegardes en augmentant les suffixes des répertoires de sauvegarde. Notez que puisque nous devons également
faire de la place pour la prochaine sauvegarde, nous avons en fait garder_sauvegardes - 1 sauvegardes disponibles après cela.

Les fichiers WAL inutiles ne sont pas supprimés ici, ils sont gérés par la commande xpurgewals à la place.

xpurgewals
Sur l'esclave, supprimez les fichiers WAL non nécessaires à la récupération.

xpartialsync
Lire octets valeur de données de stdin, ajoutez au fichier WAl partiel à partir de compenser.
En cas d'erreur, il est supposé que le maître redémarre à partir de zéro.

Le fichier résultant est toujours rempli d'octets XLOG_SEGMENT_SIZE pour simplifier la récupération.

CONFIGURATION

Commun Paramétres
nom du travail
Optionnel. Identifie ce script, utilisé dans la journalisation. Rester unique si vous utilisez le central
enregistrement.

fichier journal
Où se connecter.

use_skylog
Optionnel. Si non nul, skylog.ini est utilisé pour la configuration du journal.

Master Paramétres
fichier pid
Emplacement du fichier pid pour le mode syncdaemon (si exécuté avec -d). Sinon pas obligatoire.

master_db
Base de données à laquelle se connecter pour pg_start_backup(), etc. Ce n'est pas une bonne idée d'utiliser
dbname=template si vous exécutez syncdaemon en mode d'expédition d'enregistrement.

données de base
Emplacement du répertoire de données de base.

maître_config
Emplacement du fichier maître postgresql.conf. C'est là que archive_command est mis à jour.

master_restart_cmd
La commande pour redémarrer la base de données principale, utilisée après avoir changé archive_mode
paramètre. Ne pas définir si vous ne pouvez pas vous permettre de redémarrer la base de données à l'installation/à l'arrêt.

esclave
Hôte esclave et répertoire de base.

configuration_esclave
Emplacement du fichier de configuration pour l'esclave walmgr3.

terminé_wals
Répertoire esclave où les fichiers WAL archivés sont copiés.

partiel_wals
Répertoire esclave où sont stockés les fichiers WAL incomplets.

sauvegarde_complète
Répertoire esclave où sont stockées les sauvegardes complètes.

config_backup
Optionnel. Répertoire esclave où sont stockées les sauvegardes des fichiers de configuration.

boucle_delay
La fréquence des mises à jour de syncdaemon. En mode d'expédition record, uniquement des mises à jour incrémentielles
sont envoyés, donc un intervalle plus petit peut être utilisé.

use_xlog_functions
Utilisez les fonctions pg_xlog pour les expéditions basées sur les enregistrements (disponibles dans les versions 8.2 et supérieures).

compression
Si différent de zéro, un indicateur -z est ajouté à la cmdline rsync. Il réduit le trafic réseau au
coût du temps CPU supplémentaire.

keep_symlinks
Conservez les liens symboliques pour pg_xlog et pg_log.

pose chaude
S'il est défini sur 1, la configuration de walmgr3 définira wal_level sur hot_standby (PostgreSQL 9.0 et
plus récent).

intervalle_commande
Combien de fois exécuter un script de commande périodique. En quelques secondes, et uniquement évalué lors du changement de journal
fois.

commande_périodique
Script shell à exécuter à un intervalle de temps spécifié. Peut être utilisé pour la synchronisation
scripts, fichiers de configuration, etc.

Échantillon master.ini
[walmgr]
nom_travail = wal-master
fichier journal = ~/journal/%(nom_travail)s.log
fichier pid = ~/pid/%(nom_travail)s.pid
use_skylog = 1

master_db = dbname = ma_db
master_data = /var/lib/postgresql/9.1/main
master_config = /etc/postgresql/9.1/main/postgresql.conf
master_bin = /usr/lib/postgresql/9.1/bin

# définissez ceci uniquement si vous pouvez vous permettre de redémarrer la base de données pendant l'installation et l'arrêt.
#master_restart_cmd = /etc/init.d/postgresql-9.1 redémarrer

esclave = esclave-hôte
slave_config = /var/lib/postgresql/conf/wal-slave.ini

walmgr_data = /var/lib/postgresql/walshipping
complete_wals = %(walmgr_data)s/logs.complete
partial_wals = %(walmgr_data)s/logs.partial
full_backup = %(walmgr_data)s/data.master
config_backup = %(walmgr_data)s/config.backup

# fréquence de mise à jour syncdaemon
boucle_délai = 10.0
# utiliser l'expédition basée sur les enregistrements disponible depuis la 8.2
use_xlog_functions = 0

# passez -z à rsync, utile sur les liens à faible bande passante
compression = 0

# garde les liens symboliques pour pg_xlog et pg_log
keep_symlinks = 1

# indique à walmgr de définir wal_level sur hot_standby lors de l'installation
#hot_standby = 1

# synchronisation périodique
#commande_intervalle = 600
#commande_périodique = /var/lib/postgresql/walshipping/periodic.sh

Esclave Paramétres
données_esclave
Répertoire de données PostgreSQL pour l'esclave. C'est là que se trouve la sauvegarde restaurée
copié/déplacé.

esclave_bin
Spécifie l'emplacement des binaires PostgreSQL (pg_controldata, etc.). Nécessaire s'ils
ne sont pas déjà dans le PATH.

esclave_stop_cmd
Script pour arrêter PostgreSQL sur l'esclave.

esclave_start_cmd
Script pour démarrer PostgreSQL sur Slave.

rép_config_esclave
Répertoire des fichiers de configuration PostgreSQL. Si spécifié, tentatives de restauration walmgr3
pour restaurer les fichiers de configuration à partir du répertoire config_backup.

esclave_pg_xlog
Définissez le répertoire sur l'esclave où les fichiers pg_xlog sont écrits. Lors d'une restauration à
l'esclave walmgr3 créera un lien symbolique de data/pg_xlog vers cet emplacement.

terminé_wals
Répertoire où sont stockés les fichiers WAL complets. Divers fichiers de contrôle sont également
créés dans ce répertoire (BACKUPLOCK, STOP, PAUSE, etc.).

partiel_wals
Répertoire où sont stockés les fichiers WAL partiels.

sauvegarde_complète
Répertoire où sont stockées les sauvegardes complètes.

config_backup
Optionnel. Répertoire esclave où sont stockées les sauvegardes des fichiers de configuration.

rép_données de sauvegarde
Définissez backup_datadir sur aucune pour empêcher walmgr3 de faire une sauvegarde du répertoire de données
lors de la restauration sur l'esclave. Cette valeur par défaut est oui.

garder_sauvegardes
Nombre de sauvegardes à conserver. De plus, tous les fichiers WAL nécessaires pour effectuer la première sauvegarde jusqu'à
date sont conservés. Les sauvegardes sont tournées avant le démarrage d'une nouvelle sauvegarde, donc à un moment donné
il y a en fait une sauvegarde de moins disponible.

Cela n'a probablement pas de sens de spécifier keep_backups si les sauvegardes périodiques ne sont pas
effectuée - les fichiers WAL s'accumuleront rapidement.

Les sauvegardes seront nommées data.master, data.master.0, data.master.1 etc.

archive_commande
Script à exécuter avant de supprimer la sauvegarde la plus ancienne. En cas d'échec, les sauvegardes ne
être tourné.

primaire_conninfo
Chaîne de connexion à la base de données principale pour le hot standby - l'activation de celle-ci entraînera le
Esclave à démarrer en mode Hot Standby.

Échantillon esclave.ini
[walmgr]
job_name = wal-esclave
fichier journal = ~/journal/%(nom_travail)s.log
use_skylog = 1

slave_data = /var/lib/postgresql/9.1/main
esclave_bin = /usr/lib/postgresql/9.1/bin
slave_stop_cmd = /etc/init.d/postgresql-9.1 arrêter
slave_start_cmd = /etc/init.d/postgresql-9.1 démarrer
rép_config_esclave = /etc/postgresql/9.1/main

# répertoire alternatif pg_xlog pour l'esclave, lié symboliquement à pg_xlog lors de la restauration
#slave_pg_xlog = /vol2/pg_xlog

walmgr_data = ~/Walshipping
complete_wals = %(walmgr_data)s/logs.complete
partial_wals = %(walmgr_data)s/logs.partial
full_backup = %(walmgr_data)s/data.master
config_backup = %(walmgr_data)s/config.backup

backup_datadir = oui
keep_backups = 0
archive_commande =

# chaîne de connexion à la base de données principale pour le hot standby -- activation
# cela entraînera le démarrage de l'esclave en mode hot standby.
#primary_conninfo = hôte=port maître=5432 utilisateur=postgres

EXIT STATUT

0
Exécution réussie du programme.

ENVIRONNEMENT

Les variables d'environnement PostgreSQL peuvent être utilisées.

RAPIDE La START

1. Configurez la clé ssh sans mot de passe sur le maître et écrivez le fichier de configuration

master$ walmgr3 --ssh-keygen --init-master --slave

2. Configurez l'authentification ssh sans mot de passe du maître à l'esclave et écrivez la configuration
fichier sur l'esclave

esclave$ walmgr3 --init-slave --ssh-add-key=/tmp/id_rsa.pub

3. Configuration de la journalisation sur le maître et l'esclave

master$ cp skylog.ini ~postgres/
esclave$ cp skylog.ini ~postgres/

4. Démarrez le processus d'archivage et créez une sauvegarde de base

master$ walmgr3 /var/lib/postgresql/conf/wal-master.ini configuration
master$ walmgr3 /var/lib/postgresql/conf/wal-master.ini sauvegarde

ATTENTION : à partir de PostgreSQL 8.3 l'archivage est activé par
en définissant archive_mode GUC sur on. Cependant changer ce paramètre
nécessite le redémarrage du serveur.

5. Préparez postgresql.conf et pg_hba.conf sur Slave et lancez la relecture

slave$ walmgr3 /var/lib/postgresql/conf/wal-slave.ini restaurer

Pour les distributions basées sur Debian, les fichiers de configuration standard sont
situé dans le répertoire /etc/postgresql/xx/main. Si un autre régime est
utilisé le postgresql.conf et pg_hba.conf doit être copié sur slave
répertoire full_backup. Assurez-vous de désactiver archive_command dans l'esclave
config.

'walmgr3 restore' déplace les données en place, crée recovery.conf et
démarre postmaster en mode de récupération.

6. Les segments WAL en cours peuvent être sauvegardés par commande :

master$ walmgr3 /var/lib/postgresql/conf/wal-master.ini synchronisation

7. Si vous devez arrêter la relecture sur l'esclave et démarrer en mode normal, procédez comme suit :

esclave$ walmgr3 /var/lib/postgresql/conf/wal-slave.ini démarrage

01/15/2016 WALMGR3(1) en anglais

Utilisez walmgr3 en ligne en utilisant les services onworks.net