Installing Oracle Secure Backup on Linux or UNIX

4 Installing Oracle Secure Backup on Linux or UNIX

This chapter explains how to install Oracle Secure Backup on hosts running Linux or UNIX.

This chapter contains the following sections:

Prerequisites for Installing on Linux or UNIX

Before starting Oracle Secure Backup installation on a Linux host, check the following prerequisites.

Complete the planning tasks described in Preparing to Install Oracle Secure Backup.
Preconfigure the required attach points for your tape drives and libraries on your media server systems.

See Also:

Configuring Platform-Specific Media Server Devices
Before adding Oracle Secure Backup tape libraries and drives to an administrative domain, disable or stop any system software that scans and opens arbitrary SCSI targets (for example, tape library monitoring software).
You have the root privileges on each host to perform the installation.
Ensure that the host has the packages sg3_utils and the sg3_utils-libs installed. To run the sg_map command, the host requires these packages.

Note:

To install Oracle Secure Backup on a host with Oracle Linux 8, ensure that the host has the packages csh and libnsl installed.

For more information, contact your system administrator or Linux operating system documentation.
For installing the administrative server or media server role, verify the physical and network requirements for the host as discussed in Choosing Secure Hosts for the Administrative and Media Servers.
Oracle Secure Backup requires NDMP port 10000 for installing on your host. If this port is not available on your host, for example other applications are using this port, then the installation cannot complete successfully. Therefore, Oracle Secure Backup provides an option to manually specify the NDMP Port for installation.

For more information, see Table 4-2.

Obtain the Oracle Secure Backup software distribution and store it in a secure directory that all hosts can access.

Secure Location Check

The installation process checks whether the directory has the correct privileges. For the installation to complete successfully, the secure directory must have the owner and group privileges as indicated in Table 4-1. However, you can disable the secure location check using the following command:

setup --securepath

Note:

Use this option only after you confirm that the installation location is fully protected.

Table 4-1 Secure Directory Owner and Group Privileges

Platform	Required Owner and Group
Linux	`root:root`
Solaris SPARC	`root:root` or `root:sys`
Solarix X86	`root:root` or `root:sys`
IBM AIX	`root:system` or `bin:bin`
HPUX	`root:root` or `bin:bin`

Note:

Oracle recommends that you store the Oracle Secure Backup software package on a network accessible share or in a local temporary directory.

For example, if you store the software package in an NFS shared path /net/myfiler/export/vol0/home/osb_media_dir/OSB-OS-package, then you can run the install utility setup on all hosts in your network that have access to this location. This not only prevents duplicate copies of the software package but also saves space on your network.

Options for Installing on Linux or UNIX

For installing Oracle Secure Backup on Linux or UNIX, you can use the following parameters.

Table 4-2 Installation Parameters for Linux or UNIX

Parameter	Description	Required for Unattended Installation
`--addinghostid hostname`	Specifies the adding host ID.	Yes, if `--noaddinghostid` is not specified
`--install_role Client`	Disables user prompts for advanced settings and automatically selects the client host role.	Yes
`--noaddinghostid`	Disables administrative host identification check while adding a client to the administrative domain.	Yes, if `--addinghostid hostname` is not spedified
`--securepath`	Disables secure directory check for the installation location. Use this option only after you confirm that the installation location is fully protected.	No
`-t path-to-alternate-temp-directory`	Specifies an alternative install temp directory, if the default temp directory (`/usr/tmp`) is not available or has insufficient space.	No
`--ndmp_port`	Specifies the port used by Oracle Secure Backup for NDMP communication.	Yes, if the default port 10000 is not available
`--disable_web_tool`	Installs the Oracle Secure Backup administrative server with the web server disabled.	No

Interactive Installation on Linux or UNIX

Follow these steps to perform an interactive installation of Oracle Secure Backup on Linux or UNIX operating system.

Log in to your host as root.
Open a terminal window and go to the Oracle Secure Backup home directory, $OSB_HOME, where the software package is stored.

Oracle recommends that you use the standard install location /usr/local/oracle/backup as the home directory. However, you can specify a different directory for the installation. The setup utility prompts you to confirm the nonstandard location.

If the Oracle Secure Backup software package is stored in a different directory, for example /net/myfiler/export/vol0/home/osb_media_dir/OSB-OS-package, and you want to install in the $OSB_HOME location, then you can do this. Create the $OSB_HOME directory if it does not exist, go to the $OSB_HOME directory, and enter the full path of the setup utility for the version of Oracle Secure Backup.
```
# mkdir -p /usr/local/oracle/backup
# cd /usr/local/oracle/backup
# /net/myfiler/export/vol0/home/osb_media_dir/OSB-OS-package/setup
```
The setup utility uses as a default temporary directory, /usr/tmp, for the installation. If this directory is not available or has insufficient space, then you can specify an alternate location for the temporary directory using the -t option.
```
# /net/myfiler/export/vol0/home/osb_media_dir/OSB-OS-package/setup -t path-to-alternate-temp-directory
```
To install Oracle Secure Backup on another NDMP Port if the default port 10000 is not available, run the setup utility with the option --ndmp_port.
```
# /net/myfiler/export/vol0/home/osb_media_dir/OSB-OS-package/setup --ndmp_port 12345
```
To install the Oracle Secure Backup administrative server with the web server disabled, run the setup utility with the option --disable_web_tool.
```
# /net/myfiler/export/vol0/home/osb_media_dir/OSB-OS-package/setup --disable_web_tool
```
Run the setup utility to start the installation process.

The window displays details about the installation, such as the Oracle Secure Backup version, platform details, and progress information of the packages.

Note:

The setup utility, if interrupted, may generate some files, namely OBnnnn or OBnnnn.Z, in the temporary directory. It is safe to delete these temporary files.
Specify the host role from the following options:
- A: to install the administrative server and client. For detailed information, see Installing Administrative Server on Linux or UNIX
- B: to install only client role. For detailed information, see Installing Client Role on Linux or UNIX
For both options, the setup utility installs the media server packages on the host. An administrative user can add the media server role to clients while configuring the administrative domain.
Note:
- Although the software required for a media server is installed, the host does not have the media server role until the admin user grants that role with the chhost command after Oracle Secure Backup is installed.
- To add the media server role to an administrative server or client after initial installation, you must use the chdev command with the --addrole option.

