Skip Headers

Oracle® Secure Backup Migration Guide Release 10.2 Part Number E05409-01 |
Home | Book List | Contents | Index | Contact Us

Previous | Next
| View PDF

# 1 Migrating from Reliaty Backup to Oracle Secure Backup

This chapter explains how to migrate from Reliaty Backup to Oracle Secure Backup. This chapter contains the following topics:

- Introduction to Oracle Secure Backup for Reliaty Backup Users

- Overview of the Migration from Reliaty Backup to Oracle Secure Backup

- Preparing for Migration from Reliaty Backup to Oracle Secure Backup

- Installing Oracle Secure Backup on the Administrative Server

- Stopping Oracle Secure Backup and Reliaty Backup Daemons on Linux and UNIX

- Installing Oracle Secure Backup on Media Servers

- Installing Oracle Secure Backup on Clients

- Performing Post-Installation Review and Configuration

- Uninstalling Reliaty Backup from Linux and UNIX

- Finding SCSI Device Information on Linux and UNIX

## Introduction to Oracle Secure Backup for Reliaty Backup Users

Oracle Secure Backup Administrator's Guide provides a comprehensive introduction to Oracle Secure Backup. This section describes only the features of Oracle Secure Backup most relevant to Reliaty Backup users who are migrating to Oracle Secure Backup. The most important points are as follows:

- Oracle Secure Backup retains the ability to back up and restore UNIX, Linux, Windows, and NAS file systems in a manner completely compatible with its predecessor, Reliaty Backup.

- Oracle Secure Backup adds support for the SBT API 2.0, thereby enabling Recovery Manager (RMAN) to use the Oracle Secure Backup SBT interface for media management operations.

Thus, Oracle Secure Backup performs two separate functions: the backup and restore of Oracle databases and the backup and restore of other file system objects.

Note:

What was referred to as recovering data in Reliaty Backup is referred to as restoring data in Oracle Secure Backup. The term "recovery" refers exclusively to database recovery, which is the process of rolling forward a database backup.

Whether you use Oracle Secure Backup to back up the database or the file system, you must first establish an administrative domain and define hosts, users, devices, and so forth just as you did with Reliaty Backup.

This section contains the following topics:

- Support for Oracle Database

- Terminology Changes

- Changes to Directory and File Names

- Changes to Users and Classes

- Changes to Tape Device Behavior

See Also:

Oracle Secure Backup Licensing Information for Oracle Secure Backup licensing terms

### Support for Oracle Database

To support the backup of Oracle databases, Oracle Secure Backup includes the following additional object types and policies:

- Database Backup Storage Selectors

- Oracle Database File Exclusion

- Backup Pieces and Sections

- Content-Managed Expiration Policies

- Delayed Start Time for RMAN Restore Operations

Note:

Oracle Secure Backup does not support BMC SQL-BackTrack or Microsoft's Exchange and SQL databases.

#### Database Backup Storage Selectors

When backing up an Oracle database, you can use a configuration object called a database backup storage selector to manage aspects of the backup. For example, you can configure device restrictions, the media family, and resource wait time for a backup. The Web tool and `obtool` support a new set of commands for managing storage selectors: `mkssel`, `chssel`, `lsssel`, and `renssel`.

See Also:

Oracle Secure Backup Reference to learn about the database backup storage selector commands

#### Oracle Database File Exclusion

When performing a non-database backup, you can skip files that would be included in a database backup. Examples of such files include Oracle datafiles, control files, archived redo logs, flashback logs, and so forth. To exclude these files, specify the `exclude oracle database files` directive in your dataset. The corresponding entry for a backup description file (BDF) is `~files`.

See Also:

Oracle Secure Backup Reference to learn about the dataset syntax

#### Backup Pieces and Sections

An RMAN backup of an Oracle database results in a backup set, which is a logical container for one or more backup pieces. Each backup piece is a separate backup image.

Through the Web tool and `obtool` you can list backup pieces (`lspiece`) and remove them (`rmpiece`). The `lssection`, `rmsection`, and `unrmsection` commands give you control over the individual sections of a backup piece.

See Also:

Oracle Secure Backup Reference to learn about the backup piece and section commands

#### Content-Managed Expiration Policies

Reliaty Backup recycled volumes based on an expiration time determined when the volume set was created. The expiration time was based on the write window and volume retention time defined in the media family for the volume. Oracle Secure Backup uses the same type of time-managed expiration policy. You can make file system backups or RMAN backups to volumes that use a time-managed policy.

You can also make RMAN backups, but not file system backups, to volumes that use a new content-managed expiration policy. When you create a media family you specify which type of expiration policy should be used. A content-managed volume expires when all backup pieces on the volume have been marked as deleted. You use the `DELETE` command in RMAN to mark tape backups as deleted.

When you install Oracle Secure Backup, the software includes a default content-managed media family named `RMAN-DEFAULT`. Oracle Secure Backup users are not permitted to delete, change, or rename this media family.

See Also:

Oracle Secure Backup Reference for a description of the media family commands

#### Delayed Start Time for RMAN Restore Operations

The `rmanrestorestartdelay` operations policy controls how long Oracle Secure Backup waits before beginning an RMAN-initiated restore operation. The default is 10 seconds. This delay enables the Oracle Secure Backup scheduler to optimize tape position operations when confronted with multiple restore requests.

### Terminology Changes

In some cases, terminology used in the Reliaty Backup documentation has changed in the Oracle Secure Backup documentation. Table 1-1 describes some of the more significant changes.

Table 1-1 Terminology Changes

Old Term | New Term
--- | ---
Administrative host | Administrative server
Archive | Backup image
Archive section | Backup section
Backup database (maintained by Reliaty Backup on administrative host) | Backup catalog (maintained by Oracle Secure Backup on administrative server)
Recover | Restore

### Changes to Directory and File Names

The Reliaty Backup root directory is now called the Oracle Secure Backup home directory. This directory and the files contained within it are named differently in Oracle Secure Backup.

