PowerProtect Data Manager - Oracle RMAN Agent: sbtinit2: Mandatory parameter RMAN_AGENT_HOME is not set

Summary: Oracle RMAN Initial installation issue, so unable to run the backup script

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

The following RMAN script was used to register DD with Oracle RMAN Agent version 19.5: 
RMAN> run {
allocate channel t1 type 'SBT_TAPE' parms 'BLKSIZE=1048576,
SBT_LIBRARY=/u/app/oracle/product/rmagent/lib/libddobk.so,
ENV=(STORAGE_UNIT=<storage_unit_on_dd>,
BACKUP_HOST=<DD_hostname>,
ORACLE_HOME=/u/app/oracle/product/12.2.0.1)';
2> 3> send 'set username <DDBoost_username> password <DDBoost_password> servername <DD_Server> storageunit <Name_of_storageunit_on_DD_Server>';
4> release channel t1;
5> }

The following error was received: 
RMAN-00571: ===========================================================
RMAN-00569: =============== ERROR MESSAGE STACK FOLLOWS ===============
RMAN-00571: ===========================================================
RMAN-03009: failure of allocate command on t1 channel at 06/09/2021 20:27:44
ORA-19554: error allocating device, device type: SBT_TAPE, device name:
ORA-27023: skgfqsbi: media manager protocol error
ORA-19511: non RMAN, but media manager or vendor specific failure, error text:
   sbtinit2: Mandatory parameter RMAN_AGENT_HOME is not set.
ORA-0
 
RMAN> exit
 





Cause

  • ORACLE_HOME directory is used for Oracle RMAN agent installed with version pre-4.0
  • An Environment Value which is RMAN_AGENT_HOME was in correct which specifies the installation directory for the Oracle RMAN agent 4.0 or later


Resolution

  • Don't use environment Value ORACLE_HOME if you are using Oracle RMAN Agent above 4.0
  • Set RMAN_AGENT_HOME correctly which specifies the installation directory for the Oracle RMAN agent 4.0 or later
Since RMAN_AGENT_HOME is Boost implementation of RMAN MM API and dynamically linked library – libddobk.so. which is inside RMAN_AGENT_HOME and then it will invoke the Lockbox <RMAN Agent installation path> /config – lockbox files created here.
So if we didn't set this Environment variable, it will not access Lockbox ,libraries and configuration files. so, will not allow backup to run
 
  • To verify the value of an environment variable, run the echo command.
        For example: 
# echo $RMAN_AGENT_HOME
/u/app/oracle/product/rmagent
  • Insert RMAN_AGENT_HOME correctly in the RMAN script as in the below backup script
RMAN> RUN {
ALLOCATE CHANNEL CH1 TYPE 'SBT_TAPE' TRACE 5 PARMS
2> 3> 'BLKSIZE=1048576,
SBT_LIBRARY=/u/app/oracle/product/rmagent/lib/libddobk.so,
4> 5> ENV=(STORAGE_UNIT=<storage_unit_on_dd>,
6> BACKUP_HOST=<DD_hostname>,
7> RMAN_AGENT_HOME=/u/app/oracle/product/rmagent)';
backup format 'cntrl_%d-id-%I-%u' current controlfile;
8> 9> RELEASE CHANNEL CH1;
10> }
Article Properties
Article Number: 000188730
Article Type: Solution
Last Modified: 01 Dec 2021
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.