The setup utility completes the installation and displays a confirmation message: Oracle Secure Backup was installed.

The installation generates a log file, namely osb_install.log, and stores it in either the default temporary directory, /usr/tmp, or a user-specified temporary directory.

Similarly, you can install Oracle Secure Backup in silent mode on your Linux or UNIX host. For more information, see Noninteractive or Unattended Installation on Linux or UNIX.

Note:

For installing in an Oracle Real Application Clusters (Oracle RAC) environment, install Oracle Secure Backup on each node in the cluster.

Installing Administrative Server on Linux or UNIX

While running the Oracle Secure Backup setup utility on a Linux or UNIX host, you can install the administrative server.

Specify the host role in the setup utility. Select Option A to install the host as the administrative server.
Specify an e-mail address for the administrative user, if you want to receive notifications about jobs, operations, status, and so on from the administrative server. Leave this blank if you do not want to receive notifications.
Select whether you want to customize configuration parameters for the installation.
- Enter y to configure the parameters.
  
  See Also:
  
  Overview of Customizing Configuration Parameters During Installation to know the configuration parameters that you can modify
  
  Specifying Advanced Settings for Linux/UNIX to understand how to modify the configuration parameters
- Enter n to use the default values.
Create a password to encrypt the Oracle Secure Backup keystore.

Important:

Ensure to note the keystore password and keep it safe. In case of a failure, you require this password to recover your administrative server.

Oracle Secure Backup stores the password in the Cloud Wallet.
Create a password for the Oracle Secure Backup administrative server.
For both, keystore password and administrative server password, Oracle recommends that you select a password of minimum eight characters with a combination of alphabetic and numeric values. You can also customize the minimum length of the password as a part of Specifying Advanced Settings for Linux/UNIX.

Now, continue the installation of Oracle Secure Backup on your Linux or UNIX host.

When you install the Oracle Secure Backup administrative server, it also installs the web server. However, while installing the administrative server Oracle Secure Backup provides an option to disable the web server using the following command:

setup --disable_web_tool

Installing Client Role on Linux or UNIX

While running the Oracle Secure Backup setup utility on a Linux or UNIX host, you can install the client role.

Specify the host role in the setup utility. Select Option B to install the client role.
Select whether you want to customize configuration parameters for the installation.
- Enter y to configure advanced settings.
  
  See Also:
  
  Specifying Advanced Settings for Linux/UNIX to learn how to modify these parameters
  
  For a client, you can modify the Oracle Secure Backup temporary directory and the option to start Oracle Secure Backup daemons when the host restarts.
- Enter n to use the default values for the parameters.
Enter the host ID of the administrative server that adds the client to its domain.
You can enter either the Fully Qualified Domain Name (FQDN) or the IP address of the administrative server. Specifying the IP address avoids connectivity failures during problems with nameservice.

The client stores the specified IP address or FQDN in /etc/obconfig file. This information is essential for authentication purpose and for establishing the initial connection between the client and the administrative server.
While installing the client, you can disable adding IP address using the following command:
```
# setup --noaddinghostid
```

Now, continue the installation of Oracle Secure Backup on your Linux or UNIX host.

Specifying Advanced Settings for Linux/UNIX

Oracle Secure Backup uses default values for most configuration parameters that are required during the installation process. This includes parameters such as the identify certificate key size, minimum length for user passwords, and so on. In most cases, the default values are sufficient. However, you can provide new values for the parameters by configuring advanced settings during the installation.

To configure advanced settings, the setup script displays a numbered list containing the parameters that can be configured. To modify a particular parameter, enter the number adjacent to that parameter and provide the required values. For example, to modify the minimum length for user passwords, type 2. The default setting is displayed in brackets beside the option name. Enter the new minimum password length that you wish to use.

Only one advanced parameter can be modified at a time. If you want to make multiple changes, you need to enter them separately.

See Also:

"Overview of Customizing Configuration Parameters During Installation" for information about the installation parameters that can be modified

Noninteractive or Unattended Installation on Linux or UNIX

Oracle Secure Backup supports noninteractive or unattended installation of client role on a Linux or UNIX host.

For Oracle Secure Backup unattended installation , the prerequisites and the installation steps are similar to interactive installation. See Prerequisites for Installing on Linux or UNIX.

For unattended installation of client role on Linux or UNIX:

Log in to your host as root.
Open a terminal window and go to the Oracle Secure Backup home directory, $OSB_HOME, where the software package is stored.
The default home directory is /usr/local/oracle/backup.
Run the setup utility with an additional parameter, --install_role Client.
```
setup --install_role Client
```
The --install_role Client parameter automatically selects the client role on your host. Using this parameter, the setup utility proceeds with the installation without providing any options for advanced settings.

Moreover, the setup utility supports additional parameters for unattended installation.
- With adding host ID: to specify an adding host ID, for example myhost.oracle.com
```
setup --install_role Client --addinghostid myhost.oracle.com
```
- Without adding host ID: to disable the secure registration feature and install Oracle Secure Backup without specifying an adding host ID
```
setup --install_role Client --noaddinghostid
```
- Specify NDMP Port: to use another NDMP Port for installation, if the default port 10000 is not available
```
setup --install_role Client --ndmp_port 12345
```

The setup utility completes the installation and displays a confirmation message: Oracle Secure Backup was installed.

Configuring Platform-Specific Media Server Devices

This section explains how to configure tape drives and libraries for Oracle Secure Backup to communicate with them. In versions 10.4.0.3 and earlier, the Oracle Secure Backup utility discoverdev worked only with NDMP filers. As of Oracle Secure Backup 12.1 the discoverdev utility works on all media server platforms (with the exception of HP-UX). In Oracle Secure Backup 12.1 and later discoverdev is the preferred method of configuring devices because it is faster and it removes the possibility of user error when variables are manually entered in mkdev.

Note:

In the past, makedev was used on all platforms in Oracle Secure Backup to generate system attach points. The current practice is to use native SGEN device drivers whenever possible (Solaris and Linux), but system attach points must still be created manually using makedev on HP-UX. Instructions for running makedev on AIX are only included in this document for situations where there might be a reason for doing it manually, but using discoverdev is the preferred procedure.

