SQWareProduction:cassandra:bin:sqwcas Backup.ksh : Différence entre versions
m (Updated by BatchUser) |
m (Updated by BatchUser) |
||
| Ligne 9 : | Ligne 9 : | ||
| | | | ||
<pre> | <pre> | ||
| − | + | Not sending mail because you are in connected mode !!! | |
| − | + | Lack 'CAS_SID' parameter | |
| − | |||
</pre> | </pre> | ||
| | | | ||
{{SQWareProduction_sqwcas_Backup.ksh_example}} | {{SQWareProduction_sqwcas_Backup.ksh_example}} | ||
}} | }} | ||
Version du 2 juillet 2021 à 15:38
Sommaire
Presentation
Script $gvsqw_CasBin/sqwcas_Backup.ksh :
Execute une sauvegarde sur tous les nodes
- Etendue (Scope) d'excecution (par defaut: Local)
** Local => seulement le node local
** LocalNode => seulement le node local
** Node_$NodeName => seulement sur le node '$NodeName'
** LocalDC => tous les nodes sur local datacenter
** DC_$DCName => tous les nodes sur datacenter '$DCName'
** All => tous les nodes sur cluster(tous les datacenters)
** AllNodes => tous les nodes sur cluster(tous les datacenters)
** AllDC => tous les nodes sur cluster(tous les datacenters)
Aide en ligne
L'aide en ligne est accessible dans la plupart des scripts avec l'option -h.
Ex: $gvsqw_CasBin/sqwcas_Backup.ksh -h
Contenu de l'aide :
Sourcing sqwcas_Global.lib v2024.07 SQWareProduction for Cassandra (dbSQWare) ...
Utilisation: sqwcas_Backup.ksh [-h] -I <CAS_SID> -Type <type de sauvegarde> [+ options]
DESCRIPTION
sqwcas_Backup.ksh Execute Sauvegarde de toutes les nodes
SUPPORT
Cassandra versions supportees: 2.0 <= v <= 4.0
PARAMETERS
-I instance : Instance cible.
-Type type : Type de sauvegarde full (snapshot) ou inc (backup).
OPTIONS
-h : Affichage de l'aide complete.
-s : Affichage des exemples d'utilisation.
-S scope : Scope d'execution (par defaut: All).
Local => seulement le node local.
LocalNode => seulement le node local.
Node_$NodeName => seulement sur le node '$NodeName'.
LocalDC => tous les nodes sur local datacenter.
DC_$DCName => tous les nodes sur datacenter '$DCName'.
All => tous les nodes sur cluster(tous les datacenters).
AllNodes => tous les nodes sur cluster(tous les datacenters).
AllDC => tous les nodes sur cluster(tous les datacenters).
-P Nb threads : Nombre de threads en parallele (par defaut 3).
-HI Nb : Nombre de generations a garder (par defaut 2).
-AGR Nb_sec : Nombre de secondes entre deux lancements (par defaut 0s).
-AGE Nb_sec : Nombre de secondes entre deux check de fin (par defaut 5s).
-FRT code : Valeur forcee du code retour sur erreur.
-AddMail email : Adresse Email a ajouter a 'pmexpdba@gmail.com'.
-Timeout Nb_sec : Timeout avant kill de session ssh.
-SendReport : Envoi du rapport d'execution.
-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).
-NoDelete : Conserve l'historique des fichiers.
-Exec : Execute les commandes generees (par defaut, affiche les commandes generees).
Traitement de l'erreur
Erreurs de parse des arguments
Ce type de message est genere:
Lack 'CAS_SID' parameter, Utilisation: sqwcas_Backup.ksh [-h] -I <instance> -C <command options> [+ 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 'CAS_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_cassandra : " (Voir l'aide pour personnaliser cette variable).
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_cassandra : " (Voir l'aide pour personnaliser cette variable).
Exemples d'utilisation
Sourcing sqwcas_Global.lib v2024.07 SQWareProduction for Cassandra (dbSQWare) ... #Standard (Locale) help for script sqwcas_Backup.ksh: $gvsqw_CasBin/sqwcas_Backup.ksh -h #Affichage de l'aide en ligne pour ce script $gvsqw_CasBin/sqwcas_Backup.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_CasBin/sqwcas_Backup.ksh -s #Affichage des exemples d'utilisation pour ce script $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> #Affiche l'ensemble des commandes generees par le script sans les executer $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -HI 4 -Exec #Execute une sauvegarde de type selectionne : 'full' (snapshot) ou 'inc' (backup), et converse 4 versions precedentes des sauvegardes $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -S <Scope> -HI <NumberOfGenerations> -Exec #Change l'etendue <Scope> de l'execution (par defaut local) et le nombre de sauvegardes historiques a garder (2 par defaut, geree par $gvsqw_backupNbGeneration) $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -NoDelete -Exec #Conserve les sauvegardes historiques (par defaut 2, gere par $gvsqw_backupNbGeneration) $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -AGR 20 -Exec #Reglage du temps d'attente en secondes entre deux lancements de commandes, ici 20s (par defaut 10s) $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -AGE 40 -Exec #Reglage du temps d'attente en secondes entre deux check de fin, ici 40s (par defaut 30s) $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -P <NumericValue> -Exec #Execute sqwcas_Backup.ksh script sur les nodes avec un degre de parallelisme de '<NumericValue>' #Utilise par defaut la variable gvsqw_NbThreadXXX dans $gvsqw_<gvsqw_RdbmsTrigram>/../etc/sqw<gvsqw_RdbmsTrigram>_GlobalVar.cfg #Vous pouvez changer le defaut sur tout l'environnement si vous parametrez cette variable #dans le fichier de configuration $gvsqw_<gvsqw_RdbmsTrigram>/../etc_cust/sqw<gvsqw_RdbmsTrigram>_GlobalVar.cfg $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com' -Exec #Ajoute la liste de mail a l'adresse par defaut geree par $gvsqw_GlobalMail (seulement cette fois), adresses mail separees par des virgules $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -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_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -NoMail -Exec #Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, seulement en cas d'erreur) $gvsqw_CasBin/sqwcas_Backup.ksh -I $CAS_SID -Type <BackupType> -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 $d'environnement: $gvsqw_ForcedReturnCodeScript_sqwcas_Backup=<NumericValue> #dans le fichier de configuration $gvsqw_CasBin/../etc_cust/sqwcas_GlobalVar.cfg
