SQWareProduction:oracle:bin:sqwora RmanClone.ksh

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_OraBin/sqwora_RmanClone.ksh :

Realise un clone RMAN
Le script est totalement automatique:

Check space (si vous avez customise la fonction)
Recupere le backup choisi qui peut etre:

- LastFull => restore le dernier backup full
- LastInc => restore le dernier backup incremental
- MaxTime => restore le dernier backup
- <tag> => restore ce backup tag (partie du nom de fichier)

Unregister du catalogue RMAN
Sauvegarde des anciens password
Supprime l'ancienne database
Execute le clone

Le script peut aussi:

Ignore les warnings d'espace disque (par defaut, sort en erreur)
Realise juste la copie des backups et s'arrete
change de user unix target/source
choix du degre de parallelisme de la copie des backups
Envoi du rapport d'execution
Execute un shell script avant load
Execute un shell script apres load

Ce script utilise le fichier de configuration $gvsqw_RootCfg/sqwora_Rman.cfg

Aide en ligne

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

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

Utilisation: sqwora_RmanClone.ksh [-h] -I <instance> -IS <instance> -US <hostname> -T <Type> [+ options]

DESCRIPTION
   sqwora_RmanClone.ksh duplique l'instance par Rman (clone)
SUPPORT
   Oracle versions supportees: 10gR2 <= v <= 21c

PARAMETERS
     -I  instance       : Instance cible. (clone).
     -IS instance       : Instance source.
     -US hostname       : Hostname pour l'instance source.
     -T  type           : Quelle sauvegarde utiliser:
                           - LastFull => restore la derniere sauvegarde full
                           - LastInc  => restore la derniere sauvegarde incremental
                           - MaxTime  => restore le dernier backup
                           - <tag>    => restore ce tag de sauvegarde (partie du nom de fichier)
OPTIONS
     -h                 : Affichage de l'aide complete.
     -s                 : Affichage des exemples d'utilisation.
     -P  Nb processes   : Nombre de threads en parallele (par defaut 4).
     -FRT return_code   : Valeur forcee du code retour sur erreur.
     -UUS  username     : Utilisateur unix source (par defaut, meme que la cible).
     -Before  script    : Script a executer avant clone.
     -After   script    : Script a executer apres clone.
     -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).
     -CopyOnly          : Realise juste la copie des backups et s'arrete.
     -IgnoreDiskWarning : Ignore les warnings d'espace disque (par defaut, sort en erreur).
     -Locale    locale  : Force la Locale d'affichage de l'aide (fr,en).
     -Exec              : Duplique l'instance (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 'instance' parameter, Utilisation: sqwora_RmanClone.ksh [-h] -I <instance> -IS <instance> -US <hostname> -T <Type> [+ options]

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

Begining     : 2020-11-29 20:01:07
End          : 2020-11-29 20:01:07
Duration     : 00:00:00

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:
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:
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_RmanClone.ksh:


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

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

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type>
#Genere les commandes mais ne les execute pas !

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -Exec
#Realise un clone RMAN

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -UUS 'dba_42' -Exec
#Utilisateur unix source (par defaut, meme que la cible).

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -IgnoreDiskWarning -Exec
#Ignore les warnings d'espace disque (par defaut, sort en erreur)

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -CopyOnly -Exec
#Realise juste la copie des backups et s'arrete.

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -Before $Home/scripts/XXX.ksh -Exec
#Script a executer avant clone

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -After $Home/scripts/XXX.ksh -Exec
#Script a executer apres clone

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -P <NumericValue> -Exec
#Execute le script sqwora_RmanClone.ksh avec un degre de parallelisme de '<NumericValue>'
#Utilise par defaut la variable gvsqw_NbThreadXXX dans $gvsqw_OraBin/../etc/sqwora_GlobalVar.cfg
#Vous pouvez changer le defaut sur tout l'environnement si vous settez cette variable
#dans le fichier de configuration $gvsqw_OraBin/../etc_cust/sqwora_GlobalVar.cfg

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -AddMail 'mymail1@mydomaine.com,mymail2@mydomaine.com' -Exec
#Ajoute la liste de mail a l'adresse par defaut geree par $gvsqw_GlobalMail

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -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_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -NoMail -Exec
#Desactive l'envoi de mail sur erreur a $gvsqw_GlobalMail (par defaut, seulement en cas d'erreur)

$gvsqw_OraBin/sqwora_RmanClone.ksh -I $ORACLE_SID -IS <SourceInstance> -US <SourceHost> -T <Type> -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_sqwora_RmanClone=<NumericValue>
#dans le fichier de configuration $gvsqw_OraBin/../etc_cust/sqwora_GlobalVar.cfg

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

SQWareProduction:oracle:bin:sqwora RmanClone.ksh

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