Select Page

Oracle Secure Backups to S3 on 10g

Author: Dallas Willett | | November 2, 2011

If you are trying to install the Oracle Secure Backup Cloud Module for Amazon S3 on your Oracle 10g database, one thing you’ll notice right away is that you need version 1.5 or higher of the JDK. Oracle 10g ships with java 1.4, so here is what we did to get this installed

Running the installer with JDK version 1.4

If you didn’t read the requirements from Oracle and just tried to download and run the installer, you’ll notice fairly quickly that this isn’t going to work. The actual values for the -AWSID and -AWSKEY options can be found from the Amazon S3 Security Credentials page, and you’ll want to supply your OTN/Metalink login and password.

$ORACLE_HOME/jdk/bin/java -jar /opt/oracle/admin/ows/osbws_install.jar
 -otnUser [email protected] -otnPass yourpassword
 -walletDir $ORACLE_HOME/dbs/osbws_wallet -libDir $ORACLE_HOME/lib

Exception in thread "main" java.lang.UnsupportedClassVersionError:
   oracle/osbws/install/ConfigSetup (Unsupported major.minor version 49.0)
        at java.lang.ClassLoader.defineClass0(Native Method)
        at java.lang.ClassLoader.defineClass(
        at Method)
        at java.lang.ClassLoader.loadClass(
        at sun.misc.Launcher$AppClassLoader.loadClass(
        at java.lang.ClassLoader.loadClass(
        at java.lang.ClassLoader.loadClassInternal(

A quick check and we see that the version of java that ships with Oracle 10g is insufficient.

$ORACLE_HOME/jdk/bin/java -version

java version "1.4.2_14"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_14-b05)
Java HotSpot(TM) Client VM (build 1.4.2_14-b05, mixed mode)

Downloading JDK version 1.5

You’ll want to grab a version 1.5 of java in order to install the Oracle Secure Backup Cloud Module for Amazon S3. What I did was I went to Metalink and downloaded patch 9477224, although there are probably other ways to download a stand-alone version of java 1.5. You don’t actually need to install java 1.5 into your 10g ORACLE_HOME. In fact, Oracle says in the patch notes that you should stick with the same major version of java in your 10g ORACLE_HOME (version 1.4). What I did was just unzip the patch into a temporary directory and run the self-extracting executables.


Running the installer with JDK version 1.5

Now that we have java 1.5 extracted, we can run the installer from this temporary directory. The installer will create a couple files based on the environment you’ve sources (your ORACLE_HOME and ORACLE_SID environment variables). This stand-alone version of java is not needed after the installer runs and you can blow it away if you want to.

./jdk1.5.0_30/bin/java -jar /opt/oracle/admin/ows/osbws_install.jar
 -otnUser [email protected] -otnPass yourpassword
 -walletDir $ORACLE_HOME/dbs/osbws_wallet -libDir $ORACLE_HOME/lib

Oracle Secure Backup Database Web-Service Install Tool, build 2011-02-04.0001
AWS credentials are valid.
S3 user already registered.
Registration ID: [some-registration-id]
S3 Logging Bucket: oracle-log-[your_aws_login]-1
Validating log bucket location ...
Validating license file ...
Create credential
OSB web-services wallet created in directory
OSB web-services initialization file
  /opt/oracle/product/10.2.0/db_1/dbs/osbwsorcl.ora created.
Downloading OSB Web Services Software Library from file
Downloaded 16350454 bytes in 1 seconds. Transfer rate was 16350454 bytes/second.
Download complete.
Extracted file /opt/oracle/product/10.2.0/db_1/lib/

Backing up to S3

You’ll notice it creates a directory for the wallet, an initialization file and a shared object. You’ll use the path to the initialization file it created, as well as the path to the shared object it extracted, to configure RMAN backups to S3 for this particular database. There’s no difference at this point between a 10g and 11g database in terms of configuring RMAN to backup to the cloud.

rman target /
RMAN> configure channel device type 'SBT_TAPE' 

That’s all there is to it. At this point you can run a test backup.

RMAN> backup device type sbt spfile;

Additional Configuration

If you poke around, you’ll notice the contents of the initialization file will look something like this.

$ cat /opt/oracle/product/10.2.0/db_1/dbs/osbwsorcl.ora

There are a few other parameters you can set in this initialization file, although they don’t seem to be well documented (a google search for “OSB_WS_BUCKET” at the time of writing this blog returns zero results). You can see those parameters by strings-ing the shared object. I’ve listed the non-underscore parameters here. We’ve used the OSB_WS_BUCKET parameter in particular to change the default location of where backups are sent to, but that’s a topic for another time.


This process was tested on both the Standard Edition and Enterprise Edition of Oracle 10g. Dallas Willett Datavail – Remote DBA Services

How to Solve the Oracle Error ORA-12154: TNS:could not resolve the connect identifier specified

The “ORA-12154: TNS Oracle error message is very common for database administrators. Learn how to diagnose & resolve this common issue here today.

Vijay Muthu | February 4, 2021

Data Types: The Importance of Choosing the Correct Data Type

Most DBAs have struggled with the pros and cons of choosing one data type over another. This blog post discusses different situations.

Craig Mullins | October 11, 2017

How to Recover a Table from an Oracle 12c RMAN Backup

Our database experts explain how to recover and restore a table from an Oracle 12c RMAN Backup with this step-by-step blog. Read more.

Megan Elphingstone | February 2, 2017

Subscribe to Our Blog

Never miss a post! Stay up to date with the latest database, application and analytics tips and news. Delivered in a handy bi-weekly update straight to your inbox. You can unsubscribe at any time.

Work with Us

Let’s have a conversation about what you need to succeed and how we can help get you there.


Work for Us

Where do you want to take your career? Explore exciting opportunities to join our team.