Problems with Installing the Backup Module

The following solutions apply if you run into issues when you install the Oracle Database Cloud Backup Module.

For general information about installation, see Installing the Oracle Database Cloud Backup Module for OCI or Installing the Oracle Database Cloud Backup Module for OCI Classic.

Note:

In addition to what’s listed in this section, also check the following:
  • Java version: JDK 1.7 or later is required

  • Identity domain name or service name: Make sure they're spelled correctly

  • Backup module: Make sure you’ve downloaded the latest backup module from Oracle Technology Network (OTN)

  • Proxy or firewall issues: Make sure your proxy is set up correctly, and you can reach general URLs from your system

I get a Request to set the lifecycle policy failed error

Specific error:

Exception in thread "main" java.lang.RuntimeException: 
SetBucketLCP: 400 Bad Request. at oracle.backup.opc.install.BmcConfig.SetBucketLCP(BmcConfig.java:851) 
  at oracle.backup.opc.install.BmcConfig.setBucket(BmcConfig.java:620) 
  at oracle.backup.opc.install.BmcConfig.doBmcConfig(BmcConfig.java:236) 
  at oracle.backup.opc.install.BmcConfig.main(BmcConfig.java:219)
Failed: 1 ()

SetbucketLCP is setting the lifecycle policy on the bucket, which means enableArchive was set to True. But the Object Storage service in the region was not granted the permission to manage objects, and hence the request to set the lifecycle policy failed.

Authorize the Object Storage service to move backups to Archive Storage. See Service Permissions in the Required IAM Policies section of the Oracle Cloud Infrastructure documentation.

I get an HTTP response code error when I run the installer for Oracle Cloud Infrastructure Classic

Specific error:

Server returned HTTP response code: 504 for URL:
https://identityDomain.storage.oraclecloud.com/v1/storage-identityDomain/?format=xml

Use the -host parameter when you run the installer, instead of the -serviceName and -identityDomain parameters. For example:

-host https://abc.storage.oraclecloud.com/v1/hr-abc

Exclude /?format=xml at the end of the URL. For information about these parameters, see Parameters Used to Run the Oracle Database Cloud Backup Module for OCI Classic Installer.

I get a ConfigFile was not specified error when I run the installer

Specific error:

ConfigFile was not specified, and a default location could not be
determined because ORACLE_HOME and ORACLE_SID are not both set.

Set ORACLE_HOME and ORACLE_SID and rerun the installer.

I get a Specified directory does not exist error when I run the installer

Specific error:

Specified directory /home/oracle/OPC/lib does not exist.

The directory specified for the -libDir parameter does not exist. Create the directory and rerun the installer.

I get a java.io.IOException or java.io.FileNotFound error when I run the installer

For example:

java.io.IOException: Server returned HTTP response code: 401 for
the URL URL-name

The installer can't connect to Oracle Cloud with the information you provided. Try the following:

  • Make sure the user name, password, service name, and identity domain used to run the installer are correct. With Oracle Cloud Infrastructure, make sure that the user OCID, tenancy OCID, fingerprint, and keys are correct.

    Enclose the user name and password in single quotes, for example 'myAccount@myCompany.com' and 'opc_pswd'. On Windows systems, use double quotes if the user name or password contains special characters.

    Fix any errors and rerun the installer. If the information you provided is correct, contact Oracle Support to verify your account information.

    Note:

    If you have a pre-paid metered subscription for Oracle Cloud Infrastructure Classic, the default service name is Storage (case sensitive). This is the name you'll use for the -serviceName parameter when you install the backup module.
  • Check connectivity and see if you can reach the cloud storage endpoint URL from your database server. For example:

    $ ping storage.us2.oraclecloud.com
    PING storage.us2.oraclecloud.com (160.34.0.51): 56 data bytes
    64 bytes from 160.34.0.51: icmp_seq=0 ttl=239 time=63.738 ms
    64 bytes from 160.34.0.51: icmp_seq=1 ttl=239 time=67.288 ms

I get a Could not authenticate or 403 Forbidden error when I run the installer for Oracle Cloud Infrastructure Classic

This could be because you need to select a data center. See How to Begin with Oracle Database Backup Cloud Service Subscriptions.

The replication policy must be set before you run the backup module installer. Otherwise you'll get errors such as Could not authenticate to Oracle Database Cloud Backup Module or 403 Forbidden. Set the replication policy and wait at least 10 minutes for synchronization to complete before you retry the installation.

I get a Failed to load Media Management Library error

If you’re on a Windows system and keep getting System or Media Management Loading errors, your Windows environment could be missing C libraries needed by the RMAN backup module. Download the Redistributable Package for Visual Studio 2013 from https://www.microsoft.com/en-us/download/details.aspx?id=40784. Choose the 64-bit version and run the downloaded EXE file. This should resolve the problem.

If the problem persists, run the following operating system command (all platforms):

sbttest -f foo.txt -libname full-path-to-libopc|oraopc-library

The output shows why the module is not being loaded.

I’m using a Solaris 64-bit operating system and keep getting ORA-27211 - Failed to load Media Management Library

Installation is most likely failing because the libc.so.1 file does not exist in your environment. Confirm this by running the following operating system command:

sbttool -f foo.txt -libname full-path-to-libopc.so

To resolve the issue, set the operating system variable LD_LIBRARY_PATH_64 to the 64-bit library path that has the libc.so.1 file. If that doesn't resolve the issue and you're using an Oracle Solaris release earlier than Solaris 10 Update 10 (s10u10), upgrade your system to at least s10u10.

I get an Exception in thread error when I run the installer

Specific error:

Exception in thread "main" java.io.FileNotFoundException:
orclhome/dbs/opcdb1210.ora (No such file or directory)

The installer can't create the configuration file under the ORACLE_HOME/dbs directory. Make sure the directory is accessible. Also make sure the path for ORACLE_HOME is set correctly.

I get a PKIX path building failed: unable to find valid certification path to requested target error when I run the installer

Your database server's Java keystore does not have the SSL certificate of Oracle Cloud. You can work around this problem by using the -no-check-certificate option from the command line.

The wallet directory can't be created by the installer

Make sure the path you specified is correct, and the user account (oracle, for instance) has read/write/execute (rwx) access to that path. Alternatively, create a wallet directory and use that as the location for the –walletDir parameter.

I have a pre-paid metered subscription and don’t know what service name to use to install the Oracle Database Cloud Backup Module for OCI Classic

If you have a pre-paid metered subscription, the service name is Storage (case sensitive). This is the name you'll use for the -serviceName parameter when you install the backup module.