Device attach points must exist prior to running discoverdev in order for it to function correctly. Table 4-3 lists the requirements to access device attach points, for each platform.

Table 4-3 Platform-Specific Requirements for Accessing Attach Points

Platform	Requirements
Linux	`sg_map` must be operational for use by `discoverdev`
Solaris	sgen driver must be installed for use by `discoverdev`
AIX	(Optional) `makedev` can be used to manually create system attach point
HP-UX	`makedev` must be used to create attach points prior to running `mkdev` as `discoverdev` is not yet available on this platform

Note:

The Oracle Secure Backup makedev command should not be confused with obtool mkdev. makedev use is required on HP-UX and it can be used on AIX to create Oracle Secure Backup custom system attach points. makedev is not used on Solaris or Linux where Native SCSI Generic operating system based attach points are used. obtool discoverdev automates the obtool mkdev command which detects and utilizes existing attach points but discoverdev itself does not create system attach points. obtool mkdev is the manual device configuration command which utilizes attach points to configure devices for use in Oracle Secure Backup.

This section contains the following topics:

Configuring Devices on Linux Media Servers

Configuring a Linux host as an Oracle Secure Backup media server requires that the SCSI Generic driver be installed on that host. The driver enables Oracle Secure Backup to interact with tape and library devices. The host must be configured to automatically reload the driver after a restart. It is also recommended that persistent bindings be configured. By using persistent bindings, the Host Bus Adapter pairs the SCSI targets and LUNs for each device with their WWNs, thus preventing the attach points from being shuffled among devices during a reboot. Without persistent bindings, devices can become inaccessible by Oracle Secure Backup until their attach points are updated to reflect their new values. Please consult your system administrator or operating system documentation for information on how to configure persistent bindings on your Linux media server systems.

To identify the /dev/sg that corresponds to the specific tape device you are interested in, obtain the sg_map output by executing the following Linux command:

# sg_map -i -x

/dev/sg0 5 0 0 0 8 STK SL3000 4.00

/dev/sg1 5 0 0 1 8 STK SL3000 4.00

/dev/sg2 5 0 1 0 8 STK SL500 1466

/dev/sg3 5 0 3 0 1 /dev/nst2 HP Ultrium 5-SCSI I11V

/dev/sg4 5 0 4 0 1 /dev/nst3 STK T10000C 1.57

/dev/sg5 5 0 5 0 1 /dev/nst4 HP Ultrium 5-SCSI I3AS

/dev/sg6 5 0 6 0 1 /dev/nst5 HP Ultrium 5-SCSI I3AS

/dev/sg7 5 0 7 0 1 /dev/nst6 STK T10000C 1.57

Once these attach points are present on the system, Oracle Secure Backup's discoverdev will be able to use them in creating devices.

Here is an example showing the use of discoverdev to create devices:

ob> lsh
storabck06       admin,mediaserver,client          (via OB)   in service
 
ob> discoverdev -ic -h storabck06
   Device-Type   Device-Model            Serial-Number        Attachpoint
   Library       STK     SL3000           464970G+1333SY1401   storabck06:/dev/sg0
create device object storabck06_lib_1? (a, n, q, y, ?) [y]:
   Tape          HP      Ultrium 5-SCSI  HU1328WGF6           storabck06:/dev/sg3
create device object storabck06_tape_1? (a, n, q, y, ?) [y]:
   Tape          STK     T10000C HU1327WEYJ           storabck06:/dev/sg4
create device object storabck06_tape_2? (a, n, q, y, ?) [y]:
Checking each library to associate discovered drive(s) with DTE...
    Assigning DTE 1 in library storabck06_lib_1 for drive storabck06_tape_1 with serial number: HU1328WGF6
    Assigning DTE 2 in library storabck06_lib_1 for drive storabck06_tape_2 with serial number: HU1327WEYJ
ob>
 
ob> lsd -l
storabck06_lib_1:
    Device type:            library
    Model:                  STK     SL3000
    Serial number:          464970G+1333SY1401
    In service:             yes
    Debug mode:             no
    Barcode reader:         default (hardware-selected)
    Barcodes required:      no
    Auto clean:             no
    Clean interval:         (not set)
    Clean using emptiest:   no
    Ejection type:          ??
    Min writable volumes:   0
    UUID:                   9a9c2982-1b34-1032-9c3e-aad50196aa4f
    Attachment 1:
        Host:               storabck06
        Raw device:         /dev/sg0
 
storabck06_tape_1:
    Device type:            tape
    Model:                  HP      Ultrium 5-SCSI
    Serial number:          HU1328WGF6
    In service:             yes
    Automount:              yes
    Position interval:      [undetermined]
    Debug mode:             no
    Blocking factor:        (default)
    Max blocking factor:    (default)
    UUID:                   9aa59b5c-1b34-1032-9c3e-aad50196aa4f
    Attachment 1:
        Host:               storabck06
        Raw device:         /dev/sg3
 
storabck06_tape_2:
    Device type:            tape
    Model:                  STK     T10000C 
    Serial number:          HU1327WEYJ
    In service:             yes
    Automount:              yes
    Position interval:      [undetermined]
    Debug mode:             no
    Blocking factor:        (default)
    Max blocking factor:    (default)
    UUID:                   9aa59f4e-1b34-1032-9c3e-aad50196aa4f
    Attachment 1:
        Host:               storabck06
        Raw device:         /dev/sg4

Manually creating devices using `mkdev` in Linux

In Oracle Secure Backup 12.1 and later, obtool discoverdev is the preferred method of configuring devices in Linux, but in some cases it may still be necessary to create devices manually using obtool mkdev. This section explains how to run mkdev in Linux.

Oracle Secure Backup's discoverdev uses thee sg_map -i -x output as attach points. The link names themselves can be used as Oracle Secure Backup device attach points in mkdev.

