Installing and Configuring Oracle Secure Backup 10.2

Purpose

This tutorial shows you how to install and configure Oracle Secure Backup (OSB) 10.2 for test and training purposes (not for production use). Completing this tutorial is a prerequisite for all other Oracle Secure backup 10.2 tutorials.

Time to Complete

Approximately 1 hour

Topics

This tutorial covers the following topics:

 Overview
 Prerequisites
 Installing the Oracle Secure Backup Software

Configuring Oracle Secure Backup

 Registering your Administrative Server with Enterprise Manager
 Testing Connectivity in Enterprise Manager
 Defining and Preauthorizing a new OSB User
 Preparing the Database for Backups
 Creating a new Media Family
 Creating a Database Storage Selector
 Summary
 Related information

Viewing Screenshots

 Place the cursor over this icon to load and view all the screenshots for this tutorial. (Caution: This action loads all screenshots simultaneously, so response time may be slow depending on your Internet connection.)

Note: Alternatively, you can place the cursor over each individual icon in the following steps to load and view only the screenshot associated with that step.

Overview

This tutorial covers how to install Oracle Secure Backup and how to configure it for seamless integration with RMAN. You will use different interfaces to familiarize yourself with all of them.

Completing this tutorial is a prerequisite for all other Oracle Secure Backup 10.2 tutorials.

Back to Topic List

 

Prerequisites

Before starting this tutorial, you should:

1.

Have access to or have installed Oracle Database 11g on Linux 32 with Oracle Enterprise Manager Database Console. - From the database installation, you need to know the passwords of the SYS Oracle user (referred to as SYS_password) and the oracle OS user account (referred to as host_password).

 

2. Ensure that the database has a static entry in the listener.ora file. (You can use the netmgr utlitiy for this.)
3.

Have access to or have installed the sample schema.

4.

Have access to the Oracle Secure Backup 10.2 software. You can download the software following the links from http://www.oracle.com/technology/products/secure-backup/index.html .

This tutorial assumes that the downloaded software is accesible in the /stage directory and unzipped in this directory. It also assumes that the root user owns the /u01 directory with sufficient space to contain all backups that you create during these tutorials.

To install the software, you need to know the password of the root user.

This tutorial is tested with Oracle Secure Backup v10.2.0.2 Linux x86 (the 32-bit version).

 

5. Download the osb10_2install.zip file into your working directory ( \home\oracle) and unzip the file.

Back to Topic List

Installing the Oracle Secure Backup Software

In this topic you install the unzipped, staged Oracle Secure Backup software.

To install the Oracle Secure Backup software, perform the following steps:

1.

As the root user, create the OSB home directory by executing the following command:

# mkdir -p /usr/local/oracle/backup

 

2.

Navigate into your OSB home directory:

# cd /usr/local/oracle/backup

Note: It is important for a correct setup that you remain in this directory for the following steps.

 

3.

Ensure that the uncompress utility is available:

# ln -s /bin/gunzip /bin/uncompress

 

4.

In your OSB home directory start the Oracle Secure Backup installation as the root user.

# /stage/setup

Welcome to Oracle's setup program for Oracle Secure Backup. This
         program loads Oracle Secure Backup software from the CD-ROM to a
       filesystem directory of your choosing.
This CD-ROM contains Oracle Secure Backup version 10.2.0.2.0_linux32.
Please wait a moment while I learn about this host... done.
- - - - - - - - - - - - - - - - - - - - - - - - - - -
   1. linux32
   administrative server, media server, client
- - - - - - - - - - - - - - - - - - - - - - - - - - -
         Loading Oracle Secure Backup installation tools... done.
         Using your previous obparameters file. The new file shipped with this
   distribution of Oracle Secure Backup is called install/obparameters.new.
   Loading linux32 administrative server, media server, client... done.
- - - - - - - - - - - - - - - - - - - - - - - - - - -
         Loading of Oracle Secure Backup software from CD-ROM is complete.
         You may unmount and remove the CD-ROM.
