B
Legato Storage Manager

This appendix describes how to install, update, and remove Legato Storage Manager. It includes the following:

• Requirements for Legato Storage Manager

• Pre-Installation Steps for Legato Storage Manager (LSM)

• Installing Legato Storage Manager Manually

• Updating Legato Storage Manager

• Removing Legato Storage Manager Version 5.5

• Post-Installation Steps for Legato Storage Manager

Requirements for Legato Storage Manager

Legato Storage Manager is a restricted-functionality version of Legato NetWorker, a backup product.

.

Note: If you have Legato NetWorker already installed on your system, you will not have the option of installing Legato Storage Manager. To install the version of Legato Storage Manager included with this release of Oracle8i, you must first de-install any present version of Legato NetWorker. See "Removing an Existing Legato Storage Manager Installation".

The software requirements in Table B-1 apply to a default installation of Legato Storage Manager, with no relocation of the software components.

Table B-1 Legato Storage Manager Software Requirements

Components	Default Location	Space Requirement
GUI	/usr/bin	17 MB
Daemon and utility command files	/usr/sbin	26 MB
Library files	/usr/lib	10 MB
Online client file and server indexes; media database	/nsr	100 MB
Online manual pages	/usr/share/man	1 MB
Device Drivers	/usr/kernel /etc/LGTOuscsi	0.1 MB 15 MB 169.1 MB

Pre-Installation Steps for Legato Storage Manager (LSM)

The Legato Storage Manager installation script modifies the following system files during installation:

• /etc/rpc

• /etc/syslog.conf

Make copies of the original versions of these files before you install Legato Storage Manager.

Removing an Existing Legato Storage Manager Installation

If you want to install Legato Storage Manager from the Oracle8i distribution, but Legato Storage Manager is already on your system, you must first remove the installed version.

1. Log in as the root user and shut down the Legato Storage Manager daemons:

   # nsr_shutdown
   
   

2. Use the pkgrm command to remove individual Legato Storage Manager packages, or all of the Legato Storage Manager packages at the same time.

   Caution: Some Legato Storage Manager software packages depend on each other. Remove packages only in the following order: ORCLman, ORCLserv, ORCLnode, ORCLclnt, ORCLdrvr. Do not remove any existing Legato Storage Manager index files in the /nsr directory.

   # pkgrm package_name
   
   

   where package_name is one of the following:

   Package Name	Description
   ORCLman	NetWorker Man Pages
   ORCLserv	NetWorker Server
   ORCLnode	NetWorker Storage Node
   ORCLclnt	NetWorker Client
   ORCLdrvr	NetWorker Device Drivers

Installing Legato Storage Manager Manually

You typically install Legato Storage Manager by using Oracle Universal Installer, selecting the Custom installation of Oracle8i Enterprise Edition, and selecting Legato Storage Manager.

If you do not install Legato Storage Manager using Oracle Universal Installer, you can manually install it using the following steps:

Note: If you are updating Legato Storage Manager, be sure to perform a partial removal of Legato Storage Manager using the procedure in the section "Removing Legato Storage Manager Version 5.5". Be sure not to remove any existing Legato Storage Manager files in the /nsr directory. For more information on updating, refer to the section "Updating Legato Storage Manager". Be sure no Legato Storage Manager or NetWorker software is installed on your system. If Legato software exists but is not detected by the following installation steps, both the existing Legato software and the Legato Storage Manager might not function properly.

1. From the Oracle8i Release 3 (8.1.7) CD-ROM mount point, go to the lsm directory

   $ cd lsm
   
   

2. As root user, install the Legato Storage Manager software using the following lsminst command:

   # ./lsminst cd_rom_mount_point/stage/Components/lsm
   
   

   For each prompt asking if you want to continue the installation, enter Yes.

   When prompted for a directory to use for client and server information, you can accept the default or enter another directory name. To check that the directory used has sufficient disk space, see the "Legato Storage Manager Software Requirements" table.

   When prompted for a device name, you can enter either a carriage return ([ENTER]) or a proper no-rewind, BSD-semantics tape device name. The device is used by Legato Storage Manager for backups after it has been properly configured in the Legato Storage Manager Administrator GUI.

   See Also: For details on device configuration, see Chapter 3 in the Legato Storage Manager Administrator's Guide.

   For all other prompts displayed by lsminst, press [ENTER].

3. Update the MANPATH and PATH environment variables as required. MANPATH must include /usr/share/man, the pathname of the directory where the Legato Storage Manager man pages are installed. PATH must include /usr/bin and /usr/sbin, the pathnames of the directories where the Legato Storage Manager binaries are installed.

4. For each ORACLE_HOME to be enabled for Legato Storage Manager backups, follow these steps:

   Note: If you later install another ORACLE_HOME on your system, you must follow these steps to enable Legato Storage Manager backups from that ORACLE_HOME.

   1. Log in as the oracle user.

   2. Copy stage/Components/lsm/lib/liblsm.so from the Oracle8i CD-ROM to the file $ORACLE_HOME/lib/liblsm.so:

      $ cp stage/Components/lsm/lib/liblsm.so $ORACLE_HOME/lib/liblsm.so
      
      

   3. Shut down all Oracle instances that use this ORACLE_HOME.

   4. Remove the symbolic link $ORACLE_HOME/lib/libobk.so and create a symbolic link from $ORACLE_HOME/lib/libobk.so to
      $ORACLE_HOME/lib/liblsm.so:

      $ cd $ORACLE_HOME/lib
      $ rm libobk.so
      $ ln -s liblsm.so libobk.so
      
      

   5. Restart all Oracle instances that use this ORACLE_HOME.