# sg_map -i -x
/dev/sg0  5 0 0 0  8  STK       SL3000            4.00
/dev/sg1  5 0 0 1  8  STK       SL3000            4.00
/dev/sg2  5 0 1 0  8  STK       SL500             1466
/dev/sg3  5 0 3 0  1  /dev/nst2  HP        Ultrium 5-SCSI    I11V
/dev/sg4  5 0 4 0  1  /dev/nst3  STK       T10000C           1.57
/dev/sg5  5 0 5 0  1  /dev/nst4  HP        Ultrium 5-SCSI    I3AS
/dev/sg6  5 0 6 0  1  /dev/nst5  HP        Ultrium 5-SCSI    I3AS
/dev/sg7  5 0 7 0  1  /dev/nst6  STK       T10000C           1.57

The following example shows how this is done:

/dev/sg0 translates to a library attachment in obtool mkdev of:

# obtool mkdev --type lib --attach <hostname>:/dev/sg0 lib

/dev/scsi/sg3 translates to a drive attachment in obtool mkdev of:

# obtool mkdev --type tape --attach <hostname>:/dev/sg3 -l lib -d 1 drv

It is also possible to create links in /dev that point to the attach points. For example, if you wish to create /dev/obl<n> or /dev/obt<n> links for use as attachments in Oracle Secure Backup, you would do the following:

# ln -s /dev/sg0 /dev/obl0 for the library (the "l" stands for library)

# ln -s /dev/sg3 /dev/obt0 for the drive (the "t" stands for tape drive)

If you choose to do this, there must be a unique /dev/obl<n> or /dev/obt<n> entry where n starts at 0 and increments by 1 for each device that Oracle Secure Backup will utilize.

The same device configurations shown earlier would now look like this:

# obtool mkdev --type lib --attach <hostname>:/dev/obl0 lib

# obtool mkdev --type tape --attach <hostname>:/dev/obt0 -l lib -d 1 drv

Configuring Devices on Solaris Media Servers

You must enable the Solaris sgen driver for changer (library) and sequential (tape) devices before a host can access SCSI & Fibre Channel attached devices and be configured as an Oracle Secure Backup Media Server

To enable sgen drivers:

Enable sequential (01) and changer (01) devices by adding the following line to the /kernel/drv/sgen.conf file:

device-type-config-list="sequential","changer";

Note:

If device-type-config-list is already defined for other devices, add sequential and changer to the existing list in the sgen.conf file.
Remove any old sgen drivers by using the following commands:

rm -r /dev/scsi/changer

rm -r /dev/scsi/sequential

In the /kernel/drv/sgen.conf file, add a line for each device’s target and LUN parameters.

You can obtain these details from the output of the prtconf -Dv and dmseg commands. An example is shown below.

name="sgen" class="scsi" target=0 lun=0; name="sgen" class="scsi" target=1 lun=0; name="sgen" class="scsi" target=2 lun=0; name="sgen" class="scsi" target=3 lun=0;
.....
name="sgen" class="scsi" target=13 lun=0; name="sgen" class="scsi" target=14 lun=0; name="sgen" class="scsi" target=15 lun=0;

Run rem_drv sgen to remove any existing sgen device configuration.
Use the following command, typed all on one line, to configure the sgen drivers:

add_drv -m '* 0666 bin bin' -i '"scsiclass,01" "scsiclass,08" "scsa,01.bmpt" "scsa,08.bmpt"' sgen

To check whether the sgen attachments are created, run the following commands as the root user:

# ls -latr /dev/scsi/seq*
total 10
drwxr-xr-x 5 root sys 512 Jan 29 17:01 ..
lrwxrwxrwx 1 root sys 57 Jan 29 17:01 c1t1d0 -> ../../../devices/pci@1f,4000/scsi@3,1/sgen@1,0:sequential
lrwxrwxrwx 1 root sys 57 Jan 29 17:01 c1t2d0 -> ../../../devices/pci@1f,4000/scsi@3,1/sgen@2,0:sequential
lrwxrwxrwx 1 root sys 57 Jan 29 17:01 c1t5d0 -> ../../../devices/pci@1f,4000/scsi@3,1/sgen@5,0:sequential
drwxr-xr-x 2 root sys 512 Jan 29 17:01 .
 
# ls -latr /dev/scsi/cha*
total 8
lrwxrwxrwx 1 root sys 54 Jan 29 17:01 c1t0d0 -> ../../../devices/pci@1f,4000/scsi@3,1/sgen@0,0:changer
drwxr-xr-x 5 root sys 512 Jan 29 17:01 ..
lrwxrwxrwx 1 root sys 54 Jan 29 17:01 c1t4d0 -> ../../../devices/pci@1f,4000/scsi@3,1/sgen@4,0:changer
drwxr-xr-x 2 root sys 512 Jan 29 17:01 .

If you do not find the sgen driver entries, reboot your system using the following commands:

# touch /reconfigure

# reboot

Create devices in Solaris using the sgen drivers by running discoverdev:

ob> lsh
storabck18       admin,mediaserver,client          (via OB)   in service
ob> discoverdev -ic -h storabck18
   Device-Type   Device-Model            Serial-Number        Attachpoint
   Library       STK     SL150           464970G+1333SY1401   storabck18:/dev/scsi/changer/c2t500104F000D14F89d1
create device object storabck18_lib_1? (a, n, q, y, ?) [y]: y
   Tape          HP      Ultrium 5-SCSI  HU1328WGF6           storabck18:/dev/scsi/sequential/c2t500104F000D14F89d0
create device object storabck18_tape_1? (a, n, q, y, ?) [y]: y
   Tape          HP      Ultrium 5-SCSI  HU1327WEYJ           storabck18:/dev/scsi/sequential/c2t500104F000D14F8Cd0
create device object storabck18_tape_2? (a, n, q, y, ?) [y]: y
 
Checking each library to associate discovered drive(s) with DTE...
    Assigning DTE 1 in library storabck18_lib_1 for drive storabck18_tape_1 with serial number: HU1328WGF6
    Assigning DTE 2 in library storabck18_lib_1 for drive storabck18_tape_2 with serial number: HU1327WEYJ
ob>
 
ob> lsd -l
storabck18_lib_1:
    Device type:            library
    Model:                  STK     SL150
    Serial number:          464970G+1333SY1401
    In service:             yes
    Debug mode:             no
    Barcode reader:         default (hardware-selected)
    Barcodes required:      no
    Auto clean:             no
    Clean interval:         (not set)
    Clean using emptiest:   no
    Ejection type:          ??
    Min writable volumes:   0
    UUID:                   9a9c2982-1b34-1032-9c3e-aad50196aa4f
    Attachment 1:
        Host:               storabck18
        Raw device:         /dev/scsi/changer/c2t500104F000D14F89d1
 