Table 1-2 Name Changes for Reliaty Backup Files and Directories

Old Name | New Name
--- | ---
/usr/local/reliaty/backup | /usr/local/oracle/backup
C:\Program Files\Reliaty\Backup | C:\Program Files\Oracle\Backup
/usr/etc/rb | /usr/etc/ob
rbcleanup | obcleanup
rbcopy | obcopy
rbcvt | osbcvt
rbexec | obexec
rbixd | obixd
rbndmpd | obndmpd
rbnotify | obnotify
rbrobotd | obrobotd
rbscheduled | obscheduled
rbserviced | observiced
rbt | obt
rbtar | obtar
rbtool | obtool

See Also:

Oracle Secure Backup Installation and Configuration Guide for a description of Oracle Secure Backup files and directories

### Changes to Users and Classes

This section describes changes to the way users and classes are handled.

#### Oracle Class Rights

To control user access to Oracle database backups, Oracle Secure Backup includes new class rights. The `access Oracle backups` right determines which database backups an Oracle Secure Backup user can access. The `perform Oracle backups and restores` right enables class members to back up and restore Oracle databases.

#### Oracle Class of Users

When Oracle Secure Backup is installed, a new class of users called `oracle` is defined. Users in this class can perform RMAN backup and restore operations and have owner rights to Oracle database backups. The `admin` class also has all Oracle rights.

#### Preauthorized Operating System Users

You can preauthorize an operating system user name for either RMAN or command-line access to Oracle Secure Backup when logged into a given host. This technique enables use of Oracle Secure Backup without going through the normal Oracle Secure Backup login requirements. When installing Oracle Secure Backup, you have the option of defining an operating system user named `oracle` who is preauthorized to execute RMAN operations.

#### Login Token Handling

The following changes have been made to the handling of login tokens:

- Your login token, which Reliaty Backup used to retain, is no longer stored in your home directory. Oracle Secure Backup maintains login tokens on the administrative server (formerly called the administrative host).

- In Reliaty Backup, the login token was stamped with an expiration time based on the `security/loginduration` polic y. If the administrator subsequently changed the `loginduration` policy, it would not affect the login token. In Oracle Secure Backup, the login token is tagged with the time of the login and its expiration time is dynamically recalculated on every login attempt.

See Also:

Oracle Secure Backup Reference to learn about class rights, class commands, and user commands

### Changes to Tape Device Behavior

This section describes changes to how Oracle Secure Backup handles tape libraries and tape drives.

#### Autoswap and Wrap-Around Modes

Oracle Secure Backup discontinues the autoswap and wrap-around modes of library operation that were part of the automount logic in Reliaty Backup. The only change to the user interface is the removal of the corresponding options to the `mkdev` and `chdev` commands in `obtool` (and their Web tool equivalents).

#### Query Frequencies for Each Tape Drive

Tape drives vary considerably in the degree to which the position query frequency in use affects tape throughput. For this reason, you can establish the position query frequency for each tape drive by specifying the `--queryfreq` option to `mkdev` and `chdev` for tape drives. These values take effect only if the `operations/positionqueryfrequency` policy is set to the default value.

#### Bulk Import and Export Library Commands

The `importvol` and `exportvol` library commands are available in `obtool` and the Web tool. These commands move tapes into and out of a tape library through the import/export mechanism.

#### Multiple Devices Not Supported on obtar Command Line

In Reliaty Backup, you could specify `-f` and `-Xf` multiple times on the `rbtar` command line. For example, the following command specifies that `rbtar` should write to device `tape1` after `tape0` is full:

    rbtar -g home_bdf -f tape0 -f tape1

Oracle Secure Backup does not support multiple specifications of `-f` or `-Xf` on the `obtar` command line.

See Also:

Oracle Secure Backup Reference for a description of the device and library commands

## Overview of the Migration from Reliaty Backup to Oracle Secure Backup

This section explains how to migrate a Reliaty Backup administrative domain to an Oracle Secure Backup administrative domain. The migration procedure is usable for any version of Reliaty Backup.

This section assumes that you want to replace your Reliaty Backup administrative domain with an Oracle Secure Backup administrative domain. More specifically, the instructions make the following assumptions:

- The set of hosts in the Oracle Secure Backup domain is the same set of hosts as in the Reliaty Backup domain.

- Every host in the new Oracle Secure Backup administrative domain will retain its old Reliaty Backup role of administrative server, media server, or client.

- The Oracle Secure Backup domain will include the same tape devices that existed in the Reliaty Backup domain.

If you want to add, modify, or remove hosts or devices from the new Oracle Secure Backup domain, then you can perform this configuration after you have installed Oracle Secure Backup on the hosts in the domain.

Note that you cannot create a mixed domain that includes hosts running Reliaty Backup and hosts running Oracle Secure Backup. The software architecture and network messages of the two backup applications differ substantially. Also, you cannot run both Reliaty Backup and Oracle Secure Backup on the same host simultaneously because it results in contention for communication ports.

### Overview of the Migration Steps

This section describes the basic steps of the migration. Each step includes a link to a section in this chapter that explains the task in detail.

To migrate Reliaty Backup to Oracle Secure Backup:

1. Identify all hosts and devices in the administrative domain and then back up the Reliaty Backup files on the administrative server.

   This task is described in "Preparing for Migration from Reliaty Backup to Oracle Secure Backup".

2. Install Oracle Secure Backup on the administrative server.

   During the installation, the install script detects the Reliaty Backup installation and asks whether you wish to run a conversion routine called `osbcvt`. This utility automatically converts the pertinent Reliaty Backup administrative files into the proper formats and locations within Oracle Secure Backup.

   This task is described in "Installing Oracle Secure Backup on the Administrative Server".

