SQWareProduction:cassandra:bin:sqwcas CentralisedNodetool.ksh : Différence entre versions

Version actuelle datée du 7 avril 2024 à 16:02

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_CasBin/sqwcas_CentralisedNodetool.ksh :

Execute une commande nodetool sur tous les nodes selectionnes en parallele
Vous devez choisir les options de nodetool a executer
Vous pouvez aussi choisir:

Aggressivite de lancement (nombre de secondes entre deux lancements)
Aggressivite de check de fin (nombre de secondes entre deux check de fin)
Scope d'execution (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)

Force la decouverte dynamique des nodes (par defaut, cherche dans $gvsqw_RootCfg/CAS_CHR_PRD.clucfg genere par sqwcas_GenNodesConf.ksh)

Aide en ligne

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

Sourcing sqwcas_Global.lib v2024.07 SQWareProduction for Cassandra (dbSQWare) ... 

Utilisation: sqwcas_CentralisedNodetool.ksh [-h] -I <CAS_SID> -C <command options> [+ options]

DESCRIPTION
   sqwcas_CentralisedNodetool.ksh Execute une commande 'nodetool' sur les nodes selectionnes
SUPPORT
   Cassandra versions supportees: 2.0 <= v <= 4.0

PARAMETERS
     -I  instance       : Instance cible.
     -C  command        : Options de la commande nodetool (ex: 'version', 'compact keyspace column_family' ou autre).
OPTIONS
     -h                 : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -S    scope        : Scope d'execution (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).
     -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 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.
     -Dynamic           : Force la decouverte dynamique des nodes (par defaut, cherche dans $gvsqw_RootCfg/.clucfg generee par sqwcas_GenNodesConf.ksh).
     -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 'CAS_SID' parameter, Utilisation: sqwcas_CentralisedNodetool.ksh [-h] -I <CAS_SID> -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).

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_cassandra : " (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 sqwcas_Global.lib v2024.07 SQWareProduction for Cassandra (dbSQWare) ... 

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

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

$gvsqw_CasBin/sqwcas_CentralisedNodetool.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_CentralisedNodetool.ksh -s
#Affichage des exemples d'utilisation pour ce script

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C <command options>
#Affiche l'ensemble des commandes generees par le script sans les executer

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -Exec
#Execute la commande nodetool sur tous les nodes selectionnes en parallele (par defaut seulement le node local)

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C 'version' -S <scope> -Exec
#Execute la commande 'nodetool version' sur <scope> nodes du cluster : All, LocalDC ...

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -S All -Dist -Exec
#Execute la commande 'nodetool version' sur <scope> avec une connexion distante pour l'instance non locale $CAS_SID pour tous les nodes
#Vous devez saisir toutes les informations d'authentification a utiliser pour la connexion distante a l'instance dans le fichier $gvsqw_DistPasswdFile

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -Timeout -Exec
#Delai d'interruption en secondes pour fermer les sessions ssh inactives (par defaut 3600s, geree par $gvsqw_TimeOut)

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -Dynamic -Exec
#Force le scope a une decouverte dynnamique (by default, search in \$gvsqw_RootCfg/$CAS_SID.clucfg)

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -AGR 20 -Exec
#Reglage du temps d'attente en secondes entre deux lancements de commandes, 20s ici (par defaut 1s)

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -AGE 40 -Exec
#Reglage du temps d'attente en secondes entre deux check de fin, 40s ici (par defaut 5s)

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -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_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -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_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -NoMail -Exec
#Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, seulement en cas d'erreur)

$gvsqw_CasBin/sqwcas_CentralisedNodetool.ksh -I $CAS_SID -C <command options> -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

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

@@ Ligne 5 : / Ligne 5 : @@
 |
 <pre>
-Lack 'CAS_SID' parameter, Utilisation: sqwcas_CentralisedNodetool.ksh [-h] -I <instance> -C <command options> [+ options]
+Lack 'CAS_SID' parameter, Utilisation: sqwcas_CentralisedNodetool.ksh [-h] -I <CAS_SID> -C <command options> [+ options]
 </pre>
 |
 <pre>
-Begining     : 2020-11-29 19:59:57
+Not sending mail because you are in connected mode !!!
-End          : 2020-11-29 19:59:57
+Lack 'CAS_SID' parameter
-Duration     : 00:00:00
 </pre>
 |
 {{SQWareProduction_sqwcas_CentralisedNodetool.ksh_example}}
 }}

SQWareProduction:cassandra:bin:sqwcas CentralisedNodetool.ksh : Différence entre versions

Version actuelle datée du 7 avril 2024 à 16:02

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