storabck18_tape_1:
    Device type:            tape
    Model:                  HP      Ultrium 5-SCSI
    Serial number:          HU1328WGF6
    In service:             yes
    Automount:              yes
    Position interval:      [undetermined]
    Debug mode:             no
    Blocking factor:        (default)
    Max blocking factor:    (default)
    UUID:                   9aa59b5c-1b34-1032-9c3e-aad50196aa4f
    Attachment 1:
        Host:               storabck18
        Raw device:         /dev/scsi/sequential/c2t500104F000D14F89d0
 
storabck18_tape_2:
    Device type:            tape
    Model:                  HP      Ultrium 5-SCSI
    Serial number:          HU1327WEYJ
    In service:             yes
    Automount:              yes
    Position interval:      [undetermined]
    Debug mode:             no
    Blocking factor:        (default)
    Max blocking factor:    (default)
    UUID:                   9aa59f4e-1b34-1032-9c3e-aad50196aa4f
    Attachment 1:
        Host:               storabck18
        Raw device:         /dev/scsi/sequential/c2t500104F000D14F8Cd0
ob>

Manually creating devices using `mkdev` in Solaris

In Oracle Secure Backup 12.1 and later, obtool discoverdev is the preferred method for configuring devices on Solaris systems. However, in some cases it may be necessary to create devices manually using obtool mkdev. This section explains how to run mkdev on Solaris systems.

The entries created in the /dev/scsi/changer and /dev/scsi/sequential directories when you enable the Solaris sgen driver are used as Oracle Secure Backup device attachments. The link names themselves can be used as Oracle Secure Backup device attach points.

/dev/scsi/changer/c1t0d0 translates to a library attachment in obtool mkdev of:

# obtool mkdev --attach <hostname>:/dev/scsi/changer/c1t0d0 lib

/dev/scsi/sequential/c1t2d0 translates to a drive attachment in obtool mkdev of:

# obtool mkdev --attach <hostname>:/dev/scsi/sequential/c1t2d0 drv -d 1 -l lib

In other cases, you may prefer to create links in /dev that point to the attach points. For example, if you wish to create /dev/obl<n> or /dev/obt<n> links for use as attachments in Oracle Secure Backup, do the following:

# ln -s /dev/scsi/changer/c1t0d0 /dev/obl0 for the library (the "l" stands for library)

# ln -s /dev/scsi/sequential/c1t2d0 /dev/obt0 for the drive (the "t" stands for tape drive)

If you choose to do this, each device that Oracle Secure Backup will utilize must have its own unique name in the format /dev/obl<n> or /dev/obt<n>.

The same device configurations shown earlier would now look like this:

# obtool mkdev --attach <hostname>:/dev/obl0 lib

# obtool mkdev --attach <hostname>:/dev/obt0 drv -d 1 -l lib

Configuring Devices on AIX Media Servers

Oracle Secure Backup no longer requires that AIX attach points be pre-configured using makedev before obtool discoverdev can find and utilize them.

To configure devices on AIX:

Complete the steps in
Add the mediaserver role to the host

ob> chhost --addrole mediaserver osblp01

Run discoverdev:

ob> discoverdev -ic -h osblp01
   Device-Type   Device-Model            Serial-Number        Attachpoint
   Library       STK     SL150           464970G+1333SY1401   osblp01:/dev/obl0
create device object osblp01_lib_1? (a, n, q, y, ?) [y]: y
   Tape          HP      Ultrium 5-SCSI  HU1327WEYJ           osblp01:/dev/obt0
create device object osblp01_tape_1? (a, n, q, y, ?) [y]: y
   Tape          HP      Ultrium 5-SCSI  HU1328WGF6           osblp01:/dev/obt1
create device object osblp01_tape_2? (a, n, q, y, ?) [y]: y
 
Checking each library to associate discovered drive(s) with DTE...
    Assigning DTE 1 in library osblp01_lib_1 for drive osblp01_tape_2 with serial number: HU1328WGF6
    Assigning DTE 2 in library osblp01_lib_1 for drive osblp01_tape_1 with serial number: HU1327WEYJ
 
ob> lsd -l
osblp01_lib_1:
    Device type:            library
    Model:                  STK     SL150
    Serial number:          464970G+1333SY1401
    In service:             no
    Debug mode:             no
    Barcode reader:         default (hardware-selected)
    Barcodes required:      no
    Auto clean:             no
    Clean interval:         (not set)
    Clean using emptiest:   no
    Ejection type:          ??
    Min writable volumes:   0
    UUID:                   eed24e34-15e2-1032-bdb8-000000000000
    Attachment 1:
        Host:               osblp01
        Raw device:         /dev/obl0
 
osblp01_tape_2:
    Device type:            tape
    Model:                  HP      Ultrium 5-SCSI
    Serial number:          HU1328WGF6
    In service:             no
    Library:                osblp01_lib_1
    DTE:                    1
    Automount:              yes
    Position interval:      [undetermined]
    Debug mode:             no
    Blocking factor:        (default)
    Max blocking factor:    (default)
    Current tape:           [unknown]
    Use list:               [not set]
    Drive usage:            [not set]
    Cleaning required:      [unknown]
    UUID:                   01832346-15e3-1032-bdb8-000000000000
    Attachment 1:
        Host:               osblp01
        Raw device:         /dev/obt1
 
osblp01_tape_1:
    Device type:            tape
    Model:                  HP      Ultrium 5-SCSI
    Serial number:          HU1327WEYJ
    In service:             no
    Library:                osblp01_lib_1
    DTE:                    2
    Automount:              yes
    Position interval:      [undetermined]
    Debug mode:             no
    Blocking factor:        (default)
    Max blocking factor:    (default)
    Current tape:           [unknown]
    Use list:               [not set]
    Drive usage:            [not set]
    Cleaning required:      [unknown]
    UUID:                   0183170c-15e3-1032-bdb8-000000000000
    Attachment 1:
        Host:               osblp01
        Raw device:         /dev/obt0
ob>

Manually Creating Devices in AIX