3. Stop all Reliaty Backup daemons running on Linux and Solaris clients and media servers, and stop all Reliaty Backup services running on Windows clients and media servers.

   On Linux and Solaris clients and media servers, use `stoprb` from the administrative server to stop the Reliaty Backup daemons. This task is described in "Stopping Oracle Secure Backup and Reliaty Backup Daemons on Linux and UNIX".

   On Windows clients and media servers, you must stop the Reliaty Backup services locally, using the Services tool in the Windows Control Panel. The necessary procedures are described in "Uninstalling Reliaty Backup and Installing Oracle Secure Backup on Windows Media Servers" and "Uninstalling Reliaty Backup and Installing Oracle Secure Backup on Windows Clients".

   Note:

   You cannot stop Reliaty Backup services on a Windows host from a remote location. Thus, you must stop them locally.

4. Install Oracle Secure Backup on the media servers in the administrative domain.

   After you have migrated the administrative server you are ready to migrate your remote media servers (if any). The procedure is essentially the same as for installing Oracle Secure Backup on the administrative server.

   This task is described in "Installing Oracle Secure Backup on Media Servers".

5. Install Oracle Secure Backup on the clients in the administrative domain.

   After you have migrated the administrative server and media servers you are ready to migrate your clients. You can use your administrative server's client update feature to bring the Linux and UNIX clients into the domain. You must log on to each Windows client locally.

   This task is described in "Installing Oracle Secure Backup on Clients".

6. Perform post-installation review and configuration of the administrative domain.

   This task is described in "Performing Post-Installation Review and Configuration".

7. Uninstall Reliaty Backup from all Linux and UNIX hosts in the administrative domain.

   This task is described in "Uninstalling Reliaty Backup from Linux and UNIX".

See Also:

Oracle Secure Backup Reference for a description of the `osbcvt` utility

## Preparing for Migration from Reliaty Backup to Oracle Secure Backup

Your first task is to prepare for the migration. You should make backups of important files, cancel active and scheduled backup jobs, and stop Reliaty Backup daemons on the administrative server.

Note that these instructions refer to the administrative server, which was known as the administrative host in Reliaty Backup. Reliaty Backup did not support the use of a Windows host for an administrative server.

The Reliaty Backup home is the directory in which Reliaty Backup is installed. By default, this home directory is `/usr/local/reliaty/backup` on Linux and UNIX and `C:\Program Files\Reliaty\Backup` on Windows (see Table 1-2).

Follow these steps to prepare for the migration:

1. Log in to the Reliaty Backup Web tool and display all hosts and devices in the administrative domain. Copy this information to a convenient location.

2. Log on to the administrative server and back up the following Reliaty Backup files and directories, making sure to use a backup tool other than Reliaty Backup:

   - The `/etc/rbconfig` file

     In this file you can locate the paths to other files that you want to back up. The following sample file shows typical directories:

         local db dir:           /usr/etc/rb
         temp dir:               /usr/tmp
         rb dir:                 /usr/local/reliaty/backup
         admin dir:              /usr/local/reliaty/backup/admin

     Note that `rb dir` indicates the Reliaty Backup home.

   - The `admin` directory in the Reliaty Backup home (as specified in `rbconfig`)

   - The local database directory (as specified in `rbconfig`)

   - The `install/rbparameters` file in the Reliaty Backup home

   Another backup method is to copy the `rbconfig` file, local database directory, and device files into the parent directory of your Reliaty Backup home. Afterwards, use `tar` to create an archive of this directory.

   Assuming the paths shown in the preceding example of `/etc/rbconfig`, you would create the archive as follows:

       cd /usr/local/reliaty    # navigate to parent directory of Reliaty Backup home
       cp -r /etc/rbconfig /usr/etc/rb .   # copy rbconfig and local db
       cd ..  # navigate to superdirectory
       tar -cvf reliaty.tar reliaty  # create TAR file

   Note:

   This backup can be quite large because it includes all of the Reliaty Backup catalog data for all backups on all hosts. Ensure that you have sufficient disk space for the backup.

   You could then use `ftp` to transfer the TAR file to another host on your network and remove the original TAR from your local administrative server. Other alternatives include a native `tar` backup to a local tape drive or writing the files and directories to removable media.

3. Change into the Reliaty Backup home and run the `install/probedev` utility. The command generates `probedev.out` in `/tmp`.

   As shown in Step 7 of "Installing Oracle Secure Backup on the Administrative Server", you can use `probedev.out` as a reference for configuring the SCSI devices attached to your media servers.

4. Copy the `install/rbparameters` file in your Reliaty Backup home to a convenient location.

   You will compare `rbparameters` to your new `obparameters` file to make sure that your installation locations are consistent.

5. Make sure that no active backups are running.

   Check for active backups by using an `lsjob` command in `rbtool` or by checking jobs status in the Reliaty Backup Web tool. If active jobs exist, then wait for them to finish or cancel them with the `canceljob` command. If jobs are pending for today, then cancel them as well. You can cancel all pending and active jobs as follows:

       rbtool lsjob -s | xargs rbtool canceljob

6. Stop all Reliaty Backup processes on the administrative server.

   If you are using a Linux or UNIX system, then you can use the following command to list the processes:

       /bin/ps -ef | grep rb

   Use a `kill -9` command on all the Reliaty Backup processes.

7. If your domain includes remote media servers, then gather the device information for these servers. Follow these steps:

   1. Log on to each remote media server.

   2. Change into the Reliaty Backup home and run the `install/probedev` utility.

   3. Rename the `probedev.out` file for each media server so that the host of origin is included in the name: `probedev_brhost2.out`, `probedev_brhost3.out`, and so forth.

   4. Transfer the renamed `probedev.out` files for all media servers into the same directory that contains the `probedev.out` file on the administrative server.

After you have completed the tasks in this section, you are ready to install Oracle Secure Backup on the administrative server.

## Installing Oracle Secure Backup on the Administrative Server

The instructions for installing Oracle Secure Backup on the administrative server are essentially the same as the instructions in Oracle Secure Backup Installation and Configuration Guide. The setup and most of the installation are identical.

