SQWareProduction:postgres:bin:sqwpg DumpAllDatabases.ksh : Différence entre versions

Version actuelle datée du 2 juillet 2021 à 15:38

Sommaire

1 Presentation
2 Aide en ligne
3 Traitement de l'erreur
- 3.1 Erreurs de parse des arguments
- 3.2 Execution errors
4 Exemples d'utilisation

Presentation

Script $gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh :

Execution de sqwpg_DumpDatabase.ksh en mode parallele
Vous pouvez choisir:

Le degre de parallelisme
Aggressivite de lancement (nombre de secondes entre deux lancements)
Aggressivite de check de fin (nombre de secondes entre deux check de fin)

Filtres de generation de la liste des databases (vous pouvez tous les mixer):

Liste d'inclusion de database
Liste d'exclusion de database
Clause d'inclusion de type like
Clause d'exclusion de type like
Clause where

Aide en ligne

L'aide en ligne est accessible dans la plupart des scripts avec l'option -h.
Ex: $gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -h
Contenu de l'aide :

Sourcing sqwpg_Global.lib v2024.07 SQWareProduction for PostgreSQL (dbSQWare) ... 

Utilisation: sqwpg_DumpAllDatabases.ksh [-h] -I instance [+ options]

DESCRIPTION
   sqwpg_DumpAllDatabases.ksh Dump des bases de donnees en parallele
SUPPORT
   PostgreSQL versions supportees: 9.0 <= v <= 16

PARAMETERS
     -I  instance       : Instance cible pour pg_dump.
OPTIONS
     -h                 : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -P  Nb threads     : Nombre de threads en parallele (par defaut 2).
     -F  format         : Format du pg_dump (p,t,c,d).
     -S                 : Trie la liste des bases de donnees par taille 'pg_database_size(oid) desc'.
     -RD directory      : Repertoire pour ecrire le fichier dump (par defaut /pgbackup/$PG_SID).
     -ID listdb         : Liste des bases de donnees pour execution du dump (par defaut toutes).
     -ED listdb         : Liste des bases de donnees a exclure du dump.
     -IL likeclause     : Clause d'inclusion de type like pour generer la liste des bases de donnees (exemple: 'db%').
     -EL likeclause     : Clause d'exclusion des bases de donnees de type like (exemple: 'nodb%').
     -HI Nb_Generations : Nombre de generations a garder (par defaut 2).
     -WCD  whereclause  : Clause where pour generer la liste des databases.
     -AGR Nb_sec        : Nombre de secondes entre deux lancements (par defaut 1s).
     -AGE Nb_sec        : Nombre de secondes entre deux check de fin (par defaut 10s).
     -ZIP extension     : Compressor extension gz,bz2,Z,none (par defaut: gz).
     -FRT       code    : Valeur forcee du code retour sur erreur.
     -Opt       option  : Remplace les options par defaut pour pg_dump.
     -AddMail   email   : Adresse Email a ajouter a 'pmexpdba@gmail.com'.
     -SendReport        : Envoi du rapport d'execution.
     -Dist              : Pour connexion distante a la base de donnees (change $gvsqw_ConnectString par $gvsqw_DistConnectString ).
     -ForceDump         : Force le DUMP meme si le cluster est en recovery (par defaut, 'Disable').
     -NoForceDump       : Ne fait pas le DUMP si le cluster est en recovery (par defaut, 'Disable').
     -NoMail            : Desactive l'envoi de mail sur erreur a pmexpdba@gmail.com (par defaut, envoi sur erreur).
     -Locale    locale  : Force la Locale d'affichage de l'aide (fr,en).
     -Exec              : Execute les commandes generees (par defaut, affiche les commandes generees).

Information:
Pour etre sur d'avoir une aide a jour, reportez vous directement a l'aide en ligne du script avec l'option -h .

Traitement de l'erreur

Erreurs de parse des arguments

Ce type de message est genere:

Lack 'PG_SID' parameter, Utilisation: sqwpg_DumpAllDatabases.ksh [-h]  -I instance [+ options]

Si vous vous connectez via un terminal, aucun mail ne sera envoyé et vous aurez plutôt ce type de message:

Not sending mail because you are in connected mode !!!
Lack 'PG_SID' parameter

Si vous n'êtes pas connecté à un terminal, le message d'erreur apparaît et est envoyé par mail à l'adresse contenue dans la variable $gvsqw_GlobalMail (Voir l'aide pour personnaliser cette variable). L'objet commence toujours par "$gvsqw_MailMsg_postgres : " (Voir l'aide pour personnaliser cette variable).

Information:
L'envoi de mail peut être désactivé par l'option -NoMail pour une exécution.

Execution errors