Preconfiguration of system device attach points is not necessary for running discoverdev to configure Oracle Secure Backup devices on an AIX media server. This section explains how to create and configure attach points using obtool commands.

The standalone tool obscan can be used to assist with gathering device information for SCSI attached or Fibre Channel tape and media changer devices in a switched environment on AIX. The SCSI ID and LUN are required to create system device attach points using makedev for use by Oracle Secure Backup. The obscan utility is located in the OSB_HOME/tools directory of the Oracle Secure Backup admin server. The syntax is as follows, where dname is the device file name of the SCSI bus or Fibre Channel fabric to scan:

# obscan -f dname

# obscan -f /dev/scsi0

# obscan -f /dev/fscsi0

Note:

Note: when creating OSB attach points using makedev you will be asked to

Enter logical unit number 0-31 [0]: 0

This is the number that will be associated with the attach point name makedev creates to differentiate it from other devices. Although these values are arbitrary, It is customary to start at zero and increment by one for each library or drive attachment being created.

(see 3.3.5.0 Assigning Oracle Secure Backup Logical Unit Numbers to Devices)

In the following steps, obscan gathers information needed by makedev to create Oracle Secure Backup system attachments for devices attached to the Fibre Channel fabric identified by /dev/fscsi1:

Run obscan to identify the SCSI ID & LUN for the tape drives and media changers attached to the system:

./obscan -f /dev/fscsi1
 obscan version 18.1.0.0.0 (AIX)
 
 DEVICE information for /dev/fscsi1
 
 Connection Type = 2, Switch
 
    Target-id : 658982, Lun : 0
       Vendor   : HP          Product  : Ultrium 6-SCSI  Device type : Tape  World Wide Name : 500104F000CC6412
 
    Target-id : 658983, Lun : 0
       Vendor   : HP          Product  : Ultrium 5-SCSI  Device type : Tape  World Wide Name : 500104F000CC640F
 
    Target-id : 658983, Lun : 1
       Vendor   : STK         Product  : SL150           Device type : Library  World Wide Name : 500104F000CC640F
 
    Target-id : 659008, Lun : 0
       Vendor   : HP          Product  : Ultrium 5-SCSI  Device type : Tape World Wide Name : 500104F000D14F8C
 
    Target-id : 659009, Lun : 0
       Vendor   : HP          Product  : Ultrium 5-SCSI  Device type : Tape World Wide Name : 500104F000D14F89
 
    Target-id : 659009, Lun : 1
       Vendor   : STK         Product  : SL150           Device type : Library World Wide Name : 500104F000D14F89
Total count of Media Changers and/or Tape devices found : 6

To reconfigure all devices, remove all existing Oracle Secure Backup system attach points using rm /dev/ob*. If you wish to add devices while retaining the existing attach points, check to see which /dev/ob* attach points are present and then proceed to specify Oracle Secure Backup logical unit numbers that are not already in use.

Here is an example of running makedev to create new Oracle Secure Backup system attach points where none exist already:

# install/makedev
Enter logical unit number 0-31 [0]: 0
Enter 'd' if this device is a tape drive or 'l' if a SCSI-2 addressable  tape library [d]: l
Enter SCSI bus name [scsi0]: fscsi1
Enter SCSI target id 0-16777215 [3]: 658983
Enter SCSI logical unit number (lun) 0-7 [0]: 1
/dev/obl0 created
 
# install/makedev
Enter logical unit number 0-31 [0]: 1
Enter 'd' if this device is a tape drive or 'l' if a SCSI-2 addressable
    tape library [d]: l
Enter SCSI bus name [scsi0]: fscsi1
Enter SCSI target id 0-16777215 [2]: 659009
Enter SCSI logical unit number (lun) 0-7 [0]: 1
/dev/obl1 created
 
# install/makedev
Enter logical unit number 0-31 [0]: 0
Enter 'd' if this device is a tape drive or 'l' if a SCSI-2 addressable
    tape library [d]: d
Enter SCSI bus name [scsi0]: fscsi1
Enter SCSI target id 0-16777215 [4]: 658983
Enter SCSI logical unit number (lun) 0-7 [0]: 0
/dev/obt0 created
 
# install/makedev
Enter logical unit number 0-31 [0]: 1
Enter 'd' if this device is a tape drive or 'l' if a SCSI-2 addressable  tape library [d]: d
Enter SCSI bus name [scsi0]: fscsi1
Enter SCSI target id 0-16777215 [5]: 658982
Enter SCSI logical unit number (lun) 0-7 [0]: 0
/dev/obt1 created
 
# install/makedev
Enter logical unit number 0-31 [0]: 2
Enter 'd' if this device is a tape drive or 'l' if a SCSI-2 addressable  tape library [d]: d
Enter SCSI bus name [scsi0]: fscsi1
Enter SCSI target id 0-16777215 [3]: 659008
Enter SCSI logical unit number (lun) 0-7 [0]: 0
/dev/obt2 created
 
# install/makedev
Enter logical unit number 0-31 [0]: 3
Enter 'd' if this device is a tape drive or 'l' if a SCSI-2 addressable  tape library [d]: d
Enter SCSI bus name [scsi0]: fscsi1
Enter SCSI target id 0-16777215 [2]: 659009
Enter SCSI logical unit number (lun) 0-7 [0]: 0
/dev/obt3 created
 
# ls /dev/ob*
/dev/obl0  /dev/obl1  /dev/obt0  /dev/obt1  /dev/obt2  /dev/obt3
 
# obtool
Oracle Secure Backup 18.1.0.0.0
Warning: auto-login failed - login token has expired
login: admin
Password:
ob> lsh
osblp01          admin,mediaserver,client          (via OB)   in service
ob> lsd
ob> mkdev -t lib -a osblp01:/dev/obl1 lib
ob> mkdev -t tape -a osblp01:/dev/obt2 -d 1 -l lib drv1
ob> mkdev -t tape -a osblp01:/dev/obt3 -d 2 -l lib drv2
 
ob> mkdev -t lib -a osblp01:/dev/obl0 lib1
ob> mkdev -t tape -a osblp01:/dev/obt0 -d 1 -l lib1 drva
ob> mkdev -t tape -a osblp01:/dev/obt1 -d 2 -l lib1 drvb
ob>