The migration diverges from a standard installation if the `installob` script detects that Reliaty Backup is installed on your system. In this case, the script prompts you to migrate Reliaty Backup to Oracle Secure Backup. The script runs a migration utility called `osbcvt`.

The procedure in this section makes the following assumptions:

- Your local host runs Linux or UNIX. Reliaty Backup does not support Windows as the administrative server.

- Your local host was configured as an administrative server in Reliaty Backup.

- You have convenient access to a copy of Oracle Secure Backup Installation and Configuration Guide. Rather than duplicating information, some steps in this section refer to instructions in the installation manual.

The sample output in this section is for an installation on a Solaris host called `sun_host` with an attached tape drive and tape library. The instructions are equally applicable to Linux and UNIX.

To install Oracle Secure Backup on an administrative server:

1. Use the Linux or UNIX `script` utility (or another method of your choosing) to generate a transcript of the migration. This transcript may be useful if you need assistance from Oracle Support.

2. Stage the installation software.

3. Follow the procedure for loading and installing the Oracle Secure Backup software on Linux or UNIX in Oracle Secure Backup Installation and Configuration Guide. Make the following choices:

   1. When prompted to load packages, load all the packages that will be used by hosts in the administrative domain.

   2. Enter `yes` to start `installob`.

   3. When prompted to review the `obparameters` file, compare the `obparameters` file to the old `rbparameters` file that you saved to a safe place in "Preparing for Migration from Reliaty Backup to Oracle Secure Backup".

      Typically, `obparameters` has the following settings:

          customized obparameters: yes
          start daemons at boot: yes
          start daemons at install: yes

      Sometimes you need to customize the paths to the installation directories. Refer to Oracle Secure Backup Installation and Configuration Guide to learn how to configure the parameters in this file. When you are satisfied with the `obparameters` file contents, enter `yes` at the `installob` prompt.

   4. Choose the interactive mode of installation.

4. When prompted to select a role for your host, select the option for the administrative server.

   When the `installob` script detects the Reliaty Backup installation, the script displays output similar to the following, which varies among operating systems:

       An installation of Reliaty Backup has been detected on this host.
       If you have not already backed up your Reliaty Backup installation,
       Oracle recommends that you do so now. As a part of the migration the Oracle
       Secure Backup installer will disable any startup scripts used by Reliaty Backup.

       This is required to prevent the contention for port 400 by the Reliaty Backup
       and Oracle Secure Backup service daemons.
       Do you wish to proceed? [yes]

5. Enter `yes` to proceed.

   The `installob` script asks you to confirm the migration:

       Would you like to migrate the admin directory from Reliaty Backup
       to Oracle Secure Backup? [yes]

6. Enter `yes` to confirm the migration of the `admin` directory.

   At this point the `installob` script launches the `osbcvt` utility and starts migrating the data. The script installs the Oracle Secure Backup device driver automatically. The script displays output similar to the following:

       Starting data migration from Reliaty Backup to Oracle Secure Backup.
       The Reliaty Backup admin data will be moved to /space/oracle/backup.051011

       Data migration from Reliaty Backup is complete.

       Beginning the installation.  This will take just a minute and will produce
       several lines of informational output.

       Installing Oracle Secure Backup on sun_host (solaris version 5.7)
           generating links for admin installation with Web server
           checking Oracle Secure Backup's configuration file (/etc/obconfig)
           setting Oracle Secure Backup directory to /space/oracle/backup.051011 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 /space/oracle/backup.051011/admin in
               /etc/obconfig
           protecting the Oracle Secure Backup directory
           installing /etc/init.d/OracleBackup for observiced start/kill ops at
               operating system run-level transition
           installing start-script (link) /etc/rc2.d/S92OracleBackup
           installing kill-script  (link) /etc/rc1.d/K01OracleBackup
           installing kill-script  (link) /etc/rc0.d/K01OracleBackup
           initializing the administrative domain
       NOTE: installing Oracle Secure Backup driver in order to identify SCSI
       busses...
       NOTE: /space/oracle/backup.051011/.drv.solaris/ob copied to /usr/kernel/drv/ob
       NOTE: /space/oracle/backup.051011/.drv.solaris/ob.conf copied to /usr/kernel/drv/ob.conf
       NOTE: /space/oracle/backup.051011/.drv.solaris/ob64 copied to
        /usr/kernel/drv/sparcv9/ob
       NOTE: The Oracle Secure Backup device driver has been successfully installed.

       Is sun_host connected to any tape libraries that you'd like to use with
       Oracle Secure Backup [no]?

   If the local host is not a media server, then answer `no` to the next three questions to complete the administrative server installation; you can skip ahead to "Stopping Oracle Secure Backup and Reliaty Backup Daemons on Linux and UNIX". Otherwise, proceed to the next step to configure tape devices.

7. If you have tape libraries or tape drives attached to this host that you used with Reliaty Backup, then obtain the SCSI target ID and SCSI LUN for each device attached to your system.

   "Finding SCSI Device Information on Linux and UNIX" explains how to obtain SCSI device information for these operating systems.