Would you like to continue Oracle Secure Backup installation with
         'installob' now? (The Oracle Secure Backup Installation Guide
         contains complete information about installob.)
       Please answer 'yes' or 'no' [yes]: 

5.

Enter yes to continue with your installation:

Please answer 'yes' or 'no' [yes]:  
                              
yes
                            
- - - - - - - - - - - - - - - - - - - - - - - - - - -
Welcome to installob, Oracle Secure Backup's UNIX installation program.
It installs Oracle Secure Backup onto one or more UNIX or Linux systems
         on your network. (Install Oracle Secure Backup for Windows using the
         CD-ROM from which you loaded this software.)
For most questions, a default answer appears enclosed in square brackets.
         Press Enter to select this answer.
Please wait a few seconds while I learn about this machine... done.
Have you already reviewed and customized install/obparameters for your
       Oracle Secure Backup installation [yes]?

6.

Enter no, because you have not customized any parameters:

Have you already reviewed and customized install/obparameters for your
         Oracle Secure Backup installation [yes]?  
                              
no
Would you like to do this now [yes]?      
                            
7.

Enter no again, because you are performing a default installation.

Would you like to do this now [yes]?  
                              
no
                            
                               
-  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -
                            
Oracle Secure Backup is not yet installed on this machine.
Oracle Secure Backup's Web server has been loaded, but is not yet configured.
You can install this host one of three ways:
   (a) administrative server
   (the host will also be able to act as a media server or client)
   (b) media server
   (the host will also be able to act as a client)
   (c) client
If you are not sure which way to install, please refer to the Oracle
       Secure Backup Installation Guide. (a,b or c) [a]?

8.

First you install the administrative server. Enter a to do so:

If you are not sure which way to install, please refer to the Oracle
       Secure Backup Installation Guide. (a,b or c) [a]?  
                              
a
                            
Beginning the installation. This will take just a minute and will produce
         several lines of informational output.
Installing Oracle Secure Backup on edrsr4p1 (Linux version 2.6.9-55.0.0.0.2.ELsmp)
You must now enter a password for the Oracle Secure Backup encryption
         key store. Oracle suggests you choose a password of at least 8
         characters in length, containing a mixture of alphabetic and numeric
         characters.
Please enter the key store password:

9.

Choose passwords appropriate for your environment and ensure that you remember them. Enter your chosen password twice as the key store password and for verification:

Please enter the key store password:  
                              
                                 
keystore_password
                              
                            
Re-type password for verification:  
                              
                                 
                                   
keystore_password
                                
                              

You must now enter a password for the Oracle Secure Backup 'admin' user.
                              
Oracle suggests you choose a password of at least 8 characters in length,
containing a mixture of alphabetic and numeric characters.
Please enter the admin password:

10.

Enter your chosen password twice as the admin password and for verification:

Please enter the admin password:  
                              
                                 
admin_password
                              
Re-type password for verification:  
                              
                                 
admin_
                              
                              
                                 
password
                               

You should now enter an email address for the Oracle Secure Backup 'admin'
                              
user. Oracle Secure Backup uses this email address to send job summary
reports and to notify the user when a job requires input. If you leave this
blank, you can set it later using the obtool's 'chuser' command.
Please enter the admin email address:
11.

Press the Enter key without any entry, because this tutorial does not use email notification. The installation continues:

 generating links for admin installation with Web server
 updating /etc/ld.so.conf
 checking Oracle Secure Backup's configuration file (/etc/obconfig)
 setting Oracle Secure Backup directory to /usr/local/oracle/backup in /etc/obconfig
 setting local database directory to /usr/etc/ob in /etc/obconfig
 setting temp directory to /usr/tmp in /etc/obconfig
 setting administrative directory to /usr/local/oracle/backup/admin in /etc/obconfig
 protecting the Oracle Secure Backup directory
 creating /etc/rc.d/init.d/observiced
 activating observiced via chkconfig
 initializing the administrative domain
****************************** N O T E ******************************
         On Linux systems Oracle recommends that you answer no to the next two
         questions. The preferred mode of operation on Linux systems is to use
         the /dev/sg devices for attach points as described in the 'ReadMe'
         and in the 'Installation and Configuration Guide'.
      