Identifying and Configuring AIX Devices in a Point-to-Point or FC-AL Configuration

In a point-to-point or FC-AL configuration, no tool is provided to help you determine the SCSI ID and LUN . However, for IBM-supported devices in these configurations, you can use the lsattr command.

To identify and configure AIX devices with lsattr and makedev:

Log on as root.

You must have operating system privileges to access devices, which is often root access, to run lsattr.

Run lsattr for each SCSI and Fibre Channel adapter with tape devices to be used by Oracle Secure Backup.

The following lsattr example displays the attribute names, current values, descriptions, and user-settable flag values for the rmt0 device:

user: lsattr -El rmt0
block_size     512                BLOCK size (0=variable length)           True
delay          45                 Set delay after a FAILED command         True
density_set_1  0                  DENSITY setting #1                       True
density_set_2  0                  DENSITY setting #2                       True
extfm          yes                Use EXTENDED file marks                  True
location                          Location Label                           True
lun_id         0x1000000000000    Logical Unit Number ID                  False
mode           yes                Use DEVICE BUFFERS during writes         True
node_name      0x1000006045175222 FC Node Name                            False
res_support    no                 RESERVE/RELEASE support                  True
ret_error      no                 RETURN error on tape change or reset     True
rwtimeout      144                Set timeout for the READ or WRITE commandTrue
scsi_id        0x2                SCSI ID                                 False
var_block_size 0                  BLOCK SIZE for variable length support   True
ww_name        0x2001006045175222 FC World Wide Name                      False

You can convert the hexadecimal values of lun_id and scsi_id (shown in bold) to decimal so that they are usable by the Oracle Secure Backup makdev command. After conversion, the SCSI LUN ID is 281474976710656 and the SCSI ID is 2.

Navigate to the install directory in your Oracle Secure Backup home. For example:
```
# cd /usr/local/oracle/backup/install
```
Enter the makedev command at the shell prompt:
```
# makedev
```
At the prompts, enter the information required to create attach points used within Oracle Secure Backup to identify devices for backup and restore operations.

The makedev script creates the attach point, displaying messages indicating its progress.

Configuring Devices on HP-UX Media Servers

To access SCSI or Fibre Channel tape devices on HP-UX using the makedev script, Oracle Secure Backup requires the following identifying information about how the devices are attached to their hosts:

SCSI bus number instance
Target ID
LUN

To gather device information in HP-UX, you can use the ioscan utility located in /usr/sbin on the HP-UX operating system. The ioscan command searches the system and lists any devices that it finds. You must have root access to run ioscan.

Note:

The ioscan tool, which may be included as part of the HP-UX operating system, is an optional tool for device identification.

To identify and configure HP-UX devices:

Log on as root.
Execute the following command:
```
/usr/sbin/ioscan -f
```
Running the command with the -f option displays full information about the system configuration including device class, instance number, device or interface driver, software state, and hardware type.

Example 4-1 shows sample output for ioscan -f. The bus number instance, target ID, SCSI LUN, and device description for each device are shown in bold.

Using the ioscan output, make a note of the bus number, target ID, and SCSI LUN for the tape devices.

Table 4-4 shows the relevant information from Example 4-1.

Table 4-4 Information Required by makedev

Device	Type	Name	Bus Number Instance	Target ID	SCSI LUN
Tape library (autoch)	SCSI	ADIC FastStor 2	3	1	0
Tape drive (tape)	SCSI	HP Ultrium 2	3	2	0
Tape library (autoch)	FC	ADIC Scalar 24	9	3	0
Tape drive (tape)	FC	IBM ULTRIUM-TD3	9	3	1
Tape drive (tape)	FC	IBM ULTRIUM-TD3	9	3	2

Use makedev to create attach points so that Oracle Secure Backup can identify devices for backup and restore operations.

The following example runs makedev using the information in Table 4-4. The example creates the attach point /dev/obl/8 for the ADIC FastStor 2 library on SCSI bus instance 3 with the target ID 1 and SCSI LUN 0.

% makedev 
Enter logical unit number 0-31 [0]: 8
Enter 'd' if this device is a tape drive or 'l' if a SCSI-2 addressable
    tape library [d]: l
Enter SCSI bus instance: 3
Enter SCSI target id 0-16777215: 1
Enter SCSI logical unit number (lun) 0-7 [0]: 0
/dev/obl/8 created

The following example runs makedev using the information in Table 4-4. The example creates the attach point /dev/obt/9m for the HP Ultrium 2 tape drive on SCSI bus instance 3 with the target ID 2 and SCSI LUN 0.

% makedev 
Enter logical unit number 0-31 [0]: 9
Enter 'd' if this device is a tape drive or 'l' if a SCSI-2 addressable
    tape library [d]: d
Enter SCSI bus instance: 3
Enter SCSI target id 0-16777215: 2
Enter SCSI logical unit number (lun) 0-7 [0]: 0
/dev/obt/9m created

Example 4-1 ioscan -f

$ /usr/sbin/ioscan -f
 
Class      I  H/W Path                 Driver   S/W State  H/W Type   Description
...
ext_bus    3  0/1/1/1                  mpt      CLAIMED    INTERFACE  SCSI Ultra320
target    11  0/1/1/1.1                tgt      CLAIMED    DEVICE
autoch     4  0/1/1/1.1.0              schgr    CLAIMED    DEVICE     ADIC FastStor 2
target    10  0/1/1/1.2                tgt      CLAIMED    DEVICE
tape       8  0/1/1/1.2.0              stape    CLAIMED    DEVICE     HP  Ultrium 2-SCSI
...
fcp        2  0/2/1/0.99               fcp      CLAIMED    INTERFACE  FCP Domain
ext_bus    9  0/2/1/0.99.15.255.1     fcpdev   CLAIMED    INTERFACE  FCP Device Interface
target     1  0/2/1/0.99.15.255.1.3    tgt      CLAIMED    DEVICE
autoch     8  0/2/1/0.99.15.255.1.3.0  schgr    CLAIMED    DEVICE     ADIC Scalar 24
tape      19  0/2/1/0.99.15.255.1.3.1  stape    CLAIMED    DEVICE     IBM ULTRIUM-TD3
tape      20  0/2/1/0.99.15.255.1.3.2  stape    CLAIMED    DEVICE     IBM ULTRIUM-TD3