Updating Legato Storage Manager

To update to the latest version of Legato Storage Manager, follow these steps:

1. Perform a partial removal of Legato Storage Manager using the procedure in the section "Removing an Existing Legato Storage Manager Installation".

   Do not remove any existing Legato Storage Manager files in the /nsr directory.

2. Install the updated version of Legato Storage Manager using the procedure in the section "Installing Legato Storage Manager Manually".

Removing Legato Storage Manager Version 5.5

Note: You cannot remove Legato Storage Manager by using the Installer. Use the following steps to remove Legato Storage Manager version 5.5.

To remove Legato Storage Manager version 5.5, follow these steps:

1. For each ORACLE_HOME on your system enabled for backups:
   1. Shut down all Oracle instances that use this ORACLE_HOME.

   2. Remove $ORACLE_HOME/lib/liblsm.so and create a symbolic link from $ORACLE_HOME/lib/libobk.so to
      $ORACLE_HOME/lib/libdsbtsh8.so:

      $ cd $ORACLE_HOME/lib
      $ rm libobk.so
      $ rm liblsm.so
      $ ln -s libdsbtsh8.so libobk.so
      
      

   3. Restart all Oracle instances that use this ORACLE_HOME.

2. As root user, stop the Legato Storage Manager daemons by using the
   nsr_shutdown command:

   # nsr_shutdown
   
   

3. As root user, remove the Legato Storage Manager software by using the pkgrm command:

   # pkgrm ORCLman ORCLserv ORCLnode ORCLdrvr ORCLclnt
   
   

   Note: Be sure to remove the software packages in the exact order shown in step 3.

   For each prompt displayed by the pkgrm command, enter "Yes."

4. To remove the Legato Storage Manager index and resource configuration files, remove the /nsr directory by running the following command as root user:

   # rm -rf /nsr/* /nsr
   
   

If you remove the /nsr directory containing the index and configuration information, you will not be able to restore from the Legato Storage Manager backups. If you later re-install Legato Storage Manager or install another Legato product, you will need to rebuild the configuration.

Post-Installation Steps for Legato Storage Manager

You can install Legato Storage Manager by using the Installer and running the root.sh script as described in "Oracle8i Enterprise Edition Custom Installation". Instructions for manually installing Legato Storage Manager from the Oracle8i CD-ROM are described in "Installing Legato Storage Manager Manually".

1. After the Legato Storage Manager installation has completed, verify that all the required packages were installed:

   # pkginfo | grep -i LSM
   application ORCLclnt       LSM (Backup/Recover) Client
   system ORCLdrvr            LSM (Backup/Recover) Device Drivers
   application ORCLman        LSM (Backup/Recover) Man Pages
   application ORCLnode       LSM (Backup/Recover) Storage Node
   application ORCLserv       LSM (Backup/Recover) Server
   
   

2. Configure the driver software to provide support for Legato Storage Manager to back up data to the SCSI storage devices attached to the system.

   See Also: For more information, refer to the Legato Storage Manager Administrator's Guide.

Integrating SAP R/3 with Legato Storage Manager

To perform archive, backup, and recover operations, Legato Storage Manager provides a means to integrate SAP R/3 and Oracle8i backup and recovery. The backup and recovery is initiated from SAPDBA along with the SAP br-tools (brbackup, brarchive, and brrestore) with the Legato Storage Manager server.

On the Oracle8i software CD-ROM, the directory containing the Legato Storage Manager software has a subdirectory named SAP with the following files for SAP R/3 on Oracle:

Table B-2

File Name	Description
backint	SAP API that integrates SAP R/3 backup and recovery with third-party utilities
init.utl	Parameter file that specifies the variables used by backint during backup, recover, and archive operations
README	Text file that describes the SAP R/3 files and where to install them

SAP R/3 Files

To set up and configure Legato Storage Manager with SAP R/3 on your system, perform the following tasks:

1. With SAP R/3 already installed, install Legato Storage Manager on your system. Follow the installation instructions in "Installing Legato Storage Manager Manually".

2. Include the pathname of the directory containing the Legato Storage Manager executables (/usr/sbin) in the PATH environment variable for the oracle user.

3. Configure a client resource for the Oracle8i server in Legato Storage Manager, according to the instructions in Chapter 2 of the Legato Storage Manager Administrator's Guide, which is included on the Oracle Online Generic Documentation CD-ROM.

4. From the subdirectory named SAP in the Legato Storage Manager directory on the Oracle8i CD-ROM, copy the backint program file into the directory where the SAP br-tools reside.

5. From the subdirectory named SAP in the Legato Storage Manager directory on the Oracle8i CD-ROM, copy the file init.utl into the directory where you installed Legato Storage Manager, /usr/sbin.

6. Instruct the SAP Database Administration program to use the backint program by setting the backup_dev_type parameter in the SAP initialization file, initsid.sap. In initsid.sap, set the parameter as follows:

   backup_dev_type = util_file
   

7. Instruct the SAP Database Administration program to use the file initsid.utl for backint-specific parameters by setting the
   util_par_file parameter in the SAP initialization file, initsid.sap.

   In initsid.sap, set the parameter as follows:

   util_par_file = ?/dbs/initsid.utl
   
   

The session report, backintsid.log, is created after the first backup session using SAP R/3 integrated with Legato Storage Manager. The report, typically located in the directory /nsr/logs, is appended to after each backup, recover, or archive