Is host01 connected to any tape libraries that you'd like to use with
       Oracle Secure Backup [no]?

12.

You will connect tape libraries and tape drives in one of the following steps, so enter no twice:

Is host01 connected to any tape libraries that you'd like to use with
       Oracle Secure Backup [no]?  
                              
no
                            
Is host01 connected to any tape drives that you'd like to use with
       Oracle Secure Backup [no]?  
                              
no
                            
Installation summary:
 Installation Host     OS        Driver      OS Move     Reboot
   Mode       Name     Name    Installed?   Required?  Required?
   admin      host01   Linux   no           no         no
Oracle Secure Backup is now ready for your use.
#
13.

Log off as the root user:

# exit
$

Back to Topic List

Configuring Oracle Secure Backup

This topic guides you through performing one-time configuration tasks and confirming that basic elements, such as tape libraries and tape drives are in service.

To configure Oracle Secure Backup and to confirm your configuration, perform the following steps:

1.

As oracle OS user, navigate to your working directory ( /home/oracle) by executing the following command:

$ cd /home/oracle

2.

To confirm that you have the necessary OBE configuration files, enter:

$ ls c*

config1_in.sh config1_out.sh config1.sh config2.txt
3.

To substitute the host name in the config1_out.sh file, enter:

$ ./config1.sh

Your hostname is displayed. This example uses "host01.example.com".

host01.example.com

4.

To assign the mediaserver role to your host and to configure devices for the OBE training environment, execute the config1_out.sh file and provide the password for each of the devices:

$ ./config1_out.sh

                               
                                 
Password:
                                
                              
                                 
admin_password 
Password:  
                                  
                                     
admin_password
                                  
Password:  
                                  
                                     
admin_password
                                   
Password:  
                                  
                                     
admin_password
                                   
Password:  
                                  
                                     
admin_password
                                   
Password:  
                                  
                                     
admin_password
                                   
Password:  
                                  
                                     
admin_password
                                   
Password:  
                                  
                                     
admin_password
                                   
Password:  
                                  
                                     
admin_password
                                   
                                                              
                            

Note: This tutorial generates virtual test devices which use disk space (under the u01 directory), but emulate tape devices. These OSB test devices are not supported in production, although Oracle Secure Backup supports many non-Oracle virtual tape devices.

Note 2: Should you have any errors during the execution of this file or mistype a password, then it is recommended to log in as the root user, first remove disk directories by entering:

$  
                                
su - root
Password:  
                                
                                   
root_password
                                
#  
                                
cd /u01
#  
                                
rm -rf vli*
# rm -rf vd*
#
                              

Note 2, continued: Follow the steps in the "Uninstalling Oracle Secure Backup on Linux or UNIX" section of the Installing Oracle Secure Backup on Linux or UNIX guide to uninstall Oracle Secure Backup before beginning with this tutorial again.

 

5.

To log into the obtool, enter:

$  
                              
obtool
                            
Oracle Secure Backup 10.2.0.2.0
login:  
                              
admin
Password:  
                              
                                 
admin_
                                
password
                              
ob>
                            

Note: If you are not receiving the login and Password prompts, then your credentials are still active. Read the note at the end of this task for more details.

 

6.

To view all roles of your host, enter:

ob>  
                              
lshost
host01.example.com admin,mediaserver,client (via OB) in service
ob>
      
                            
7.

To view the just created devices, enter:

ob>  
                              
ls
                              
                                 
dev
                              
                            
library            vlib             in service
  drive 1          vdte1            in service
  drive 2          vdte2            in service
  drive 3          vdte3            in service
  drive 4          vdte4            in service
 library           vlib2            in service
  drive 1          vdrive1          in service
  drive 2          vdrive2          in service
 ob>
  
      
8.

To insert volumes into the tape libraries, either execute the following commands (or execute < / <your working directory>/config2.txt script, if you wish to avoid typing).

ob> insertvol -L vlib -c 250 unlabeled 1-32