Assigning Oracle Secure Backup Logical Unit Numbers to Devices

Each tape drive and tape library must be assigned an Oracle Secure Backup LUN during the configuration process. This number is used to generate unique device names during device configuration. Oracle Secure Backup logical unit numbers are assigned as needed automatically on Windows. For each UNIX or Linux media server, however, you must select Oracle Secure Backup logical unit numbers for each device as part of planning your administrative domain.

There is no required order for assigning Oracle Secure Backup logical unit numbers. They are typically assigned sequentially, starting at 0, for each tape device of a given type, whether tape library or tape drive. That is, tape libraries are typically numbered 0, 1, 2 and so on, and tape drives are also numbered 0, 1, 2 and so on. The maximum value for an Oracle Secure Backup logical unit number is 31.

On Linux or UNIX, the resulting device special file names for tape libraries are /dev/obl1, /dev/obl2, /dev/obl3 and so on, and the names for tape drives are /dev/obt1, /dev/obt2, /dev/obt3 and so on. On Windows, the resulting tape library names are //./obl1, //./obl2, //./obl3 and so on, and the names for tape drives are //./obt1, //./obt2, //./obt3 and so on, where these names are assigned automatically during the installation of Oracle Secure Backup on Windows.

Note:

The Oracle Secure Backup logical unit number should not be confused with the SCSI LUN. The latter is part of the hardware address of the tape device, while the Oracle Secure Backup logical unit number is part of the device special filename.

Additional Information for Installation of Oracle Secure Backup on Linux

For each Linux media server, ensure that the SCSI Generic (SG) driver is installed. This driver is required for Oracle Secure Backup to interact with a tape device.

Kernel modules are usually loaded directly by the facility that requires them, if the correct settings are present in the /etc/modprobe.conf file. However, it is sometimes necessary to explicitly force the loading of a module at start time.

For example, on RedHat Enterprise Linux, the module for the SCSI Generic driver is named sg. Red Hat Enterprise Linux checks at start time for the existence of the /etc/rc.modules file, which contains various commands to load modules.

Note:

The rc.modules file is necessary, and not rc.local, because rc.modules runs earlier in the start process.

On RedHat Enterprise Linux, you can use the following commands to add the sg module to the list of modules configured to load as root at start time:

# echo modprobe sg >> /etc/rc.modules
# chmod +x /etc/rc.modules

An Oracle Secure Backup user must be mapped to a Linux or UNIX user that has read/write permissions to the /dev/sg devices. One way to accomplish this goal is to set the permissions to 666 for the /dev/sg devices.

Linux Media Server System Requirement: SCSI Generic Driver

Configuring a Linux host for the Oracle Secure Backup media server role requires that the SCSI Generic driver be installed on that host. This driver is required for Oracle Secure Backup to interact with a tape device. The host must also be configured to automatically reload the driver after a restart.

Installing Oracle Secure Backup on AIX

The steps for installing and uninstalling Oracle Secure Backup on AIX is similar to a Linux or UNIX host.

To successfully install Oracle Secure Backup on AIX, ensure that the Input/Output Completion Port (IOCP) is configured on your system. To configure IOCP, complete the steps explained in Configuring IOCP on AIX Systems.

You can install Oracle Secure Backup 18.1 and earlier versions on AIX hosts up to version 7.1. If you are installing Oracle Secure Backup from a C shell and the installation stops responding, then do a /bin/sh before running the setup. If the installation still does not respond, then run this command:

/net/myfiler/export/vol0/home/osb_media_dir/OSB-OS-package/setup --securepath

During Oracle Secure Backup installation, the Oracle Secure Backup admin user is mapped by default to UNIX user root and UNIX group root. In this configuration, Oracle Secure Backup requires that the user root be a member of the group root to back up the file system successfully. AIX does not define a group root by default. If the group root does not exist on your AIX system, then you must create it and make user root a member of it.

Note:

You can change this mapping of the Oracle Secure Backup admin after installation.

See Also:

Configuring IOCP on AIX Systems

It is mandatory to enable IOCP on your AIX systems to be able to perform Oracle Secure Backup operations successfully.

To configure IOCP:

Run the lslpp command to ensure that IOCP module was installed on your system during the database install.

$ lslpp -l bos.iocp.rte

The output should look similar to this:

Fileset                     Level     State       Description
----------------------------------------------------------------------------
Path: /usr/lib/objrepos
  bos.iocp.rte              5.3.9.0   APPLIED     I/O Completion Ports API
 
Path: /etc/objrepos
  bos.iocp.rte              5.3.0.50  COMMITTED   I/O Completion Ports API

Run the lsdev command to check the status of the IOCP port.
```
$ lsdev -Cc iocp
```
The required IOCP port status is Available.

If the IOCP port status is Defined, change this to Available by completing the following steps:
1. Log on as root.
2. Run the following command:
```
# smitty iocp
```
3. Select Change/Show characteristics of the I/O Completion Ports.
4. Change the configured state from Defined to Available.
5. Restart the system for this change to reflect.

Prerequisites for Installing on Linux or UNIX

Options for Installing on Linux or UNIX

Interactive Installation on Linux or UNIX

Installing Administrative Server on Linux or UNIX

Installing Client Role on Linux or UNIX

Specifying Advanced Settings for Linux/UNIX

Noninteractive or Unattended Installation on Linux or UNIX

Configuring Platform-Specific Media Server Devices

Configuring Devices on Linux Media Servers

Manually creating devices using mkdev in Linux

Configuring Devices on Solaris Media Servers

Manually creating devices using mkdev in Solaris

Configuring Devices on AIX Media Servers

Manually Creating Devices in AIX

Identifying and Configuring AIX Devices in a Point-to-Point or FC-AL Configuration

Configuring Devices on HP-UX Media Servers

Assigning Oracle Secure Backup Logical Unit Numbers to Devices

Additional Information for Installation of Oracle Secure Backup on Linux

Linux Media Server System Requirement: SCSI Generic Driver

Installing Oracle Secure Backup on AIX

Configuring IOCP on AIX Systems

Manually creating devices using `mkdev` in Linux

Manually creating devices using `mkdev` in Solaris