8. Create the device special files as explained in Oracle Secure Backup Installation and Configuration Guide. For each device attached to your system, supply the SCSI target ID and SCSI LUN obtained in the preceding step.

   Create the device special files. For each device attached to your system, supply the SCSI target ID and SCSI LUN obtained in the preceding step.

   Note:

   The sample output shown in this step is provided as an illustration, not as data for you to enter in your own installation.

   The following sample output shows how to configure the tape library and tape drive from the previous step:

       Is sun_host connected to any tape libraries that you'd like to use with
       Oracle Secure Backup [no]? yes

       How many Oracle Secure Backup tape libraries are attached to sun_host [1]?

       Please describe each tape library by answering the following questions.

           Logical unit number [0]:
           SCSI bus name-instance [pci1000,f0]:
           SCSI target ID [3]: 1
           SCSI lun 0-7 [0]:

       Is the information you entered correct [yes]?

       Is sun_host connected to any tape drives that you'd like to use with
       Oracle Secure Backup [no]? yes

       How many Oracle Secure Backup tape drives are attached to sun_host [1]?

       Please describe each tape drive by answering the following questions.

           Logical unit number [0]:
           SCSI bus name-instance [pci1000,f0]:
           SCSI target ID [4]: 0
           SCSI lun 0-7 [0]:

       Is the information you entered correct [yes]?

       -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -

       Beginning device driver configuration and device special file creation.

       NOTE: table for devlinks...
          type=ddi_pseudo;name=ob;addr=0,0;minor=pci1000,f0    obt0
       Could not read symbolic link /dev/bd.off
       /dev/obt0 created
       NOTE: table for devlinks...
          type=ddi_pseudo;name=ob;addr=1,0;minor=pci1000,f0    obl0
       Could not read symbolic link /dev/bd.off
       /dev/obl0 created

       -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -

       NOTE: You must configure the new devices via the Web interface or via
             the command line using the obtool 'mkdev' command.
       -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -

       Would you like to install Oracle Secure Backup on any other machine [yes]?

       Enter the name of a host onto which you'd like to install Oracle Secure Backup:
       -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -

       Would you like to install Oracle Secure Backup on any other machine [yes]?

9. Answer `no` when asked whether to install the software on other machines.

   The following sample output shows the summary of the installation:

       Would you like to install Oracle Secure Backup on any other machine [yes]? no
       Installation summary:

           Installation  Host                OS        Driver      OS Move   Reboot
           Mode          Name                Name      Installed?  Required? Required?
           admin         sun_host            solaris   no          no         no
       Oracle Secure Backup is now ready for your use.

At this stage of the migration, you are now to stop the daemons in preparation for the installation on the remaining hosts in the domain.

## Stopping Oracle Secure Backup and Reliaty Backup Daemons on Linux and UNIX

The Reliaty Backup and Oracle Secure Backup service daemons use the same ports. If you have `rbserviced` running on a client or media server, then you will not be able to start `observiced` on the same host. Thus, you should stop the Reliaty Backup processes on the clients and media servers. You should also stop the Oracle Secure Backup processes running on the administrative server.

To stop Oracle Secure Backup and Reliaty Backup daemons:

1. Log on the administrative server (if you are not already logged on).

2. Stop all Oracle Secure Backup processes running on the administrative server.

   You can use the following command to list the processes:

       /bin/ps -ef | grep ob

   Use a `kill -9` command to stop each of the Oracle Secure Backup processes.

   Note:

   If Oracle Secure Backup daemons are running on hosts in the domain other than the administrative server, perhaps because of test installations on these machines, then stop these daemons as well by logging into the host, using `ps -ef` to identify the processes, and `kill -9` to stop them.

3. You can stop the Reliaty Backup daemons on Linux and UNIX media servers and clients by running the `install/stoprb` utility on the administrative server. You already stopped the Reliaty Backup daemons on the administrative server in "Preparing for Migration from Reliaty Backup to Oracle Secure Backup", so you do not need to stop the daemons on this host.

   Note:

   To stop the Reliaty Backup service on Windows hosts you must log on locally to each Windows host. This procedure is explained in This procedure is explained in "Uninstalling Reliaty Backup and Installing Oracle Secure Backup on Windows Media Servers" and "Uninstalling Reliaty Backup and Installing Oracle Secure Backup on Windows Clients".

   The procedure varies depending on whether you have remote shell (`rsh`) as `root` to the hosts on which the Reliaty Backup daemons are running:

   - If you have `rsh` enabled, then navigate to the Oracle Secure Backup home and use the `install/stoprb` utility on the administrative server.

     You can use this utility to stop Reliaty Backup daemons on multiple hosts by specifying a space-separated list after the `stoprb` command. For example, the following command stops Reliaty Backup daemons on `brhost1`, `brhost2`, and `brhost3`:

         # install/stoprb brhost1 brhost2 brhost3

   - If `rsh` is not enabled, then log on to each Linux and UNIX host in the domain and stop the processes.

     You can use the following command to show the processes:

         /bin/ps -ef | grep rb

     Use the `kill -9` command on the associated process IDs.

At this stage of the migration, only the administrative server has Oracle Secure Backup installed. You have stopped all Oracle Secure Backup and Reliaty Backup daemons running on Linux and UNIX hosts in the administrative domain.

You are now ready to install Oracle Secure Backup on the media servers and clients in the domain. If any of these hosts run the Windows operating system, then you will stop the Reliaty Backup services on these hosts, uninstall Reliaty Backup, and then install Oracle Secure Backup.

## Installing Oracle Secure Backup on Media Servers

If your administrative domain uses media servers other than the administrative server, then install Oracle Secure Backup on each media server. Otherwise, skip to "Installing Oracle Secure Backup on Clients".

The installation instructions vary depending on the operating system of the media server. This section assumes that you have convenient access to a copy of Oracle Secure Backup Installation and Configuration Guide. Rather than duplicating information, some steps in this section refer to instructions in the installation manual.

Note:

In this phase of the migration, you configure only the device special files and drivers for the media servers. The Reliaty Backup device names and other device configuration data is migrated to Oracle Secure Backup automatically. You can make changes to this data in "Performing Post-Installation Review and Configuration".

### Installing Oracle Secure Backup on Linux and UNIX Media Servers

The instructions for installing Oracle Secure Backup on media servers are basically the same as "Installing Oracle Secure Backup on the Administrative Server". You must log on to each host, access the installation software by mounting the distribution media or downloading a ZIP file, and then run `setup` and `installob`. The differences are as follows:

- You choose `media server` rather than `administrative server` when `installob` prompts for the role used by the host.

- Do not migrate the `admin` directory because the host is not configured as the administrative server.

### Uninstalling Reliaty Backup and Installing Oracle Secure Backup on Windows Media Servers

The instructions in this section apply to Windows media servers only. The instructions are written to be as generic as possible, so the names of the GUI elements may vary slightly among the various Windows platforms.