ob> insertvol -L vlib2 -c 250 unlabeled 1-14

or:

             ob>  
                              
< /home/oracle/config2.txt
             ob> # Only for test and training, not for production
             ob> # OSB script, run as admin user
             ob>
             ob> insertvol -L vlib -c 250 unlabeled 1-32
             ob> insertvol -L vlib2 -c 250 unlabeled 1-14ob>
             ob>
          
                            
9.

To list the default media families, enter:

ob> lsmf --long

OSB-CATALOG-MF:
    Write window:       7 days
    Keep volume set:    14 days
    Appendable:         yes
    Volume ID used:     unique to this media family
    Comment:            OSB catalog backup media family
 RMAN-DEFAULT:
    Keep volume set:    content manages reuse
    Appendable:         yes
    Volume ID used:     unique to this media family
    Comment:            Default RMAN backup media family
ob> 


Note: You will create additional media families in a later task in this OBE.

 

10.

To rename the host and to add a new IP address, enter:

renhost --nq host01.example.com host01
chhost --addip host01.example.com host01


11.

To end your obtool session, enter:

logout

Note: The logout command ends the obtool session and destroys the login token, so that you are prompted for credentials at the start of your next obtool session, which may include the following message " Warning: auto-login failed - login token has expired"

If you end an obtool session with the exit or quit commands, the login token is preserved according to Webtool > Configure > Defaults and Policies > Security> Login token duration: 15 minutes (default).

Back to Topic List

 

Registering your Administrative Server with Enterprise Manager

In this topic you register your Oracle Secure Backup administrative server with Enterprise Manager (EM), which is required for a seamless operation between these two tools.

To register your administrative server, perform the following steps:

1.

To access Enterprise Manager Database Console, you need to know the appropriate URL and that the tool is running. To verify this as oracle OS user, enter in a terminal window:

$ emctl status dbconsole

           Oracle Enterprise Manager 11g Database Control Release 11.1.0.6.0
           Copyright (c) 1996, 2007 Oracle Corporation. All rights reserved.
            
                              
https://host01.example.com:1158/em/console/aboutApplication
            
                              
Oracle Enterprise Manager 11g is running.
           ------------------------------------------------------------------
           Logs are generated in directory /u01/app/oracle/product/11.1.0/db_1/host01.example.com_orcl/sysman/log
                            


Note: The text is in bold and colored for ease of recognition.

 

2.

Open your web browser and enter your URL in the following format:

https://<host machine>:<port>/em


3.

On the Enterprise Manager Login page, enter SYS as User Name, your SYS_password and select Connect As SYSDBA. Then click Login.

 

4.

On the Oracle Database home page, click the Availability tab.

 

5.

On the Availability page, click Oracle Secure Backup Device and Media.

 

6.

The first time you perform this task, the Adiministrative Server "Add Administrative Server" page opens. Enter the following values, then click OK:

Oracle Secure Backup Home: /usr/local/oracle/backup
Username: admin
Password: admin_password

 

7.

Enter oracle as Username, your host_password , select "Save as Preferred Credential" and click the OK button.

 

8.

The Oracle Secure Backup Device and Media: Administrative Server page is displayed with the administrative server that you have just registered.

 

Back to Topic List

Testing Connectivity in Enterprise Manager

In this topic you first view the previously created virtual devices in Enterprise Manger, then you test their connectivity to confirm that they are available and ready to be used.

To view your devices and to test the connectivity of your devices, perform the following steps:

1.

On the Oracle Secure Backup Device and Media: Administrative Server page, select All Devices from the View drop-down list in the Devices section.

 

2.

Your library devices are displayed in the Devices section.


3.

Click each of the plus icons in the Name column to expand the libraries.

All your devices are displayed.

 

4.

To test your devices, click the Manage link for Devices in the Resources section of the Oracle Secure Backup Device and Media: Administrative Server page.

 

5.

On the Devices page, select Verify Connectivity from the Actions drop-down list.

 

6.

On the Devices page, select the vlib library and click the Go button behind the Actions drop-down list.

 

