SQWareProduction:oracle:bin:sqwora PurgeAlert.ksh

De WikiFr_dbSQWare
Révision datée du 2 juillet 2021 à 15:38 par BatchUser (discussion | contributions) (Updated by BatchUser)
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)
Aller à : navigation, rechercher

Presentation

Script $gvsqw_OraBin/sqwora_PurgeAlert.ksh :


archive/purge des fichiers trace/alert de l'instance
Realise une archive (tgz) de l'arborescence diagnostic
Purge les anciennes archives apres un nombre de jours



Aide en ligne

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

Sourcing sqwora_Global.lib v2024.07 SQWareProduction for Oracle (dbSQWare) ... 

Utilisation: sqwora_PurgeAlert.ksh [-h] -I <instance> [+ options]

DESCRIPTION
   sqwora_PurgeAlert.ksh archive/purge alert.log/*.trc/*.aud ...
SUPPORT
   Oracle versions supportees: 9iR2 <= v <= 21c

PARAMETERS
     -I  instance       : Instance cible.
OPTIONS
     -h                 : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -FRT return_code   : Valeur forcee du code retour sur erreur.
     -AddMail   email   : Adresse Email a ajouter a 'pmexpdba@gmail.com'.
     -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).
     -HI       nb_days  : Nombre de jours avant de supprimer les archives (par defaut: 30).

Information.png
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 instance parameter, Utilisation: sqwora_PurgeAlert.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 instance 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_oracle : " (Voir l'aide pour personnaliser cette variable).

Information.png
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_oracle : " (Voir l'aide pour personnaliser cette variable).

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


Exemples d'utilisation

Sourcing sqwora_Global.lib v2024.07 SQWareProduction for Oracle (dbSQWare) ... 

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


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

$gvsqw_OraBin/sqwora_PurgeAlert.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_OraBin/sqwora_PurgeAlert.ksh -s
#Affichage des exemples d'utilisation pour ce script

$gvsqw_OraBin/sqwora_PurgeAlert.ksh -I $ORACLE_SID
#Archive/purge des fichiers trace/alert de l'instance

$gvsqw_OraBin/sqwora_PurgeAlert.ksh -I $ORACLE_SID -HI 4
#Nombre de jours avant de supprimer les archives, ici 4

$gvsqw_OraBin/sqwora_PurgeAlert.ksh -I $ORACLE_SID -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com'
#Ajoute la liste de mail a l'adresse par defaut geree par $gvsqw_GlobalMail

$gvsqw_OraBin/sqwora_PurgeAlert.ksh -I $ORACLE_SID -SendReport
#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_OraBin/sqwora_PurgeAlert.ksh -I $ORACLE_SID -NoMail
#Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, seulement en cas d'erreur)

$gvsqw_OraBin/sqwora_PurgeAlert.ksh -I $ORACLE_SID -FRT <NumericValue>
#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_sqwora_PurgeAlert=<NumericValue>
#dans le fichier de configuration $gvsqw_OraBin/../etc_cust/sqwora_GlobalVar.cfg
Information.png
Information:
Pour être sûr que les exemples sont exacts, reportez-vous directement à l'option d'aide en ligne du script -s .