Before installing Oracle Secure Backup on a Windows host, you must stop the Reliaty Backup services and uninstall Reliaty Backup. Unlike in the case of Linux and UNIX, you cannot run a batch program to stop the Reliaty Backup daemons on Windows hosts remotely from the administrative server.

To uninstall Reliaty Backup and install Oracle Secure Backup on a Windows media server:

1. Log on to the Windows host as an administrator.

2. Stop the Reliaty Backup service as follows:

   1. Open the Control Panel.

   2. Double-click Administrative Tools.

   3. Double-click Services.

   4. Right-click Reliaty Backup and select Stop from the shortcut menu.

3. Uninstall the Reliaty Backup software as follows:

   1. Open the Control Panel.

   2. Double-click Add or Remove Programs.

   3. Select Reliaty Backup.

   4. Click Remove.

   5. Click Yes to remove Reliaty Backup.

4. Remove the Reliaty Backup device driver as follows:

   1. Open the Control Panel.

   2. Double-click System.

   3. Click the Hardware tab.

   4. Click Device Manager.

   5. Right-click the rbt driver and select Uninstall from the shortcut menu.

   6. Click OK.

5. Restart the system.

6. Install Oracle Secure Backup on this host and configure it as a media server. This task is explained in Oracle Secure Backup Installation and Configuration Guide.

When Oracle Secure Backup is installed on all media servers in your administrative domain, you are ready to install Oracle Secure Backup on the clients.

## Installing Oracle Secure Backup on Clients

This section assumes that you have convenient access to a copy of Oracle Secure Backup Installation and Configuration Guide. Rather than duplicating information, some steps in this section refer to instructions in the installation manual.

The installation instructions for a client vary depending on the host operating system. Installation instructions for all Linux or Unix clients are similar, and use the `setup` and `installob` scripts. The installation process for Windows is based upon a standard Windows installer.

### Installing Oracle Secure Backup on a Linux or UNIX Client

Full instructions for performing client installation on Linux or Unix are contained in Oracle Secure Backup Installation and Configuration Guide.

You must install the Oracle Secure Backup software individually on each client. Use the CD-ROM, mounted locally or through NFS, or installation media downloaded from OTN and extracted from a Zip file.

To install Oracle Secure Backup on Linux and UNIX clients:

1. Edit the `obparameters` file if necessary, comparing it to the old `rbparameters` file that you saved to a safe place in "Preparing for Migration from Reliaty Backup to Oracle Secure Backup".

   Typically, `obparameters` has the following settings:

       customized obparameters: yes
       start daemons at boot: yes
       start daemons at install: yes

   Sometimes you need to customize the paths to the installation directories. Review the `obparameters` file and make sure that it contains the correct entries. Refer to Oracle Secure Backup Installation and Configuration Guide to learn how to configure the parameters in this file.

2. Change to your Oracle Secure Backup home directory and run `installob`.

   If you have installed Oracle Secure Backup in the default location, then you run the installation program as follows:

       cd /usr/local/oracle/backup
       install/installob

3. When prompted, choose the options for interactive installation, and for the client role only.

4. After the client installation completes, the following prompt is displayed:

       Would you like to install Oracle Secure Backup on any other machine [yes]?

   Enter `no` at this prompt to exit the `installob` script.

### Uninstalling Reliaty Backup and Installing Oracle Secure Backup on Windows Clients

The instructions in this section apply to Windows clients only. The instructions are written to be as generic as possible, so the names of the GUI elements within the Windows Control Panel may vary slightly among the various Windows platforms.

Before installing Oracle Secure Backup on a Windows host, you must stop the Reliaty Backup services and uninstall Reliaty Backup. Unlike in the case of UNIX and Linux, you cannot run a batch program to stop the Reliaty Backup daemons on Windows hosts remotely from the administrative server.

To uninstall Reliaty Backup and install Oracle Secure Backup on a Windows client:

1. Log on to the Windows client as an administrator.

2. Stop the Reliaty Backup service as follows:

   1. Open the Control Panel.

   2. Double-click Administrative Tools.

   3. Double-click Services (you may have to double-click Computer Management and then Services).

   4. Right-click Reliaty Backup and select Stop from the shortcut menu.

3. Uninstall the Reliaty Backup software as follows:

   1. Open the Control Panel.

   2. Double-click Add or Remove Programs.

   3. Select Reliaty Backup.

   4. Click Remove.

   5. Click Yes to remove Reliaty Backup.

4. Shut down and restart Windows.

5. Install Oracle Secure Backup on this host and configure it as a client, using the instructions in Oracle Secure Backup Installation and Configuration Guide. When prompted for roles to install on this host, select the media server role.

When Oracle Secure Backup is installed on all hosts in your administrative domain, you are ready to review the domain configuration and make any changes.

## Performing Post-Installation Review and Configuration

This section describes the following tasks:

- Reinitializing the Administrative Domain After Migration

- Reviewing Oracle Secure Backup Settings

- Configuring Additional Oracle Secure Backup Settings

- Configuring Backup Schedules

### Reinitializing the Administrative Domain After Migration

The first time you run `obtool` after migration, you must reinitialize the administrative server to recognize the new security features of Oracle Secure Backup.

Note:

If you do not perform this step, then the first time you try to use `obtool` after migration, the following error message is displayed:

    Error: Can't fetch this host's information --UID not found.

To reinitialize the administrative domain after migration:

1. Use the `ps -ef` command to identify any running Oracle Secure Backup processes:

       ps -ef |grep ob

2. Stop each process identified in Step 1 with `kill -9`:

       kill -9 pid

3. Run the obtool command with following options to reinitialize the administrative server:

       obtool --initnewdomain --force

### Reviewing Oracle Secure Backup Settings

Inspect the configuration data for the administrative domain to ensure that it migrated correctly from Reliaty Backup. This section explains how to perform administrative tasks by means of the Oracle Secure Backup Web tool.