7.

You should receive a success message like the following one.

 

8.

To confirm connectivity for the vlib2 library, select it and click the Go button behind the Verify Connectivity Actions.

 

9.

You should receive a success message like the following one.

 

10.

Click the Database tab in preparation for the next task.

 

Back to Topic List

Defining and Preauthorizing a new OSB User

In this topic you define the oracle OS user as a new Oracle Secure Backup administrator and you preauthorize this user to execute RMAN backup and recovery jobs. "Preauthorization" means that this user does not have to provide OSB credentials, after they logged into Enterprise Manger and started, for example, a backup job to tape.

To define and preauthorize a new OSB user, perform the following steps:

1.

In Enterprise Manager on the Availability page, right-click File System Backup and Restore in the Oracle Secure Backup section and select (if available in your browser) Open Link in a New Tab.

 

2.

On the Oracle Secure Backup Login page, enter admin as User Name and your admin_password , then click Login.


3.

On the OSB Home page, click the Configure tab.

 

4.

On the Configure page, click Users in the Basic section.

 

5.

In the Configure: Users page, click the Add button.

 

6.

On the Configure: Users > New Users page, enter or select the following values, then click Apply:

User: oracle
Password: host_password
User class: oracle
UNIX name: oracle
UNIX group: dba
NDMP server user: no

You should receive a success message.

 

7.

On the Configure: Users > oracle page, click Preauthorized Access.

 

8.

On the Configure: Users > oracle > Preauthorized Access page, enter or select the follwoing values, then click Add:

Hosts: all hosts
OS username: *
Windows domain name: *
Attributes: rman

 

9.

You should receive a success message with a display like the following one:

 

10.

Click Logout.

 

Back to Topic List

Preparing the Database for Backups

The next two topics are closely related. Both are required as part of database preparation. This OBE demonstrates the tasks in the Enterprise Manager interface; (you could also choose another interface, like SQL*Plus).

 Enabling ARCHIVELOG mode for Database Backups
 Restarting the Database

Back to Topic List

To enable ARCHIVELOG mode in Enterprise Manager, perform the following steps:

1.

