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 22-17 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.