This section assumes that you are acquainted with the Web tool and have convenient access to Oracle Secure Backup Administrator's Guide. It also assumes that you have stopped the Oracle Secure Backup processes on the administrative server as described in Step 2 in "Stopping Oracle Secure Backup and Reliaty Backup Daemons on Linux and UNIX".

To review Oracle Secure Backup settings:

1. Log on to the administrative server and start the Oracle Secure Backup service daemon, which automatically starts the Apache Web server. For example:

       /etc/observiced

2. Start the Web tool as explained in Oracle Secure Backup Installation and Configuration Guide. For example, if the administrative server is named `sun_server`, then enter the following URL in your browser:

       https://sun_server

3. Log in to the Oracle Secure Backup administrative domain as `admin`.

   The `admin` password for Oracle Secure Backup is the same password used for Reliaty Backup. As explained in Oracle Secure Backup Administrator's Guide, you can change the password for this user by clicking the Configure tab, Users, and then Change Password.

4. If you are backing up Windows clients and have Windows domains, then check the `admin` user settings to be sure that they are correct. Otherwise, skip this step and proceed to the next step.

   Follow these steps to configure Windows domain settings:

   1. Click the Configure tab and then click Users.

   2. Select the `admin` user and click Edit.

   3. Click Windows Domains.

   4. Enter the Windows Domain Name, Administrative User, and password for each of the Windows Domains for Windows clients that you plan to back up with Oracle Secure Backup.

      When defining an user for a Windows Domain, choose the Administrator or a user configured by the Administrator. This user must belong to the Backup Operators group, must not be required to change password at login, must have a non-expiring password, and must have the right to back up files and directories, restore files and directories, log in as a service, act as part of the operating system, increase quotas, and replace a process level token.

5. Review the configuration data for the hosts in your administrative domain.

   Oracle Secure Backup Installation and Configuration Guide explains how to review information for hosts and perform configuration tasks. Follow these steps:

   1. From the home page, click the Configure tab and then Hosts.

      Use the Hosts page as a base for the tasks in this step.

   2. Optionally, select a host and click Rename to rename to change the name of a host within the administrative domain.

   3. Select each host and click Ping to make sure that each host is resolvable to an IP address.

      You can use `nslookup` or the `/etc/hosts` file on the administrative server to resolve IP address issues. Alternatively, click Edit to edit the properties of the host and define one or more resolvable names in IP interface name(s).

   4. Ensure that the roles assigned to each host are correct. For example, ensure that the hosts with the media server role really are media servers.

   5. Select each host and click Edit to confirm that the properties are set correctly. If a host is no longer in your network but has backups in the catalog for legacy reasons, then check Suppress communication with host and then Apply.

   6. Select any obsolete hosts (that is, hosts no longer in the network and with no backups in the catalog that you need) and click Remove to delete the hosts from the domain.

6. Review the information for the tape devices in your administrative domain.

   Oracle Secure Backup Installation and Configuration Guide explains how to configure devices. Follow these steps:

   1. Click the Configure tab and then click Devices.

      Use the Devices page as a base for the tasks in this step.

   2. Select each device and click Show Properties to review the properties to confirm that the settings are correct.

      Note:

      In most cases, tape devices are automatically migrated with the correct settings. You should verify the settings for each device. If some of them are not correct, use the process in the following steps to enter the new settings.

   3. For each device, click Edit and then Attachments. Attachments identify the host and internal name by which Oracle Secure Backup accesses the device.

      The new device special files will be named `hostname``:/dev/obt` `OSB_LUN` for tape drives and `hostname``:/dev/obl` `OSB_LUN` for libraries, where `OSB_LUN` is a placeholder for the Oracle Secure Backup logical unit number.

      To remove the existing attachment for a Reliaty Backup device (`hostname``:/dev/rb*`) and replace it with the Oracle Secure Backup attachments, select the media server in Host and enter the raw device name. Typically, if you are replacing `hostname``:/dev/rbt0`, then your new device will be `hostname``:/dev/obt0`.

      Click Apply to save your attachments settings and return to the Devices page.

   4. Optionally, click Add to add any devices attached to Windows media servers that were not migrated from Reliaty Backup.

   5. Click Ping for each device to make sure that it is accessible.

   6. Optionally, select a device name and click Rename to rename any devices that you would like to identify by a different name.

      Note:

      Any pre-existing backup schedules have been imported from Reliaty Backup with the former device names. If you change the device names, then remember to update the backup schedules to use these new names.

7. Edit each media family, and update it with the needed time management parameters.

   Note:

   If you do not perform this step, then when you try to use a migrated media family, the following error is displayed:

       Need to be time managed, can't be content managed

8. Inspect the remaining configuration data for datasets, media families, backup schedules, and so forth to make sure that it migrated properly.

At this stage of the migration, you have reviewed the settings in the administrative domain and confirmed that they are correct. You can take this opportunity to configure additional Oracle Secure Backup settings.

### Configuring Additional Oracle Secure Backup Settings

In this section, you have an opportunity to modify your administrative domain configuration. For example, you can create new users. This section assumes that you have convenient access to Oracle Secure Backup Administrator's Guide, which provides detailed configuration instructions.

To configure additional domain settings:

1. Optionally, add classes that define different rights other than those found in the default classes installed by Oracle Secure Backup. Oracle Secure Backup Administrator's Guide explains how to perform this task.

2. Add other Oracle Secure Backup users as needed. You way want to create users who can log in with limited rights. Oracle Secure Backup Administrator's Guide explains how to perform this task.

3. Edit your defaults and policies settings to custom configure them to your site. Oracle Secure Backup Administrator's Guide explains how to perform this task.

4. Configure a job summary schedule so that you can have backup status summaries produced and mailed at user-defined intervals. Oracle Secure Backup Administrator's Guide explains how to perform this task.

5. Configure preauthorizations, database backup storage selectors, and media families needed for RMAN backups. Oracle Secure Backup Administrator's Guide explains how to perform this task.

At this stage of the migration, the Oracle Secure Backup administrative domain is configured. You are now ready to begin creating backups schedules in preparation for normal backup operations.