In your web browser, on the Enterprise Manager Login page, enter SYS as User Name, your SYS_password and select Connect As SYSDBA. Then click Login. (For detailed instructions, review steps 1, 2 and 3 under Registering your Administrative Server with Enterprise Manager.

 

2.

On the EM home page, click the Availability tab.


3.

On the Availability page, click Recovery Settings in the Backup/Recovery section.

 

4.

On the Recovery Settings page, select ARCHIVELOG Mode in the Media Recovery section, then click Apply.

 

5.

On the Confirmation page, click Yes to restart the database.

 

Back to Topic

 

To restart the database in Enterprise Manager, perform the following steps:

1.

On the Restart Database: Specify Host and Target Database Credentials page, enter and confirm the following values, then click OK:

For Host Credentials
Username: oracle
Password: host_password

For Database Credentials:
Username: sys
Password: sys_password
Connect As: SYSDBA
Selected: Save as Preferred Credential

 

2.

On the Restart Database: Confirmation page, click Yes.

 

3.

You might receive the error below, if you refresh or requery, while agents are being disconnected. This error resolves itself automatically. Click OK.

In time, the Restart Database: Activity Information page is displayed.

Click Refresh until the EM Home page is displayed.

Note: If the Enterprise Manager Login page appears, enter SYS as User Name, your SYS_password and select Connect As SYSDBA. Then click Login.

 

4.

Confirm that the database is up and running.

 

Back to Topic

Back to Topic List

Creating a new Media Family

In this topic you view the default media families and create new ones with the OSB Web Tool.

To view and create media families, perform the following steps:

1.

To start the OSB Web Tool directly (not from EM), open your web browser and enter your URL in the following format:

https://<host machine>/index.php

The Oracle Secure Backup Web Interface displays the Oracle Secure Backup Login page and changes the URL as follows:

 

2.

On the Oracle Secure Backup Login page, enter admin as User Name and your admin_password , then click Login.


3.

On the OSB Home page, click Preferences in the top-right corner.

 

4.

Select the On Setting for Extended command output, then click Apply.

The page does not change, when you click Apply. You can see the result of this change in step 7, following.

 

5.

To view and edit existing media families, as well as creating new ones, click the Configure tab.

 

6.

Click Media Families.

 

7.

On the Configure: Media Families page, first review the existing default media families, then click the Add button to create a new one.

 

8.

On the Configure: Media Families > New Media Families page, enter and confirm the following values, then click Apply:

Media Family: OFFSITE_7Y
Volume ID used: Unique to this media family
Volume expiration: Time Managed
Keep volume set: 7 years
Appendable: yes
Comment : Store for 7 years offsite - for compliance with XYZ law.

You should receive a success message.

 

9.

Scroll to the bottom of the Configure: Media Families > OFFSITE_7Y page an review the Extended Command Output.

Then click the OK button.

 

10.

The Configure: Media Families page is displayed with your newly created OFFSITE_7Y media family.

 

11.

On the Configure: Media Families page, click the Add button to create an additional media family.

 

12.

On the Configure: Media Families > New Media Families page, enter and confirm the following values, then click Apply:

Media Family: offsite_test
Volume ID used: Unique to this media family
Volume expiration: Time Managed
Keep volume set: 10 minutes
Appendable: yes
Comment : Edit test values later.

 

13.

You should receive a success message. Click OK.

 

14.

On the Configure: Media Families page, review all available media families, the default ones and your newly created ones.

 

Back to Topic List

 

Creating a Database Storage Selector

As a final configuration task, you test the tape backup and create a database storage selector in Enterprise Manager.

To create a storage selector and test the tape backup, perform the following steps:

1.

In your web browser, on the Enterprise Manager Login page, enter SYS as User Name, your SYS_password and select Connect As SYSDBA. Then click Login. (For detailed instructions, review steps 1, 2 and 3 under Registering your Administrative Server with Enterprise Manager.

 

2.

In Enterprise Manger, navigate to Availabity > Backup Settings (in the Backup/Recovery Setup section).


3.

To provide and save tape settings, enter the following values, then click OK:

Tape Drives: 1
Username: oracle
Password: host_password
Save as Preferred Credential ( selected)

 

4.

To create a database storage selector, reenter the Backup Settings page and click Configure in the Oracle Secure Backup section on the Backup Settings Device page.

 

5.

On the Administrative Server Loginpage, enter or confirm the following values, then click OK:

Administrative Server: Your_host
Username: oracle
Password: host_password
Save as Preferred Credential ( selected)

 

6.

On the Backup Storage Selectors page, click Add.

 

7.

On the Add Backup Storage Selector page, select the following values, then click OK:

Database Backup Types: Archive Logs, Auto Backup, Full and Incremental
Media Family: RMAN-DEFAULT

 

8.

You should receive a success message on the Backup Storage Selectors page. Click Return.

 

9.

On the Backup Settings Device page, enter or confirm the following values, then click Test Tape Backup:

Tape Drives: 1
Tape Backup Type: Backup Set
Username: oracle
Password: host_password

The Processing: Test Tape Backup page may appear for a while, depending on your system resources.

 

10.

On the Backup Settings Device page, view the success message, then click Logout.

 

Back to Topic List

Summary

In this lesson, you learned how to:

 Install the Oracle Secure Backup Software
 Configure Oracle Secure Backup
 Register your Administrative Server with Enterprise Manager
 Test Connectivity in Enterprise Manager
 Define and Preauthorize a new OSB User
 Prepare the Database for Backups
 Create a new Media Family
 Create a Database Storage Selector

Back to Topic List

Related Information

To learn more about Oracle Secure Backup you can refer to:

 Oracle Secure Backup 10.2 on the Oracle Technology Network (OTN) web site
 Additional OBEs on the OTN web site
 Demonstration material ( viewlets )

Back to Topic List

 Place the cursor over this icon to hide all screenshots.

 

 

 

Left Curve
Popular Downloads
Right Curve
Untitled Document