Que vous soyez ou non connecté à un terminal, le message d'erreur apparaît et un mail contenant un résumé des erreurs de traitement est envoyé à l'adresse contenue dans la variable $gvsqw_GlobalMail (Voir l'aide pour personnaliser cette variable). L'objet commence toujours par "$gvsqw_MailMsg_postgres : " (Voir l'aide pour personnaliser cette variable).

Information:
L'envoi de mail peut être désactivé par l'option -NoMail pour une exécution.

Exemples d'utilisation

Sourcing sqwpg_Global.lib v2024.07 SQWareProduction for PostgreSQL (dbSQWare) ... 

#Standard (Locale) help for script sqwpg_DumpAllDatabases.ksh:


$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -h
#Affichage de l'aide en ligne pour ce script

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -Locale fr -h
#Affichage de l'aide en ligne pour ce script avec forcage de la locale 'fr' (Locale par defaut geree par $gvsqw_Locale)

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -s
#Affichage des exemples d'utilisation pour ce script

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID 
#Genere les commandes mais ne les execute pas !

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -Exec
#Execute un pg_dump via sqwpg_DumpDatabase.ksh sur toutes les databases

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -Dist -Exec
#Execute un pg_dump de toutes les databases de l'instance non-locale $PG_SID avec une connexion distante
#Vous devez saisir toutes les informations d'authentification a utiliser pour la connexion distante a l'instance dans le fichier $gvsqw_DistPasswdFile

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -RD -Exec
#Genere les dumps dans le repertoire cible (par defaut /pgbackup/$PG_SID)

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -ForceDump -Exec
#Execute le dump meme si le cluster est en recovery mode (Par defaut 'Disable')

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -NoForceDump -Exec
#Execute le dump sauf si le cluster est en recovery mode (Par defaut 'Disable')

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -ZIP <ZipExtension> -F <Format> -Exec
#Execute les commandes generees et les compresse (gz,bz2,Z,none) avec le format pg_dump (p,t,c,d)

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -S -Exec
#Genere les commandes mais ne les execute pas et les trie !

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -HI <NumberOfGenerations> -Exec
#Change le nombre de generation a garder

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -AGR 20 -Exec
#Reglage du temps d'attente en secondes entre deux lancements de commandes, 20s ici

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -AGE 30 -Exec
#Reglage du temps d'attente en secondes entre deux check de fin, 30s ici

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -ID 'DbName1,DbName2' -Exec
#Execute les commandes generees pour seulement les 2 bases de donnees specifiees

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -ED 'DbName3,DbName4' -Exec
#Execute les commandes generees sauf pour les 2 bases de donnees specifiees

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -IL '%_PROD' -Exec
#Clause like pour generee une liste dynamique de bases a inclure (exemple: 'dbprod%')

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -EL '%_TESTS' -Exec
#Clause like pour generee une liste dynamique de bases a exclure (exemple: 'dbtest%')

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -WCD '<condition>' -Exec
#Clause where pour generee une liste dynamique de bases a inclure (exemple: 'OPEN_MODE=MOUNTED')

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -P <NumericValue> -Exec
#Execute le script sqwpg_DumpDatabase.ksh avec un degre de parallelisme de '<NumericValue>'
#Utilise par defaut la variable gvsqw_NbThreadXXX dans $gvsqw_PgBin/../etc/sqwpg_GlobalVar.cfg
#Vous pouvez changer le defaut sur tout l'environnement si vous settez cette variable
#dans le fichier de configuration $gvsqw_PgBin/../etc_cust/sqwpg_GlobalVar.cfg

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com' -Exec
#Ajoute la liste de mail a l'adresse par defaut geree par $gvsqw_GlobalMail

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -SendReport -Exec
#Envoie la log par mail a la fin du traitement meme s'il n'y a pas d'erreur (par defaut, seulement en cas d'erreur)

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -NoMail -Exec
#Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, seulement en cas d'erreur)

$gvsqw_PgBin/sqwpg_DumpAllDatabases.ksh -I $PG_SID -FRT <NumericValue> -Exec
#Force le code retour a '<NumericValue>' sur erreur (si pas d'erreur, "exit 0"!)
#Vous pouvez aussi forcer le code retour de ce script pour tous
#si vous settez la variable d'environnement: $gvsqw_ForcedReturnCodeScript_sqwpg_DumpAllDatabases=<NumericValue>
#dans le fichier de configuration $gvsqw_PgBin/../etc_cust/sqwpg_GlobalVar.cfg

Information:
Pour être sûr que les exemples sont exacts, reportez-vous directement à l'option d'aide en ligne du script -s .

@@ Ligne 9 : / Ligne 9 : @@
 |
 <pre>
-Begining     : 2020-11-29 20:01:14
+Not sending mail because you are in connected mode !!!
-End          : 2020-11-29 20:01:14
+Lack 'PG_SID' parameter
-Duration     : 00:00:00
 </pre>
 |
 {{SQWareProduction_sqwpg_DumpAllDatabases.ksh_example}}
 }}

SQWareProduction:postgres:bin:sqwpg DumpAllDatabases.ksh : Différence entre versions

Version actuelle datée du 2 juillet 2021 à 15:38

Sommaire

Presentation

Aide en ligne

Traitement de l'erreur

Erreurs de parse des arguments

Execution errors

Exemples d'utilisation

Menu de navigation

Outils personnels

Espaces de noms

Variantes

Affichages

Plus

Rechercher

WikiFr

Général

SQWareProduction

Annexes

Outils