This chapter explains how to install Oracle Secure Backup on hosts running Linux or UNIX.
This chapter contains the following sections:
Overview of Oracle Secure Backup Linux and UNIX Installation
Prerequisites for Installing Oracle Secure Backup on Linux and UNIX
Extracting Oracle Secure Backup from OTN Download on Linux or UNIX
Loading Oracle Secure Backup Software on Linux or UNIX Using setup Script
Configuring Installation Parameters in the obparameters File
Installing Oracle Secure Backup on Linux or UNIX with installob
There are three steps to installing Oracle Secure Backup on a Linux or UNIX host:
Loading
Files required for installing Oracle Secure Backup are staged on the administrative server, in a directory called the Oracle Secure Backup home. This step is performed by a script named setup
.
Installing
Oracle Secure Backup executables are deployed correctly for use on the host. This step is performed by a script named installob
.
Note:
On a Solaris media server,installob
also performs some tape device configuration tasks, including installation of a required device driver, and, optionally, attach point creation required for Oracle Secure Backup to access tape devices.Creating attach points on each media server
This step is required for the Oracle Secure Backup device driver to access tape devices. You need the SCSI device parameters to perform this task.
The prerequisites for installing Oracle Secure Backup on Linux and UNIX operating systems are:
Each host must have a network connection with a static IP address and run TCP/IP.
The uncompress
utility must be installed on your system.
Note:
If the uncompress utility is not installed on your system, then you can create anuncompress
symbolic link pointing to the gunzip utility with the following command:
ln -s /bin/gunzip uncompress
You must have the SCSI parameters for each tape drive and tape library attached to your Linux or UNIX media server. You can find them using the procedures in Appendix C, "Determining Linux SCSI Parameters". You need this information when creating an attach point for each tape device.
On a Redhat Linux system, ensure that you install the sg3_utils
and the sg3_utils-libs
RPM packages. These packages are required for successfully running the sg_map
command.
You must be able to log in to each host with root
privileges to perform the installation.
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:
Therc.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.
Oracle Secure Backup supports both SCSI and Fibre Channel devices for Linux and UNIX. To configure a media server to communicate with its attached tape devices, you must have the SCSI parameters for each tape device.
Table 2-1 lists the required SCSI parameters for each platform.
Table 2-1 Required SCSI Parameters
Platform | Linux | HP-UX | AIX |
---|---|---|---|
Host bus adapter |
x |
x |
|
SCSI bus addressFoot 1 |
x |
x |
|
SCSI bus name-instance |
x |
x |
x |
Target ID |
x |
x |
x |
SCSI LUN |
x |
x |
x |
Footnote 1 In Linux, SCSI bus addresses are referred to as channels.
You must also assign each tape drive and tape library an Oracle Secure Backup logical unit number, as described in "Assigning Oracle Secure Backup Logical Unit Numbers to Devices".
Note:
Do not confuse the SCSI LUN with the Oracle Secure Backup LUN. The SCSI LUN 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.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.This section explains how to download the Oracle Secure Backup software.
To download and extract the Oracle Secure Backup installation software:
Log in to your host as a user with root
privileges.
Create a directory called osbdownload
on a file system with enough free space to hold the downloaded installation file:
mkdir /tmp/osbdownload
Open a Web browser and go to the Oracle Secure Backup Web site on Oracle Technology Network (OTN):
Click Free Download.
The Oracle Technology Network Developer License Terms page appears.
Read Export Controls on the Programs and select the Yes, I accept... option.
Read the Oracle Technology Network Development License Agreement and click I Accept.
The Oracle Secure Backup Downloads page appears.
Select the Accept License Agreement option, and click the link for the version of Oracle Secure Backup release 10.3 specific to your operating system.
Note:
If you have multiple operating systems in your environment, then you must perform multiple downloads of the Oracle Secure Backup release 10.3 software.Save the Oracle Secure Backup release 10.3 installation software to a temporary directory.
Expand the compressed installation software to the osbdownload
directory you created in step 2.
You now have all of the files required to install Oracle Secure Backup release 10.3.
Perform the following actions before installing Oracle Secure Backup:
Select hosts for the administrative server, media server, and client roles, as described in "Installation and Configuration Overview".
Collect the SCSI parameters for each tape drive and tape library attached to your Linux and UNIX media servers. You need this information when creating an attach point for each tape device.
Disable any system software that scans and opens arbitrary SCSI targets before adding Oracle Secure Backup tape devices to an administrative domain. If Oracle Secure Backup must contend with other system software (such as monitoring software) for access to tape libraries and drives, then unexpected behavior can result.
If you are installing Oracle Secure Backup in an Oracle RAC environment, then you must install Oracle Secure Backup on each node in the cluster.
You must create an Oracle Secure Backup home. The Oracle Secure Backup setup
program uses this directory to store installation files specific to your host.
Note:
Oracle recommends that you use/usr/local/oracle/backup
as your Oracle Secure Backup home. If you use a different directory, then the setup program prompts you to confirm your selected directory.Note:
To enable users other thanroot
to use obtool
or the Oracle Secure Backup Web tool, install Oracle Secure Backup to a file system that can use the suid
mechanism. You can do this by excluding the nosuid
option from the /etc/fstab
file entry for that file system.See also:
"Oracle Secure Backup Home Directory" and Oracle Secure Backup Administrator's Guide for more details about the Oracle Secure Backup home.To create the Oracle Secure Backup home:
Log into the host as root
.
Run the following command:
# mkdir -p /usr/local/oracle/backup
The setup script performs the loading process, in which packages of files required to install Oracle Secure Backup are extracted from the installation media and staged in the Oracle Secure Backup home for later use by the installob
installation script.
To load Oracle Secure Backup into an Oracle Secure Backup home directory for later installation on one or more Linux or UNIX platforms:
Log into your Linux or UNIX operating system as root
.
Change to the Oracle Secure Backup home directory created in "Creating the Oracle Secure Backup Home". For example:
# cd /usr/local/oracle/backup
Run the setup
script from your installation media or extracted archive directory. Enter the following command, where /media_dir
is the CD-ROM mount point or the directory containing the files extracted from the downloaded archive:
# /media_dir/setup
For example, if you downloaded an archive from Oracle Technology Network (OTN) and extracted the setup software to the /tmp/osbdownload/OB
directory, then you would run setup
as follows:
# /tmp/osbdownload/OB/setup
Oracle Secure Backup expands compressed files in a temporary directory during installation. To specify a directory for this expansion, you can use the -t
option to the setup
command. The following example specifies that setup
should use directory_name
for the expansion:
# /media_dir/setup -t directory_name
The setup
script displays the following messages:
A welcome message stating the Oracle Secure Backup version number and then displays progress messages
A message stating the platform
Various progress messages as it loads the package
When the script finishes, it prompts you to unmount and remove the installation CD-ROM.
Note:
At this point the loading process is complete. The files required to install Oracle Secure Backup are stored in the Oracle Secure Backup home on this host.The setup script prompts you to start the installob
script to install Oracle Secure Backup on the local host. Choose one of these options:
Enter no
to run installob
later, or if you must customize some aspect of your installation process using the obparameters
file, as described in "Configuring Installation Parameters in the obparameters File".
If you enter no, then setup
tells you how to continue installation later, and setup exits.
See Also:
"Installing Oracle Secure Backup on Linux or UNIX with installob" for instructions on startinginstallob
Enter yes
to start the installob
script. The steps for running installob
are described in "Installing Oracle Secure Backup on Linux or UNIX with installob".
Note:
If the setup script is interrupted, then some temporary files, namedOB
nnnn
or OB
nnnn
.Z
, might remain in /usr/tmp
. You can safely delete these files.The setup script creates a file called obparameters
in the install subdirectory of the Oracle Secure Backup home. For example, if the Oracle Secure Backup home is in the default location /usr/local/oracle/backup
, then the obparameters
file is located at /usr/local/oracle/backup/install/
.
During the installation process the setup script gives you the choice of accepting the default settings in the obparameters
file or customizing those settings. In most cases, it is not necessary to change the defaults in the obparameters
file. However, you should review the parameters you can control in this file as part of planning your installation, and determine whether any of them should be changed.
The obparameters
file is plain text that can be edited using any standard text editor.
Reasons to change the parameters in the obparameters
file include:
You can specify a different key size for enhanced security or performance
See Also:
"Setting the Key Size in obparameters"You can customize installation directories and symbolic links created during installation on different platforms.
If you are using Oracle Secure Backup to back up Oracle Database files to tape, then you can create an Oracle Secure Backup user named oracle
for use in RMAN backups. You can associate this user with Linux or UNIX operating system credentials by setting parameters in obparameters
.
Note:
You can also configure a preauthorized oracle
user later. Before electing to create an Oracle Secure Backup oracle
user, be aware that this choice involves a trade-off between convenience and security.
If you intend to use Oracle Secure Backup to perform one-time, RMAN-initiated, or unprivileged backup operations on Windows clients, then you must modify the Oracle Secure Backup admin
and oracle
users to assign them Windows credentials (a domain, user name and password) that are valid at the client with required privileges after you complete the Oracle Secure Backup installation. Otherwise, Oracle Secure Backup cannot perform these types of backup operations. This requirement applies regardless of the platform that acts as the administrative server.
See Also:
Oracle Secure Backup Administrator's Guide for more information about the preauthorized oracle
user and RMAN backups.
Appendix B, "Oracle Secure Backup obparameters Installation Parameters"
To install the Oracle Secure Backup software on Linux or UNIX:
Ensure that the SCSI parameters for each tape device available.
You can enter these parameters to create an attach point for each SCSI device as part of the initial installation. Solaris 10 systems have special device configuration procedures. See "Configuring the Solaris sgen Driver to Provide Oracle Secure Backup Attach Points".
Start the installob
script.
The Oracle Secure Backup setup script ends by asking to start the installation process using the installob
script. If you enter yes
to this question, then the setup script runs the installob
script for you.
Otherwise, start installob
from the command prompt. While logged in as root
, go to the Oracle Secure Backup home and enter the following command:
install/installob
The installob
script displays a welcome message and tells you that most of its questions have default answers, which you can select by simply pressing Enter.
Confirm the settings in the obparameters
file.
This step depends upon the value of the customized
obparameters
parameter in the obparameters
file described in "Configuring Installation Parameters in the obparameters File". The two possibilities are:
You have edited the obparameters
file and set customized
obparameters
to yes
.
In this case, the installob
script assumes that you have made the changes you want in the obparameters
file and uses those parameters during the installation. Continue to step 4.
The customized
obparameters
parameter is set to no
, which is the default.
In this case, the installob
script asks if you have reviewed and customized the obparameters
file. Choose one of these options:
Enter yes
or press the Enter key to indicate that you do not want to customize the obparameters
file. Continue to step 4.
Enter no
to indicate that you do want to customize the obparameters
file. The installob
script tells you to rerun the script after reviewing obparameters
. The installob
script then exits.
You determined the roles for each host when planning your administrative domain. Choose one of these options:
Enter a to install the software for an administrative server.
If you choose this option, then installob
also installs the software required for the media server and client roles.
Enter b to install the software for a media server.
If you choose this option, then installob
also installs the software required for the client role.
Enter c to install the software for a client.
You can add or remove a role later with the chhost
command in obtool.
Note:
If you choose an administrative server or media server installation, then installob
installs the software necessary for the media server role. However, 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 create attach points using makedev or installob
. See Oracle Secure Backup Reference for details.
See Also:
"Installation and Configuration Overview" to learn more about the roles of administrative server, media server and client in Oracle Secure BackupThis procedure describes installation for an administrative server.
Create a password for the Oracle Secure Backup keystore.
The installob
script prompts for a password for the keystore and then prompts you to re-enter the password. Oracle recommends that you choose a password of at least 8 characters in length that contains a mixture of alphabetic and numeric characters. When you enter the password, the password is not echoed to the display.
Create a password for the Oracle Secure Backup administrative server.
The installob
script asks for a password for the admin
user, and then asks you to reenter it for confirmation. Oracle recommends that you choose a password of at least 8 characters in length, containing a mixture of alphabetic and numeric characters. When you type in the password, your entry is not echoed to the display.
The minimum password length is determined by the minuserpasswordlen
security policy. Its default value is 0, which means a null password is permitted. You can change the value of minuserpasswordlen
by setting the minimum
user
password
length
parameter in the obparameters
file.
See Also:
Oracle Secure Backup Reference for more information on the minuserpasswordlen security policyNote:
The practice of supplying a password in clear text on a command line or in a command script is not recommended by Oracle. It is a security vulnerability. The recommended procedure is to have the user be prompted for the password.Enter an e-mail address for notifications.
The installob
script asks for an e-mail address to which Oracle Secure Backup sends notifications.
Note:
The default from address for e-mails generated by Oracle Secure Backup isroot@
fqdn
, where fqdn
is the fully qualified domain name of the Oracle Secure Backup administrative server. You can change this default from address after installation. See Oracle Secure Backup Reference for more information.The installob
script now displays informational messages as it installs and configures the Oracle Secure Backup software on this host. This process might take several minutes to complete.
If you are installing Oracle Secure Backup on an administrative server or media server, then the installob
script asks to configure a tape drive or tape library.
Note:
Ininstallob
, the term configuring refers to creating the attach points required for Oracle Secure Backup to communicate with the tape devices. Do not confuse this step with configuring the administrative domain with information about tape devices and media servers, as described in Chapter 5, "Configuring and Managing the Administrative Domain".The installob
script includes software required for both the administrative server and media server roles in an administrative server installation. Therefore, this prompt is displayed when installing on an administrative server even if there are no attached tape drives or tape libraries.
Although this procedure discusses SCSI tape libraries and tape drives, it also applies to a Fibre Channel tape device.
Choose from these options:
Enter no
if you do not want to create attach points for your tape devices now, or if you are installing on an administrative server with no tape devices attached.
Note:
On Linux and Solaris systems Oracle recommends that you enterno
when asked to configure tape libraries or drives during installation.
On Linux, the recommended method is to use the /dev/sg
devices for attach points, as described in "Identifying and Configuring Linux Attach Points". For Solaris systems, see "Configuring the Solaris sgen Driver to Provide Oracle Secure Backup Attach Points".
If you choose to create attach points later, or if you add a tape device to a media server in the future, then see "Creating Attach Points with makedev" for two alternative methods of completing this task.
Enter yes
to configure tape devices now.
To create attach points, the installob
script asks if tape libraries are connected to this host, and if so, what the SCSI parameters are for each tape library. After you have entered the tape library SCSI parameters, the installob
script asks you to confirm your entries.
When you have entered information about tape libraries attached to this host, the installob
script asks the same questions about standalone tape drives.
Table 2-2 lists the information required by installob
for each platform. For the device type, enter a d
for a tape drive or l
(lowercase L
) for a tape library.
Table 2-2 Information Required by installob
Platform | Linux | HP-UX | Solaris | AIX |
---|---|---|---|---|
Oracle Secure Backup LUNFoot 1 |
x |
x |
x |
x |
Device type |
x |
x |
x |
x |
Host bus adapter |
x |
x |
||
SCSI bus addressFoot 2 |
x |
x |
||
SCSI bus name-instance |
x |
x |
x |
x |
Target ID |
x |
x |
x |
x |
SCSI LUN |
x |
x |
x |
x |
Footnote 1 Do not confuse the Oracle Secure Backup logical unit number with the SCSI LUN.
Footnote 2 In Linux, SCSI bus addresses are referred to as channels.
Enter each parameter value in response to the prompts from the installob
script. You can press Enter to accept a default value, but the default SCSI parameters offered by the script might not be correct.
When you have entered the SCSI parameters for all tape libraries and tape drives attached to this host, the installob
script begins device driver configuration and device special file creation.
Record the name of the device special file created for each tape device. The filename is needed when you configure the attachment for the tape device, as part of configuring the Oracle Secure Backup domain. The filename should be /dev/obt
n
for tape drives, and /dev/obl
n
for tape libraries, where n is the Oracle Secure Backup LUN you entered for the tape device.
If you enter the wrong parameters, then device special file creation fails. To resolve the resulting errors, run installob
again, entering the correct values, or use the makedev
script described in "Creating Attach Points with makedev".
When the installob
script has created attach points for all tape devices attached to this host, it reminds you that you must configure these tape devices through the Oracle Secure Backup Web interface or the command line using the mkdev
command in obtool
.
The installob
script displays a summary of installation activities during this session and exits. This installation summary does not include any information about device special file creation performed during the installob
session.
The installation and uninstallation procedures for AIX and Linux/UNIX are identical.
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 Backupadmin
after installation.The installation and uninstallation procedures for HP-UX and Linux/UNIX are identical.
The makedev
script in Oracle Secure Backup is used to create an attach point for a single tape drive. Internally, the installob
script calls makedev
once for each tape device specified during installation. Alternatively, you can run makedev
outside of installob
to create all required attach points.
The makedev
script can also replace an old attach point, rather than creating a new one. If you reuse an Oracle Secure Backup LUN for a tape library or drive, then the attach point for the old tape device is overwritten.
If you must create attach points for several tape devices, then it may be more convenient to use the installob
script.
Table 2-3 lists the information required by makedev for each platform. For the device type, enter a d
for a tape drive or l
(lowercase L
) for a tape library.
Table 2-3 Information Required by makedev
Platform | Linux | HP-UX | AIX |
---|---|---|---|
Oracle Secure Backup LUNFoot 1 |
x |
x |
x |
Device type |
x |
x |
x |
Host bus adapter |
x |
x |
|
SCSI bus address |
x |
x |
|
SCSI bus name-instance |
x |
x |
x |
Target ID |
x |
x |
x |
SCSI LUN |
x |
x |
x |
Footnote 1 Do not confuse the Oracle Secure Backup logical unit number with the SCSI LUN.
To access SCSI or Fibre Channel tape devices, Oracle Secure Backup requires the following identifying information about how the devices are attached to their hosts:
SCSI bus name
Target ID
LUN
This information may not be readily available for all attached devices using standard operating system commands.
If you use Fibre Channel tape and media changer devices in a switched environment on AIX, you can use the standalone tool obscan
to assist with gathering device information. The SCSI ID and LUN are required to correctly configure the devices for use by Oracle Secure Backup.
The obscan
tool is provided as an optional tool for device identification in AIX environments. The obscan
executable is located in the cdtools
directory of the Oracle Secure Backup CD or CD image. The syntax is as follows, where dname
is the device file name of the SCSI bus or Fibre Channel fabric to scan:
obscan dname
The obscan
tool determines the SCSI ID and LUN for every tape and media changer device in a switched configuration.
To identify and configure AIX devices with obscan and makedev:
Log on as root
.
You must have operating system privileges to access devices, which is often root access, to run obscan
.
Run obscan
for each SCSI and Fibre Channel adapter with tape devices to be used by Oracle Secure Backup.
In the following example, obscan
gathers information about the tape devices connected to the SCSI bus identified by the device file /dev/scsi2
:
obscan /dev/scsi2 obscan version 10.2.0.3 (AIX) Copyright (c) 2008, Oracle. All rights reserved. DEVICE information for /dev/scsi2 Target-id : 0, Lun : 0 Vendor : ADIC Product : FastStor 2 Target-id : 5, Lun : 0 Vendor : HP Product : Ultrium 2-SCSI Total count of Media Changers and/or Tape devices found : 2
In this second example, obscan
gathers information about the tape devices connected to the Fibre Channel fabric identified by /dev/fssci0
:
obscan /dev/fscsi0DEVICE information for /dev/fscsi0 Target-id : 6423827, Lun : 0 Vendor : ADIC Product : Scalar 24 World Wide Name : 2001006045175222 Target-id : 6423827, Lun : 1 Vendor : IBM Product : ULTRIUM-TD2 World Wide Name : 2001006045175222 Target-id : 6423827, Lun : 2 Vendor : IBM Product : ULTRIUM-TD2 World Wide Name : 2001006045175222 Target-id : 6491411, Lun : 0 Vendor : ADIC Product : Scalar i500 World Wide Name : 2400005084800672 Target-id : 6491411, Lun : 1 Vendor : IBM Product : ULTRIUM-TD3 World Wide Name : 2400005084800672 Target-id : 6491411, Lun : 2 Vendor : IBM Product : ULTRIUM-TD3 World Wide Name : 2400005084800672 Target-id : 6491411, Lun : 3 Vendor : IBM Product : ULTRIUM-TD3 World Wide Name : 2400005084800672 Target-id : 6491411, Lun : 4 Vendor : IBM Product : ULTRIUM-TD3 World Wide Name : 2400005084800672 Total count of Media Changers and/or Tape devices found : 8
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.
In the following example, the attach point /dev/obl8
is created for the ADIC FastStor 2 library attached to scsi2
having the target id 0
and 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 name: scsi2 Enter SCSI target id 0-16777215: 0 Enter SCSI logica l unit number (lun) 0-7 [0]: 0 /dev/obt8 created
In this second example, the attach point /dev/obl9
is created for the ADIC Scalar 24 library attached to fsci0
having the target id 6423827
and 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]: l Enter SCSI bus name: fscsi0 Enter SCSI target id 0-16777215: 6423827 Enter SCSI logical unit number (lun) 0-7 [0]: 0 /dev/obl9 created
The makedev
script creates the attach point, displaying messages indicating its progress.
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.
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:
Theioscan
tool is provided as an optional tool for device identification in HP-UX environments. The ioscan
tool is not included as part of any Oracle Secure Backup installation.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 2-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.
$ /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
Using the ioscan
output, make a note of the bus number, target ID, and SCSI LUN for the tape devices.
Table 2-4 shows the relevant information from Example 2-1.
Table 2-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 2-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 2-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
Oracle recommends that you use the /dev/sg
devices as attach points with Oracle Secure Backup on Linux. The use of the Oracle Secure Backup /dev/ob
devices has certain limitations that may not be acceptable in some environments. For example, the LUN cannot be greater than 7, and the SCSI bus number cannot be greater than 1. The existing method of using /dev/ob*
devices continues to work for a tape device that does not fall into the limitation category.
To identify the /dev/sg
that corresponds to the tape device you are interested in, you can use the sg_map
command.
To configure Linux attach points:
Execute the following Linux command:
sg_map -i -x
Example 2-2 shows sample output.
sg_map -i -x /dev/sg0 0 0 0 0 0 /dev/sda DELL PERC Stripe V1.0 /dev/sg1 0 0 1 0 0 /dev/sdb DELL PERC Stripe V1.0 /dev/sg2 0 0 2 0 0 /dev/sdc DELL PERC Volume V1.0 /dev/sg3 1 0 1 0 8 ADIC FastStor 2 G12r /dev/sg4 1 0 2 0 1 /dev/nst0 HP Ultrium 2-SCSI F53A /dev/sg5 2 0 0 0 1 /dev/nst1 IBM ULTRIUM-TD2 5AT0 /dev/sg6 2 0 0 1 8 ADIC Scalar 24 310A /dev/sg7 2 0 1 0 1 /dev/nst2 IBM ULTRIUM-TD2 5AT0 /dev/sg8 2 0 1 1 8 ADIC Scalar 24 310A /dev/sg9 2 0 2 0 1 /dev/nst3 IBM ULTRIUM-TD3 54K1 /dev/sg10 2 0 3 0 1 /dev/nst4 IBM ULTRIUM-TD3 54K1 /dev/sg11 2 0 3 1 8 ADIC Scalar 24 310A
Using the sg_map
output, make a note of the attach point for each tape device that you want to configure.
Table 2-5 shows a tape library and tape drive from Example 2-2.
Use the mkdev
command in obtool
to create attach points so that Oracle Secure Backup can identify devices for backup and restore operations.
The following example creates attach points for the tape library and tape drive shown in Table 2-5.
ob> mkdev -t library -o -a node1:/dev/sg3 lib1 ob> mkdev -t tape -o -a node1:/dev/sg4 -l lib1 -d 1 tape1
Prior to Oracle Secure Backup 10.3.0.3, Oracle Secure Backup provided a loadable kernel driver to control the library (changer) and tape (sequential) devices. Starting with Oracle Secure Backup 10.3.0.3, this kernel driver is removed. The standard sgen driver that is included with Solaris now provides the functionality provided by the kernel driver.
You need to enable the Solaris sgen driver for changer and sequential devices before you install Oracle Secure Backup.
Use the following steps to enable the Solaris sgen driver for sequential and changer devices:
If your host does not have a previous installation of Oracle Secure Backup, skip to Step 2.
When you enable the Solaris sgen driver on a host that already has Oracle Secure Backup installed, the attach points and device configuration will be lost. You need to first uninstall Oracle Secure Backup using the steps described in "Uninstalling Oracle Secure Backup on Linux or UNIX".
While uninstalling, it is recommended that you remove the backup
directory. You can retain that admin
directory.
Enable sequential (01) and changer (01) devices by adding the following line in the /kernel/drv/sgen.conf
file:
device-type-config-list="sequential","changer";
Note:
Ifdevice-type-config-list
is already defined for other devices, add "sequential" and "changer" to the existing list in the sgen.conf
file.Verify that there is an entry for the sgen driver in /etc/minor_perm
.
An example of an entry in this file is as follows:
"sgen * 0600 root sys"
Verify that there is an entry for the sgen driver in /etc/name_to_major
.
The following is an example of an entry in this file:
"sgen 151"
Remove the links in /dev/scsi/changer
and /dev/scsi/sequential
using the following commands:
rm -r /dev/scsi/changer rm -r /dev/scsi/sequential
Unconfigure the st driver for type 01 devices using the following command:
update_drv -d -i '"scsiclass,01"' st
Configure sgen driver for the types 01 and 08 using the following command:
add_drv -m '*0666 bin bin' -i '"scsiclass,01" "scsiclass,08" "scsa,01.bmpt" "scsa,0.8.bmpt"' sgen
After you complete the steps to enable the sgen driver, there must be entries in /etc/scsi/changer
for every library and /etc/scsi/sequential
for every tape device. If you do not find these entries, reboot your host system using the following commands:
touch /reconfigure reboot
The entries that are made in the /dev/scsi/changer
and /dev/scsi/sequential
directories when you enable the Solaris sgen driver must be used as Oracle Secure Backup targets for /dev/ob
links. These entries vary depending on the version of Solaris.
It is recommended that you create links in /dev
in the form /dev/obl
n
and /dev/obt
n
that point to the entries in /dev/scsi/changer
or /dev/scsi/sequential
. There must be a unique /dev/obl
n
or /dev/obt
n
entry for each device that Oracle Secure Backup utilizes. These entries in /dev
will be used in the obtool
mkdev
command during Oracle Secure Backup device configuration.
In preparation for an upgrade, Oracle recommends that you do the following:
Copy your $OSB_HOME/admin
directory to a secure but easily accessed location.
If you customized the obparameters
file, then save a copy of it.
Cancel all active and pending jobs.
Stop all Oracle Secure Backup daemons.
Run the setup scripts from the new CD-ROM.
During the upgrade process, the installer displays the following prompt:
Oracle Secure Backup is already installed on this machine (myhostname). Would you like to re-install it preserving current configuration data[no]?
Enter yes
to perform the upgrade installation, retaining your previous configuration.
This section explains how to uninstall Oracle Secure Backup from a Linux or UNIX host. In this procedure Oracle Secure Backup is uninstalled from the administrative server. The procedure is the same when using the administrative server to uninstall Oracle Secure Backup from other hosts.
Log on as root
to the administrative server.
Use the following command to identify processes related to Oracle Secure Backup:
# /bin/ps -ef |grep ob
Shut down processes related to Oracle Secure Backup, such as the http
processes for the Oracle Secure Backup Web tool.
The appendix "Startup and Shutdown of Oracle Secure Backup Services" in Oracle Secure Backup Reference lists operating system-specific commands for shutting down and starting Oracle Secure Backup processes on Linux and UNIX.
Alternatively, you can terminate observiced
, which stops all processes. Use the following command to end each process in the list associated with Oracle Secure Backup, where pid
is the process ID of observiced
:
kill pid
Change directory to the Oracle Secure Backup home directory. For example:
# cd /usr/local/oracle/backup
Note:
If you uninstall Oracle Secure Backup from the administrative server, then theun
installob
script removes the Oracle Secure Backup home directory at the end of the uninstall process.Run the uninstallob
script:
# ./install/uninstallob
The uninstallob
script displays a welcome message and then asks for the name of the host from which you want to remove Oracle Secure Backup.
Enter the name of a host from which you want to uninstall Oracle Secure Backup.
The uninstallob
script asks for the name of the obparameters
file used for installation.
If you created an obparameters
file in a location other than the default, then enter the correct path information. Otherwise, press the Enter key to accept the default value install/obparameters
.
The uninstallob
script asks to remove the Oracle Secure Backup home directory. Select one of the following options:
no
Select this option if you do not want to remove the Oracle Secure Backup home directory.
yes
Select this option to remove the Oracle Secure Backup home directory. All files in the home directory are deleted. The only exception is the admin
directory, which you can elect to retain by answering yes
at the next prompt.
This procedure assumes you are saving the Oracle Secure Backup home directory.
The uninstallob
script asks to save the Oracle Secure Backup admin
directory, even if you have chosen not to save the entire Oracle Secure Backup home directory. Select one of these options:
no
Select this option to remove the admin directory.
yes
Select this option to save the admin directory. If you keep the admin directory, then you can reinstall the Oracle Secure Backup software later without destroying your administrative domain.
This procedure assumes you are saving the Oracle Secure Backup admin
directory.
The uninstallob
script displays the choices you have made and asks to continue with the uninstallation on this host. Select one of the following options:
yes
If you select this option, then the uninstallob
script displays progress messages as it uninstalls Oracle Secure Backup. When it is finished, it displays the following message:
Oracle Secure Backup has been successfully removed from host_name.
no
If you select this option, then the uninstallob
script does not uninstall Oracle Secure Backup from this host.