SQWareProduction:oracle:bin:sqwora RmanClone.ksh

Presentation

Script $gvsqw_OraBin/sqwora_RmanClone.ksh :

RMAN clone

Online help

The online help is available for most scripts with the -h option.
Ex: $gvsqw_OraBin/sqwora_RmanClone.ksh -h
Content of this assistance :

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

DESCRIPTION
   sqwora_RmanClone.ksh duplicate instance by Rman

PARAMETERS
     -I  instance       : Target instance (clone).
     -IS instance       : Instance source.
     -US hostname       : Hostname of instance source.
     -T  type           : Which backup to use:
                           - LastFull => recover the last full backup
                           - LastInc  => recover the last incremental backup
                           - MaxTime  => recover the last backup
                           - <tag>    => recover this backup tag (part of file name)
OPTIONS
     -h  help           : Display the full usage.
     -P  Nb processes   : Nb max processes (by default 4).
     -UUS  username     : User unix source(by default, same of target).
     -Before  script    : Script to execute before clonning.
     -After   script    : Script to execute after clonning.
     -ADM Adresse       : Email Address to send report
     -NoMail            : Desactivate sendmail on error to dba (by default, send on error).
     -CopyOnly          : Make only the copy of backups and quit.
     -IgnoreDiskWarning : Do not care of the evaluation of disk space (by default, exit on error).
     -Exec              : Duplicate (default, display generated commands).

Error management

Errors passing arguments

This type of message is generated:

Lack 'instance' parameter, Usage: sqwora_RmanClone.ksh [-h] -I <instance> -IS <instance> -US <hostname> -T <Type> [+ options]
For full help : sqwora_RmanClone.ksh -h

If you are connecting through a terminal, no mail will be sent and you will have more this kind of message:

No send mail because you are in connected mode !!!
Lack 'instance' parameter

If you are not connected to a terminal, the error message appears and is sent by mail to the address contained in the variable $gvsqw_GlobalMail (See help customize this variable). The subject line will always start by "$gvsqw_MailMsg_oracle : " (See help customize this variable).

Execution errors

Whether you are or not connected to a terminal, the error message appears and an email containing a summary of treatment errors is sent to the address contained in the variable $gvsqw_Mail_oracle (See help customize this variable). The subject line will always start by "$gvsqw_MailMsg_oracle : " (See help customize this variable).

Usage examples

Voici quelques exemples d'utilisations:

$gvsqw_OraBin/sqwora_RmanClone.ksh -h

Sort l'aide en ligne.

$gvsqw_OraBin/sqwora_RmanClone.ksh -I <InstanceName> -NoMail

N'envoi pas de mail sur erreur.

$gvsqw_OraBin/sqwora_RmanClone.ksh -I <InstanceName> -Exec

Execute les commandes générées.

$gvsqw_OraBin/sqwora_RmanClone.ksh -I <InstanceName>

Génère les commandes mais ne les exécute pas.