### Configuring Backup Schedules

Before resuming normal backup operations, ensure that your backup settings are configured correctly and the tape devices are prepared.

This section refers to administrative tasks that you can perform with the Oracle Secure Backup Web tool. If you need additional information about how to perform these tasks, refer to Oracle Secure Backup Administrator's Guide.

1. Check your media servers to confirm that their inventory status is current.

   Log in to the Web tool as the `admin` user and perform the following steps:

   1. In the home page, Click Manage and then Libraries.

   2. In the Libraries page, select each library name and then select Inventory from Library Commands. Click Apply.

   3. Check Force to force an inventory and then click OK.

   4. In the Libraries page, select each library and click List Volumes.

2. Check that your backup schedules have the right host and device names specified to reflect any changes made to your configuration. Oracle Secure Backup Administrator's Guide explains how to configure backup schedules. Follow these steps:

   1. From the home page, click Backup and then Schedules.

   2. Select each schedule and click Edit to display the properties and modify them if necessary.

   3. Click Triggers to display the trigger information and modify it if necessary.

3. Restart the schedule daemon.

   Oracle Secure Backup Administrator's Guide explains how to manage daemons. Follow these steps:

   1. Click the Manage tab and then click Daemons.

   2. In the Type list, select obscheduled.

   3. In the Host list, select the administrative server.

   4. Click Suspend and then Resume.

4. From the home page, Click Manage and then Jobs to make sure that backups scheduled for today are displayed.

5. From the home page, click Backup and then Backup Now to create a test backup job. For example, create a subdirectory called `testbkup` in your `/tmp` directory, copy a few small files to this directory, and then back up `/tmp/testbkup`.

6. From the home page, click Restore and then Backup Catalog. To test a restore operation, restore the backup that you created in the previous step.

   You are now ready to resume normal backups operations with Oracle Secure Backup.

## Uninstalling Reliaty Backup from Linux and UNIX

At this point the migration from Reliaty Backup to Oracle Secure Backup is almost complete. You can now uninstall Reliaty Backup from your Linux and UNIX hosts.

Note:

You do not need to uninstall Reliaty Backup from Windows hosts because you perform this task in "Uninstalling Reliaty Backup and Installing Oracle Secure Backup on Windows Clients".

To uninstall Reliaty Backup from the Linux and UNIX hosts in your domain:

1. Log on as `root` to the host that was the administrative server for your Reliaty Backup domain.

2. Change into the Reliaty Backup root directory:

       cd /usr/local/reliaty/backup

3. Run the `uninstallrb` utility:

       install/uninstallrb

4. Answer the questions asked by `uninstallrb` to remove Reliaty Backup from each Linux and UNIX host in your administrative domain. Be sure to start with your clients and uninstall your administrative server last.

## Finding SCSI Device Information on Linux and UNIX

Oracle Secure Backup Installation and Configuration Guide provides a general description of how to obtain device information on Linux and UNIX when installing Oracle Secure Backup. You can find the information for your Reliaty Backup devices by examining the `probedev.out` file that you generated in Step 3 of "Preparing for Migration from Reliaty Backup to Oracle Secure Backup".

On Solaris, search the file for the string `/var/adm/messages` and look for a line that includes a target and LUN for the SCSI device. Example 1-1 shows an example of the relevant section on a Solaris system.

Example 1-1 probedev Output for Solaris

    /var/adm/messages...
    Oct 13 09:52:25 sun_host unix: rb0:   <EXABYTE EXB-85058SQANXR1>
    Oct 13 09:52:25 sun_host unix: rb0 at glm0:
    Oct 13 09:52:25 sun_host unix:  target 0 lun 0
    Oct 13 09:52:25 sun_host unix: rb0 is /pci@1f,0/pci@1/scsi@1/rb@0,0
    Oct 13 09:52:25 sun_host unix: rb2:   <EXABYTE EXB-10i>
    Oct 13 09:52:25 sun_host unix: rb2 at glm0:
    Oct 13 09:52:25 sun_host unix:  target 1 lun 0
    Oct 13 09:52:25 sun_host unix: rb2 is /pci@1f,0/pci@1/scsi@1/rb@1,0

In Example 1-1, the EXB-8505 tape drive uses SCSI target ID 0 and SCSI lun 0. The EXABYTE EXB-10i tape library uses SCSI target ID 1 and SCSI lun 0.

On Linux, search the file for the string `/proc/scsi/scsi` and look for a line that includes a target and LUN for the SCSI device. Example 1-2 shows an example of the relevant section on a Linux system.

Example 1-2 probedev Output for Linux

    /proc/scsi/scsi...
    Attached devices:
    Host: scsi0 Channel: 00 Id: 03 Lun: 00
      Vendor: ADIC     Model: FastStor DLT     Rev: 0115
      Type:   Medium Changer                   ANSI SCSI revision: 02
    Host: scsi0 Channel: 00 Id: 04 Lun: 00
      Vendor: Quantum  Model: DLT4000          Rev: D98C
      Type:   Sequential-Access                ANSI SCSI revision: 02

In Example 1-2, the FastStor DLT Library is using SCSI target ID 03 and SCSI lun 0. The DLT4000 tape drive uses SCSI target ID 04 and SCSI lun 0.

In addition to specifying SCSI device information, you must also assign an Oracle Secure Backup logical unit number during the configuration process. This number, which is between 0 and 31, is used to generate unique device special file names during device configuration. Sample device special file names are `/dev/obt0` and `/dev/obt1`.

Typically, Oracle Secure Backup logical unit numbers start at 0 and increment for each additional device of a given type, whether library or drive. Do not confuse the Oracle Secure Backup logical unit number with the SCSI LUN. The SCSI LUN is part of the hardware address of the device, whereas the Oracle Secure Backup logical unit number is a value you assign arbitrarily, that is used in creating the device special file name. The Oracle Secure Backup logical unit number is the first number queried for each device during the configuration process.