Oracle Secure Backup (OSB) configuration

Oracle

Audience
Public
Technology Integrations
Oracle
Source Type
Documentation

Create OSB wallet directory


[oracle@sn1-r720-e03-03 dbs]$ cd /u01/app/oracle/product/19.0.0/dbhome_1/dbs
[oracle@sn1-r720-e03-03 dbs]$ mkdir osbws_wallet

Download OSB jar file

Download osbws_installer.zip

Download Oracle Secure Backup Cloud Module for Amazon S3 from this link.

Unzip osbws_installer.zip. It will create a jar file osbws_install.jar and a readme file.

Create a file osbws_install.sh with the following contents. Replace AWSID and AWSKey with the Access Key ID and Secret Access Key values saved earlier.


#!/bin/bash 

export AWSID=<AWS ID> 
export AWSKey=<AWS Secret Key> 

java -jar osbws_install.jar -AWSID ${AWSID} -AWSKey ${AWSKey} -walletDir ${ORACLE_HOME}/dbs/osbws_wallet -libDir $ORACLE_HOME/lib \
     -awsEndpoint 10.21.236.80 -location on-prem -no-import-certificate -debug

Here is how the output of the script looks like.


[oracle@sn1-r720-e03-03 ~]$ sh osbws_install.sh 
Oracle Secure Backup Web Service Install Tool, build 12.2.0.1.0DBBKPCSBP_2018-06-12
Debug: os.name        = Linux
Debug: os.arch        = amd64
Debug: os.version     = 4.1.12-124.36.1.el7uek.x86_64
Debug: file.separator = /
Debug: Platform = PLATFORM_LINUX64
Debug: Verifying AWS account using endpoint 10.21.236.80
Debug: Canoical Request:
GET
/

host:10.21.236.80
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20210921T040405Z

host;x-amz-content-sha256;x-amz-date
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Debug: String to sign:
AWS4-HMAC-SHA256
20210921T040405Z
20210921/ora-backup/s3/aws4_request
ea26e43bb5b314413f88d697cd29180b8e72a3bed61989edb027dbeec546096c
Debug: AWS Success, owner=DefaultDisplayName, id=DefaultID
AWS credentials are valid.
Oracle Secure Backup Web Service wallet created in directory /u01/app/oracle/product/19.0.0/dbhome_1/dbs/osbws_wallet.
Oracle Secure Backup Web Service initialization file /u01/app/oracle/product/19.0.0/dbhome_1/dbs/osbwsoraprd12.ora created.
Downloading Oracle Secure Backup Web Service Software Library from file osbws_linux64.zip.
Debug: Temp zip file = /tmp/osbws_linux645454337241817877817.zip
Debug: Downloaded 27721116 bytes in 6 seconds.
Debug: Transfer rate was 4620186 bytes/second.
Download complete.
Debug: Delete RC = true

A file osbws<ORACLE_SID>.ora will get created in $ORACLE_HOME/dbs. Make sure it has the following contents.


OSB_WS_HOST=http://10.21.236.80
OSB_WS_BUCKET=oracle-bucket
OSB_WS_LOCATION=on-prem
OSB_WS_VIRTUAL_HOST=FALSE
OSB_WS_WALLET='location=file:/u01/app/oracle/product/19.0.0/dbhome_1/dbs/osbws_wallet CREDENTIAL_ALIAS=defaultd_aws'

OSB_WS_LOCATION should be set to the keyword on-prem.

OSB_WS_HOST should be set to the S3 Data VIP, not the management address.

With this the configuration is complete and is ready for RMAN execution.