CREATE_SBT_LIBRARY

This procedure creates metadata describing an installed media management software library. The Recovery Appliance uses the specified library to copy backups from internal storage either to tape or to other tertiary storage supported by this media manager.

Syntax

PROCEDURE create_sbt_library (
   lib_name IN VARCHAR2,
   drives IN NUMBER,
   restore_drives IN NUMBER DEFAULT 0,
   parms IN VARCHAR2 DEFAULT NULL,
   send IN VARCHAR2 DEFAULT NULL,
   guaranteed IN VARCHAR2 DEFAULT 'NO',
   immutable IN VARCHAR2 DEFAULT 'NO',
   comments IN VARCHAR2 DEFAULT NULL,
   sbt_mirror IN VARCHAR@ DEFAULT 'NO');

Parameters

Table 21-16 CREATE_SBT_LIBRARY Parameters

Parameter	Description
lib_name	The user-specified name that the Recovery Appliance uses to refer to this SBT library.
drives	The maximum number of tape drives that this SBT library can access. The Recovery Appliance never uses more than the specified number of concurrent streams when accessing this library.
restore_drives	The number of tape drives that the Recovery Appliance reserves for restore operations. If specified, then the Recovery Appliance uses a maximum of drives - restore_drives drives for backup operations, which ensures that the Recovery Appliance always has the specified number of drives available for restore operations. If not specified, then the Recovery Appliance can use all available drives for backups, which means that a restore operation might have to wait for a drive to become free.
parms	The library-specific parameter string that the Recovery Appliance uses to access this SBT library. This string has the same format as the PARMS option of the RMAN ALLOCATE CHANNEL command. The string usually contains the SBT_LIBRARY parameter.
send	The parameter string that the Recovery Appliance uses to send additional library-specific parameters to this SBT library. This string has the same format as the SEND option of the RMAN ALLOCATE CHANNEL command.
guaranteed	If YES, this library may be used as a backing store to support the GUARANTEED_COPY protection policy attribute.
immutable	If YES, this library may be used as a backing store to support the KEEP_COMPLIANCE protection policy attribute.
comments	Optional user supplied comment describing reason for executing this command.
sbt_mirror	If YES, this library will be mapped to one or more remote SBT libraries on downstream Recovery Appliance using library name and type. Query the RA_SBT_MIRROR view for a list of mirrored SBT libraries.

Note:

SBT mirroring is supported with bi-directional (or Backup Anywhere) replication mode. SBT mirroring is not supported in one-way replication mode. If the upstream Recovery Appliance has SBT mirroring and one-way replication, its backups are not accessible by the downstream Recovery Appliance.