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:
-
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 isStorage
(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.