EMC® NetWorker®
Module for SAP with Oracle
Release 4.2
Installation Guide
P/N 300-012-093
REV A03
EMC Corporation
Corporate Headquarters:
Hopkinton, MA 01748-9103
1-508-435-1000
www.EMC.com
Copyright © 1998 - 2012 EMC Corporation. All rights reserved.
Published January, 2012
EMC believes the information in this publication is accurate as of its publication date. The information is subject to change
without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS IS.” EMC CORPORATION MAKES NO
REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION,
AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
PURPOSE.
Use, copying, and distribution of any EMC software described in this publication requires an applicable software license.
For the most up-to-date regulatory document for your product line, go to the Technical Documentation and Advisories section
on EMC Powerlink.
For the most up-to-date listing of EMC product names, see EMC Corporation Trademarks on EMC.com.
All other trademarks used herein are the property of their respective owners.
2
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Contents
Preface
Revision History
Chapter 1
Getting Started
Required software...................................................................................................
Software descriptions.......................................................................................
Installation checklists .............................................................................................
Documents.........................................................................................................
Installation media .............................................................................................
License information..........................................................................................
Accessing the NMSAP software ...........................................................................
Access from the DVD media...........................................................................
Access from the EMC website ........................................................................
Installation roadmaps.............................................................................................
Roadmap to install or update NMSAP on a local host ...............................
Roadmap to update NMSAP remotely by push install ..............................
Roadmap to post-installation procedures.....................................................
Register NMSAP product information with the SAP SLD repository
(optional)............................................................................................................
Chapter 2
22
UNIX and Linux Installation
Installing NMSAP on AIX systems ......................................................................
Installing NMSAP on HP-UX systems ................................................................
Installing NMSAP on Linux systems...................................................................
Installing NMSAP on Solaris systems .................................................................
Enabling the RMAN utility ...................................................................................
Uninstalling NMSAP on UNIX or Linux systems .............................................
Uninstall NMSAP on AIX ...............................................................................
Uninstall NMSAP on HP-UX..........................................................................
Uninstall NMSAP on Linux ............................................................................
Uninstall NMSAP on Solaris...........................................................................
Chapter 3
14
14
16
16
16
16
17
17
18
19
19
20
21
26
27
27
28
30
31
31
32
32
33
Microsoft Windows Installation
Installing NMSAP on Microsoft Windows ......................................................... 36
Maintaining the installation on Microsoft Windows......................................... 37
Run the Setup program in maintenance mode ............................................ 37
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
3
Contents
Repair an NMSAP installation ........................................................................ 37
Uninstalling NMSAP on Microsoft Windows..................................................... 37
4
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Tables
Title
1
2
3
4
5
Page
Typical hosts and software in the NMSAP backup and recovery environment .........
Access the directory that contains the software ...............................................................
Zipped download file and correct directory for install ...................................................
Command to register the wizard........................................................................................
Commands to link and unlink the RMAN library file ....................................................
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
14
17
18
22
30
5
Tables
6
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Preface
As part of an effort to improve and enhance the performance and capabilities of its product
lines, EMC periodically releases revisions of its hardware and software. Therefore, some
functions described in this document may not be supported by all versions of the software or
hardware currently in use. For the most up-to-date information on product features, refer to
your product release notes.
If a product does not function properly or does not function as described in this document,
please contact your EMC representative.
Note: This document was accurate as of the time of publication. However, as information is
added, new versions of this document may be released to the EMC Powerlink website. Check
the Powerlink website to ensure that you are using the latest version of this document.
Purpose
Audience
This document describes how to install, update, and remove the EMC NetWorker
Module for SAP with Oracle (NMSAP) release 4.2 software.
This document is intended for system administrators who are responsible for
installing the NMSAP software and maintaining backup and recovery systems.
Readers of this document are expected to be familiar with the following topics:
◆
◆
◆
Related
documentation
SAP terminology and concepts, especially those related to Oracle database
backup and recovery
Backup and recovery procedures
Disaster recovery procedures
The following EMC publications related to the use of this product can be found at the
EMC website, http://Powerlink.EMC.com:
◆
The NetWorker Module for SAP with Oracle release 4.2 documentation set:
• Administration guide
• Installation guide
• Release notes
• Command reference guide
◆
The NetWorker documentation set:
• Administration guide
• Installation guide
• Release notes
• Command reference guide
• Disaster recovery guide
• NetWorker licensing guide
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
7
Preface
◆
Conventions used in
this document
Other EMC documentation:
• NetWorker PowerSnap Module documentation
• Software compatibility guide
• UNIX man pages
EMC uses the following conventions for special notices:
Note: A note presents information that is important, but not hazard-related.
IMPORTANT
An important notice contains information essential to software or hardware
operation.
Typographical conventions
EMC uses the following type style conventions in this document:
Normal
Used in running (nonprocedural) text for:
• Names of interface elements (such as names of windows, dialog boxes, buttons,
fields, and menus)
• Names of resources, attributes, pools, Boolean expressions, buttons, DQL
statements, keywords, clauses, environment variables, functions, utilities
• URLs, pathnames, filenames, directory names, computer names, links, groups,
service keys, file systems, notifications
Bold
Used in running (nonprocedural) text for:
• Names of commands, daemons, options, programs, processes, services,
applications, utilities, kernels, notifications, system calls, man pages
Used in procedures for:
• Names of interface elements (such as names of windows, dialog boxes, buttons,
fields, and menus)
• What user specifically selects, clicks, presses, or types
8
Italic
Used in all text (including procedures) for:
• Full titles of publications referenced in text
• Emphasis (for example, a new term)
• Variables
Courier
Used for:
• System output, such as an error message or script
• URLs, complete paths, filenames, prompts, and syntax when shown outside of
running text
Courier bold
Used for:
• Specific user input (such as commands)
Courier italic
Used in procedures for:
• Variables on command line
• User input variables
<>
Angle brackets enclose parameter or variable values supplied by the user
[]
Square brackets enclose optional values
|
Vertical bar indicates alternate selections — the bar means “or”
{}
Braces indicate content that you must specify (that is, x or y or z)
...
Ellipses indicate nonessential information omitted from the example
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Preface
Where to get help
EMC support, product, and licensing information can be obtained as follows.
Product information — For documentation, release notes, software updates, or for
information about EMC products, licensing, and service, go to the EMC Powerlink
website (registration required) at:
http://Powerlink.EMC.com
Technical support — For technical support, go to Powerlink and select Support. On
the Support page, you will see several options, including one for making a service
request. Note that to open a service request, you must have a valid support
agreement. Please contact your EMC sales representative for details about obtaining a
valid support agreement or with questions about your account.
Your comments
Your suggestions will help us continue to improve the accuracy, organization, and
overall quality of the user publications. Please send your opinion of this document to:
[email protected]
If you have issues, comments, or questions about specific information or procedures,
please include the title and, if available, the part number, the revision (for example,
A01), the page numbers, and any other details that will help us locate the subject you
are addressing.
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
9
Preface
10
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Revision History
Email your clarifications or suggestions for this document to:
[email protected]
The following table lists the revision history of this document.
Revision
Date
Description of added or changed sections
A03
January 12, 2012
Updated the following for General Availability (GA) of NMSAP 4.2:
• “Software descriptions” on page 14 - Updated reference to NMSAP services.
• “Roadmap to update NMSAP remotely by push install” on page 20 - Updated details in step 4.
A02
December 13, 2011
Updated the following for RA refresh of NMSAP 4.2:
• Table 3 on page 18 - Updated the downloaded software filenames.
• “Installing NMSAP on Linux systems” on page 27 - Updated the Linux package names.
• “Uninstall NMSAP on Linux” on page 32 - Updated the Linux uninstall commands.
A01
September 29, 2011
Initial release of this document for Restricted Availability (RA) of NMSAP 4.2.
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
11
Revision History
12
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
1
Getting Started
This chapter includes the following sections:
◆
◆
◆
◆
Required software .........................................................................................................
Installation checklists....................................................................................................
Accessing the NMSAP software .................................................................................
Installation roadmaps ...................................................................................................
Getting Started
14
16
17
19
13
Getting Started
Required software
The EMC® NetWorker® Module for SAP with Oracle (NMSAP) software is an add-on
module for the NetWorker server and client software to provide backup and recovery
services for SAP Oracle data.
Table 1 on page 14 lists the hosts and software you might need for NMSAP services.
Table 1
Typical hosts and software in the NMSAP backup and recovery environment
Host
Required software
NetWorker server
• NetWorker client
• NetWorker storage node
• NetWorker server
NetWorker storage node
• NetWorker client
• NetWorker storage node
NetWorker Management Console (NMC) server
• NetWorker client
• NMC server
Each SAP Oracle server
•
•
•
•
•
NetWorker client
Oracle database server
SAP BRTools
NMSAP
For snapshot operations, compatible NetWorker
Module for PowerSnap™ software on both the SAP
Oracle server and a separate proxy backup host
• For split-mirror backups, compatible Replication
Manager software for BRTools
Software descriptions
Review the following software descriptions to plan your installation requirements.
The EMC Information Protection Software Compatibility Guide available on the EMC
Powerlink® website provides details on operating system and software versions
required for NMSAP services.
The Support link on the EMC Powerlink website provides details on patches required
for a particular system.
The EMC NetWorker Installation Guide provides details on how to install the
NetWorker server, storage node, client, and NMC software.
NetWorker server
A supported version of the NetWorker server software (with all applicable patches)
must be installed on the NetWorker server host. The NetWorker server host is usually
a separate host, but it can also be the NMSAP host.
Specific NetWorker server versions might be required to support specific NMSAP
features, as described in the NMSAP release notes.
The NetWorker server version must be certified to work with the NetWorker client
version installed on the NMSAP host, and it must be supported on the operating
systems used.
14
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Getting Started
NMC server
A supported version of NetWorker Management Console (NMC) must be installed
on a network host to provide a user interface with the NetWorker and NMSAP
software.
NetWorker storage node
A supported version of the NetWorker storage node software (with all applicable
patches) must be installed on the host that manages the backup storage devices. The
NetWorker storage node can be installed on the same host as the NetWorker server,
on the same host as NMSAP (to support backups to a local device) or on a separate
host.
The NetWorker storage node version must be certified to work with the NetWorker
client version installed on the NMSAP host and the NetWorker server, and it must be
supported on the operating systems used.
SAP BRTools
A supported SAP BRTools version must be installed on the SAP Oracle server. The
SAP BRTools version must be certified to run on the operating system. The SAP
documentation provides details on the supported operating systems.
If NMSAP is to be installed in a non-English environment, ensure that the host
operating system supports internationalization (I18N). Also ensure that the SAP
Oracle software and BRTools software provide the required National Language
Support (NLS) or globalization support, and are configured with the required
non-ASCII character set.
NetWorker client
A supported version of the NetWorker client software (with all applicable patches)
must be installed and working on the supported SAP Oracle server host before the
NMSAP software is installed on that host.
Specific NetWorker client versions may be required to support specific NMSAP
features, as described in the NMSAP release notes.
The NetWorker client version must be certified to run on the operating system.
NMSAP
The NMSAP software must be installed on the SAP Oracle server. NMSAP software
must be installed on a supported operating system version.
For split-mirror backups, NMSAP software must also be installed on the mount host
(data mover).
PowerSnap
To enable PowerSnap snapshot backup features, the NetWorker PowerSnap Module
that is designed for the primary storage system must be installed on both of the
following hosts:
◆
NMSAP host
◆
A separate proxy client host (also called the data mover), which may be a
NetWorker storage node
The NetWorker PowerSnap Module documentation provides installation
information.
Required software
15
Getting Started
Replication Manager
To enable split-mirror backup features, EMC Replication Manager server software
must work with Replication Manager agent software installed on both the following
hosts:
◆
SAP Oracle server
◆
A separate mount host (data mover), which may be a NetWorker storage node
The EMC Replication Manager documentation provides installation information.
Installation checklists
Review the following checklists to ensure that you have the required materials for the
installation procedures.
Documents
Required information can be found the the following documents:
◆
EMC NetWorker Module for SAP with Oracle Installation Guide for the existing
version, if a previous version of NMSAP must be uninstalled before NMSAP 4.2
can be installed
◆
EMC NetWorker Module for SAP with Oracle Release 4.2 Release Notes
◆
EMC NetWorker Module for SAP with Oracle Release 4.2 Administration Guide
◆
EMC NetWorker Administration Guide for the supported NetWorker release
◆
The latest EMC Information Protection Software Compatibility Guide
Installation media
One of the following installation media is required:
◆
DVD from the EMC Information Protection and Availability Product Families
Media Kit
◆
Link to the EMC website if downloading the software
License information
Required license enablers:
◆
Evaluation enabler
◆
Enabler certificate
NMSAP has separate license enablers for UNIX, Linux, and Microsoft Windows
platforms.
Note: Without an enabler code, the software obtained from the DVD or the EMC website can
only be evaluated.
The EMC NetWorker Licensing Guide provides details on licensing.
The EMC Price Guide includes details on the licensing requirements for NetWorker
modules.
16
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Getting Started
Accessing the NMSAP software
The NMSAP software is distributed on DVD and on the EMC website, as described in
the following sections.
Access from the DVD media
The DVD is included in the EMC Information Protection and Availability Product
Families Media Kit. The kit contains the software and online documentation for
related products.
To access the NMSAP software files on a host with a local DVD drive:
1. Log in as root (UNIX or Linux systems) or system administrator (Microsoft
Windows systems) on the host.
2. Insert and mount the NetWorker Module DVD in the DVD drive:
• On UNIX or Linux systems, mount the DVD drive:
mount /dev/DVD_drivename /mount_point
• On Microsoft Windows systems, select the DVD drive in Windows Explorer.
3. Go the directory that contains the software, as shown in Table 2 on page 17.
Table 2
Access the directory that contains the software
For this platform (NMSAP bitness)
Go to this directory
AIX (32-bit)
/mount_point/sap/aix_32
HP Itanium (64-bit)
/mount_point/sap/hpux11_ia64
HP PA-RISC (64-bit)
/mount_point/sap/hpux11_64
Linux x64 (64-bit)
/mount_point/sap/linux_x86_64
Linux Itanium (64-bit)
/mount_point/sap/linux_ia64
Linux PowerPC (32-bit)
/mount_point/sap/linux_ppc64
Sun SPARC (64-bit)
/mount_point/volume_label/sap/solaris_64
Sun x64 (64-bit)
/mount_point/volume_label/sap/solaris_amd64
Windows x64 (64-bit)
DVD_drive_letter:\sap\win_x64
Windows Itanium (64-bit)
DVD_drive_letter:\sap\win_ia64
Accessing the NMSAP software
17
Getting Started
Access from the EMC website
To access the NMSAP software from the EMC website:
1. Log in as root (UNIX or Linux systems) or system administrator (Microsoft
Windows systems) on the host.
2. Create a temporary installation download directory in a local file system with
sufficient free disk space to contain both the downloaded software package and
the software installation files extracted from the package. For example:
• On UNIX or Linux systems:
mkdir /usr/nsr_extract_nmsap
• On Microsoft Windows systems:
mkdir C:\Downloads\nmsap
3. Go to Powerlink.EMC.com.
4. Select Support > Software Downloads and Licensing > Downloads J-O >
NetWorker Module.
5. In the table of NetWorker Module Software Downloads, click NetWorker Module
for SAP with Oracle 4.2 for the particular UNIX, Linux, or Windows system.
6. Download the NMSAP software package to the temporary directory you created.
7. Extract the installation files from the downloaded software package, as
appropriate for the operating system, as follows:
• On UNIX or Linux systems:
a. Uncompress the downloaded package by typing the gunzip command
with the filename.tar.gz name for the specific download filename:
gunzip filename.tar.gz
b. Extract the software from the uncompressed, tarred file:
tar -xvpBf filename.tar
The distribution software files are listed on the screen as the extraction
proceeds.
c. Remain in the directory for the installation.
• On Microsoft Windows systems:
a. Unzip the downloaded software package, as shown in Table 3 on page 18.
b. Go to the correct directory, as shown in Table 3 on page 18.
Table 3
18
Zipped download file and correct directory for install
On this platform
Unzip this downloaded file
Then go to this directory
Windows x64
nmsap42_win_x64.zip
win_x64
Windows Itanium
nmsap42_win_ia64.zip
win_ia64
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Getting Started
Installation roadmaps
To install the NMSAP software, follow the appropriate roadmap:
◆
“Roadmap to install or update NMSAP on a local host” on page 19
◆
“Roadmap to update NMSAP remotely by push install” on page 20
◆
“Roadmap to post-installation procedures” on page 21
Roadmap to install or update NMSAP on a local host
Follow these instructions to install or update the NMSAP software locally on a host,
on either of the following configurations:
◆
Single host
◆
Cluster or Oracle RAC host
Note: The NMSAP software must be installed on each node host that will perform backup
and recovery operations for the whole cluster or Oracle RAC environment.
The EMC Information Protection Software Compatibility Guide on Powerlink
provides details on supported versions and cluster environments.
1. Review the “Installation checklists” on page 16 and verify that you have the
required documentation, installation media, pathnames, and license information.
2. Ensure that NetWorker client software is installed on the host and is a version that
supports the NMSAP software version to be installed.
3. Access the NMSAP software as described in “Accessing the NMSAP software” on
page 17 and ensure that you are in the correct directory.
Note: If the installation is not started from the correct directory, the installation can fail.
4. Ensure that no backups or restores are running on the SAP Oracle server. A
supported database does not need to be shut down during the installation.
5. If an earlier version of the NMSAP software is already installed, uninstall the
earlier version according to the instructions in the installation guide for the earlier
version.
Note: Before you uninstall an earlier NMSAP version, ensure that you save a copy of the
original parameter file template (init.utl) and original configuration file template
(nsrsapsv.cfg) supplied with the NMSAP software. The template files are located in this
directory:
- Linux and UNIX: /etc
- Windows: NetWorker_install_directory\nsr\bin
When you uninstall the NMSAP software, the original template files are deleted along with
any settings you may have made in the files.
6. Start the NetWorker client service before the NMSAP installation.
Note: If the NetWorker client is not started before NMSAP installation, then automatic
registration of the NMSAP configuration wizard might not occur and the wizard might fail
to run after the installation. “Roadmap to post-installation procedures” on page 21 gives
details for manual wizard registration.
Installation roadmaps
19
Getting Started
7. Install the NMSAP software by following the instructions for the operating
system in the appropriate chapter:
• Chapter 2, “UNIX and Linux Installation”
• Chapter 3, “Microsoft Windows Installation”
After the software installation completes, a message appears on how to start the
NMSAP scheduled backup configuration wizard. The EMC NetWorker Module for
SAP with Oracle Administration Guide provides more information on the wizard.
8. Perform all the required post-installation procedures. “Roadmap to
post-installation procedures” on page 21 gives details.
Roadmap to update NMSAP remotely by push install
You can update the NMSAP software on one or more remote NMSAP hosts with the
software distribution feature (push install) from a centralized NetWorker server. Push
installation can be done with either the Software Administration Wizard or the
nsrpush command.
Note: Push installation is not supported on cluster environments.
The EMC NetWorker Installation Guide gives details on the software distribution
feature, including:
◆
Verifying software installed on NetWorker clients
◆
Performing and monitoring push installations
◆
Managing the repository of software to push install from the Networker server
Note: To add a new version of the NMSAP software to the NetWorker server repository,
follow the NetWorker installation guide instructions for the nsrpush command. For the
<Product Name> variable, type the complete name “NetWorker Module for SAP with
Oracle” with the quotation marks.
To update NMSAP software remotely by push install:
1. Review the “Installation checklists” on page 16.
2. Ensure that the following requirements are met:
• NMSAP 3.5 or later is currently installed on the remote NMSAP clients and
the client operating systems support push install. Remote update of earlier
NMSAP versions is not supported.
The EMC NetWorker Module for SAP with Oracle Release 4.2 Release Notes gives
details on operating systems that support push installation on NMSAP hosts.
• A supported version of NetWorker client is installed on the remote NMSAP
client hosts.
The EMC Information Protection Software Compatibility Guide provides details.
• NetWorker 7.5 or later server software is installed on the remote NetWorker
server hosts that serve the NetWorker clients.
• The NetWorker Console server includes administrative privileges for the user
who performs the update.
20
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Getting Started
3. Ensure that all NetWorker backups have stopped before you start any push install
updates.
Note: The software distribution program may stop and restart the NetWorker client
nsrexecd daemon during the installation.
4. On the NetWorker server, perform the push installation to update the NMSAP
clients by using either the Software Administration Wizard or the nsrpush
command.
The EMC NetWorker Installation Guide gives instructions on the different methods
of push installation by using the NetWorker sofware distribution feature.
5. Complete all the required post-installation procedures. “Roadmap to
post-installation procedures” on page 21 gives details.
Roadmap to post-installation procedures
After you have installed or updated the NMSAP software, either directly on a local
host or by remote installation (push install), complete the installation as follows:
1. Enable the NMSAP backint program. This is a required step.
Perform either of following:
• Copy the backint program from the following directory to the directory where
the SAP BRTools reside:
– On UNIX or Linux systems: /usr/sbin
– On Microsoft Windows systems: NetWorker_install_directory\nsr\bin
• For BRTools 7.10 or greater, set util_path=<full path to directory containing
backint> in the BRTools configuration file, init<DBSID>.sap.
2. If you are installing NMSAP software for the first time on the host, register and
enable the NMSAP software to work with the NetWorker software.
The EMC NetWorker Licensing Guide provides details on licensing and enabling
the software.
The EMC Price Guide includes details on the licensing requirements for
NetWorker modules.
If you are updating from a previous NMSAP release, you do not need to re-enable
the software.
3. If PowerSnap snapshot backups and restores will be performed on the host,
install and enable the required PowerSnap Module on the NMSAP host and the
data mover (proxy client) host.
The NetWorker PowerSnap Module documentation and the EMC NetWorker
Module for SAP with Oracle Administration Guide provide details.
4. If SAP split-mirror backup operations will be performed on the host, install and
enable the required Replication Manager software.
NMSAP and Replication Manager software must be installed on both the
production host and mount (backup) host.
The EMC Replication Manager documentation and the EMC NetWorker Module for
SAP with Oracle Administration Guide provide details.
Installation roadmaps
21
Getting Started
5. If automatic wizard registration did not occur during NMSAP installation and the
NMSAP configuration wizard fails to run, manually register the wizard as
follows:
a. Log in as the root user (UNIX or Linux systems) or system administrator
(Microsoft Windows systems).
b. At a command prompt, type the appropriate command, as listed in Table 4 on
page 22.
Note: To manually unregister the wizard, use the command from the table but replace
the -i option with -u.
Table 4
Command to register the wizard
System
Registration command
UNIX or Linux
nsrsapra -i
Microsoft Windows
nsrsapra.exe -i
6. If the NMSAP man pages (UNIX or Linux systems only) cannot be accessed with
the man command, modify the MANPATH environment variable to include the
pathname of the directory that contains the NMSAP man pages.
The NMSAP man pages are installed in the same directory as NetWorker client
man pages. For example, if the man pages are in the default directory, ensure that
MANPATH includes /usr/share/man.
7. Register the NMSAP product (optional step). “Register NMSAP product
information with the SAP SLD repository (optional)” on page 22 provides details.
8. Configure the NMSAP software.
The EMC NetWorker Module for SAP with Oracle Administration Guide provides
details.
The EMC NetWorker Installation Guide and the EMC NetWorker Release Notes provide
more information.
Register NMSAP product information with the SAP SLD repository (optional)
As part of NMSAP installation, it is recommended by SAP to register the NMSAP
product information for your installation with the SAP System Landscape Directory
(SLD).
To register the NMSAP product information:
1. Locate the nwsldreg.xml file, and open it in a text editor, such as vi. Do not use a
word processor.
A copy of this file, which has been preconfigured with the NMSAP information
except for your computer hostname, is included as part of the NMSAP
installation in the following location:
• UNIX or Linux systems: /etc/nwsldreg.xml
• Microsoft Windows systems:
NetWorker_install_directory\nsr\bin\nwsldreg.xml
2. Change all occurrences of the word “ComputerName” to the hostname of the
computer on which you have installed NMSAP.
22
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Getting Started
3. Save the file.
4. Ensure that the SAP SLD server is running.
5. From a command line, send the edited file to your SLD server with the sldreg
command as follows:
sldreg -user username -pass password -host sld_server
-port http_port -file nwsldreg.xml
where:
• username and password are your login credentials on the SLD host.
• sld_server is the name of the SLD host.
• http_port is the port configured for HTTP connections on the SLD host.
If you have configured the HTTP server to use HTTPS, you must add the
option -usehttps.
• nwsldreg.xml is the XML file to send to the SLD host.
The sldreg command, run without options, gives more information. The SAP web
site also provides more information.
Installation roadmaps
23
Getting Started
24
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
2
UNIX and Linux
Installation
This chapter includes the following sections:
◆
◆
◆
◆
◆
◆
Installing NMSAP on AIX systems.............................................................................
Installing NMSAP on HP-UX systems.......................................................................
Installing NMSAP on Linux systems .........................................................................
Installing NMSAP on Solaris systems........................................................................
Enabling the RMAN utility..........................................................................................
Uninstalling NMSAP on UNIX or Linux systems....................................................
UNIX and Linux Installation
26
27
27
28
30
31
25
UNIX and Linux Installation
Installing NMSAP on AIX systems
To install NetWorker Module for SAP with Oracle (NMSAP) on an AIX system:
1. Follow the initial steps in “Installation roadmaps” on page 19. Ensure that you are
logged in as the root user, no backups are running, and that you are in the correct
directory, which contains the NMSAP installation files.
2. Invoke either the installp command line interface (CLI) or the AIX System
Management Interface Tool (SMIT) GUI program:
• To invoke the CLI, type the following command:
installp -a -d /dir_pathname LGTOnmsap.rte
where /dir_pathname is the complete pathname of the correct directory that
contains the installation software, as described in “Accessing the NMSAP
software” on page 17.
To verify that the installation succeeded, type the following command:
lslpp -L all | grep -i lgtonmsap
If the lslpp command output includes LGTOnmsap.rte 4.2.0.0, then the
installation was successful.
• To invoke the SMIT GUI program, perform the following:
a. Type the following command:
smitty install_latest
b. In the Entry Field, type the location of the NMSAP installation software as
the complete pathname of the directory described in “Accessing the
NMSAP software” on page 17.
c. Select the option SOFTWARE to install.
d. Type yes in response to the following prompts:
Accept new license agreements?
Preview new license agreements?
e. Select F4=List to display the list of NMSAP software packages.
f. Select LGTOnmsap.rte to install the NMSAP software.
g. Ensure that the Preview Only option is set to No.
h. Select Install and Update Software.
i. Press Enter to begin the installation.
3. If the RMAN utility will be used for backup and restore operations, follow the
steps in “Enabling the RMAN utility” on page 30.
4. When the NMSAP software installation is complete, return to the installation
roadmap to perform any post-installation procedures. “Roadmap to
post-installation procedures” on page 21 provides details.
26
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
UNIX and Linux Installation
Installing NMSAP on HP-UX systems
To install NMSAP on an HP-UX system:
1. Follow the initial steps in “Installation roadmaps” on page 19. Ensure that you are
logged in as the root user, no backups are running, and that you are in the correct
directory, which contains the NMSAP installation files.
2. Type the swinstall command to invoke either the command line interface (CLI) or
the graphical user interface (GUI) program:
• To invoke the swinstall CLI program, type the following command:
swinstall -x mount_all_filesystems=false
-s /dir_pathname/LGTOnmsap.pkg NMSAP
where /dir_pathname is the complete pathname of the directory containing the
software installation files, as described in “Accessing the NMSAP software”
on page 17.
• To invoke the swinstall GUI program, type the following command:
swinstall -x mount_all_filesystems=false -i
-s /dir_pathname/LGTOnmsap.pkg NMSAP
where /dir_pathname is the complete pathname of the directory containing the
software installation files, as described in “Accessing the NMSAP software”
on page 17.
a. From the Actions menu, select Install (analysis).
When the analysis is complete, a “Ready with Warnings” message appears.
This is normal.
b. Click OK to continue the installation.
The NMSAP installation on HP-UX stores informational messages including
installation errors in the /var/adm/sw/swagent.log file. If an error occurs
during the installation, check this file to obtain details on the error.
3. If the RMAN utility will be used for backup and restore operations, follow the
steps in “Enabling the RMAN utility” on page 30.
4. When the NMSAP software installation is complete, return to the installation
roadmap to perform any post-installation procedures. “Roadmap to
post-installation procedures” on page 21 provides details.
Installing NMSAP on Linux systems
To install the NMSAP software on a Linux system:
1. Follow the initial steps in “Installation roadmaps” on page 19. Ensure that you are
logged in as the root user, no backups are running, and you are in the correct
directory, which contains the NMSAP installation files.
2. Type the appropriate rpm command to install the NMSAP software.
Note: NMSAP must be installed in the same directory as the NetWorker client software.
Installing NMSAP on HP-UX systems
27
UNIX and Linux Installation
If the NetWorker client software was installed in a nondefault directory, add this
option to the rpm commands that follow:
--relocate /usr=NetWorker_base_dir
where NetWorker_base_dir is the directory where the NetWorker client software
resides.
To install the NMSAP software in the default directory, type the rpm command:
• On Linux AMD64/EM64T:
rpm -i lgtonmsap-4.2.0.1-1.x86_64.rpm
• On Linux Itanium:
rpm -i lgtonmsap-4.2.0.1-1.ia64.rpm
• On Linux PowerPC:
rpm -i lgtonmsap-4.2.0.1-1.ppc64.rpm
3. To verify that the installation was successful, type the rpm -aq command:
rpm -aq | grep -i lgto
The command output should include the appropriate lines, for example:
lgtoclnt-7.6.3-1
lgtonmsap-4.2.0.1-1
4. If the RMAN utility will be used for backup and restore operations, follow the
steps in “Enabling the RMAN utility” on page 30.
5. When the NMSAP software installation is complete, return to the installation
roadmap to perform any post-installation procedures. “Roadmap to
post-installation procedures” on page 21 provides details.
Installing NMSAP on Solaris systems
To install NMSAP on a Solaris system:
1. Follow the initial steps in “Installation roadmaps” on page 19. Ensure that you are
logged in as the root user, no backups are running, and that you are in the correct
directory, which contains the NMSAP installation files.
Note: If the Solaris system has Solaris zones (containers) and the NMSAP program is to
run on a sparse root zone, install NMSAP on the global zone and on each required sparse
root zone.
2. Verify the basedir variable setting in the /var/sadm/install/admin/default file.
Ensure the NMSAP software will be installed in the same base directory as the
NetWorker client software. The basedir variable in this file can be set to one of
three possible values:
• If basedir=default, the software will be installed in the same directory as the
NetWorker client software.
• If basedir=ask, you will be prompted for the name of the base directory where
the software will be installed.
28
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
UNIX and Linux Installation
• If basedir=/dirpath, the software will be installed in the /dirpath directory. The
/dirpath must be the pathname of the NetWorker client software base directory,
as determined by this pkgparam command:
pkgparam LGTOclnt BASEDIR
3. Type the appropriate pkgadd command:
pkgadd -d /dir_pathname LGTOnmsap
where /dir_pathname is the complete pathname of the directory containing the
LGTOnmsap package.
4. Complete the NMSAP installation, depending on the basedir variable setting in
the /var/sadm/install/admin/default file:
• If basedir=default in the file, type y when prompted whether to continue the
installation.
The software is installed in the same directory as the NetWorker client
software.
• If basedir=ask in the file, perform the following:
a. When prompted for the pathname of the base directory, type the result of
the pkgparam LGTOclnt BASEDIR command (which gives the path of the
NetWorker client software).
b. Type y when prompted whether to continue the installation.
The software is installed in the specified base directory.
Note: If an incorrect pathname is typed, where the NetWorker client is not located, the
installation displays an error and the software is installed in the incorrect directory. In
this case:
a. Uninstall the software by typing the pkgrm LGTOnmsap command.
b. Reinstall the software by typing the correct pathname at the first pkgadd prompt.
• If basedir=/dirpath in the file, type y when prompted whether to continue the
installation.
The software is installed in the specified /dirpath directory.
Note: If /dirpath is not the base directory where the NetWorker client software is
installed, the installation displays an error and the software is installed in the incorrect
directory. In this case:
a. Uninstall the software by typing the pkgrm LGTOnmsap command.
b. Correct basedir=/dirpath in the /var/sadm/install/admin/default file.
c. Reinstall the software.
5. If the RMAN utility will be used for backup and restore operations, follow the
steps in “Enabling the RMAN utility” on page 30.
6. When the NMSAP software installation is complete, return to the installation
roadmap to perform any post-installation procedures. “Roadmap to
post-installation procedures” on page 21 provides details.
Installing NMSAP on Solaris systems
29
UNIX and Linux Installation
Enabling the RMAN utility
If you want to use Oracle RMAN software for backup and restore operations on a
UNIX or Linux operating system, you must create a symbolic link to the NMSAP
RMAN library file.
Note: NMSAP does not support RMAN backups on Linux PowerPC platforms.
To enable the RMAN utility:
1. Log in as the $ORACLE_HOME owner. For example, type:
su ORACLE_HOME_owner
2. Type the command appropriate for your operating system to create a symbolic
link to the RMAN libnworasap.* library file.
The commands listed in Table 5 on page 30 are examples that assume a default
NMSAP installation, with the libnworasap.* library file installed in the default
directory (for example, /usr/lib).
Table 5
Commands to link and unlink the RMAN library file
Create / remove
AIX
create link
cd $ORACLE_HOME/lib
ln -s /usr/lib/libnworasap.a libobk.a
remove link
cd $ORACLE_HOME/lib
rm libobk.a
create link
cd $ORACLE_HOME/lib
ln -s /usr/lib/libnworasap.so libobk.so
remove link
cd $ORACLE_HOME/lib
rm libobk.so
create link
cd $ORACLE_HOME/lib
ln -s /usr/lib/libnworasap.sl libobk.sl
remove link
cd $ORACLE_HOME/lib
rm libobk.sl
create link
cd $ORACLE_HOME/lib
ln -s /usr/lib/libnworasap.so libobk.so
remove link
cd $ORACLE_HOME/lib
rm libobk.so
create link
cd $ORACLE_HOME/lib
ln -s /usr/lib/libnworasap.so libobk.so
remove link
cd $ORACLE_HOME/lib
rm libobk.so
HP Itanium
HP PA-RISC
Linux x64
Linux Itanium
Sun x64
Sun SPARC
30
Install:
create symbolic link.
Uninstall: remove symbolic link
System
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
UNIX and Linux Installation
Uninstalling NMSAP on UNIX or Linux systems
To uninstall NMSAP software on a UNIX or Linux system:
Note: If uninstalling the software on a cluster, you must perform the uninstall procedure on
each required node of the cluster.
1. Ensure that no database or application backups are running.
2. If the RMAN feature is enabled, remove the symbolic link for the library file.
“Enabling the RMAN utility” on page 30 provides details.
3. Log in as the root user on the NMSAP host.
4. Remove the backint program from the directory where the SAP BRTools reside,
for example, /usr/sap/<DBSID>/SYS/exe/run.
5. Uninstall the NMSAP software by using the appropriate procedure for the
operating system:
Note: A database does not need to be shut down to uninstall the NMSAP software.
• “Uninstall NMSAP on AIX” on page 31
• “Uninstall NMSAP on HP-UX” on page 32
• “Uninstall NMSAP on Linux” on page 32
• “Uninstall NMSAP on Solaris” on page 33
Uninstall NMSAP on AIX
To uninstall NMSAP software on an AIX system:
1. Ensure that you have followed the steps in “Uninstalling NMSAP on UNIX or
Linux systems” on page 31 for the initial part of the uninstallation procedure.
2. Use one of the following methods:
• Use the command line interface by typing the following command:
installp -u LGTOnmsap.rte
• Use the SMIT GUI program as follows:
a. Type the following smitty command:
smitty remove
b. Select F4=List to display a list of the installed software packages.
c. Select the packages to be uninstalled:
LGTOnmsap.rte
d. Ensure that the PREVIEW Only option is set to No.
e. Press Enter to uninstall the NMSAP software.
f. Exit the SMIT program.
Uninstalling NMSAP on UNIX or Linux systems
31
UNIX and Linux Installation
Uninstall NMSAP on HP-UX
To uninstall NMSAP software on an HP-UX system:
1. Ensure that you have followed the steps in “Uninstalling NMSAP on UNIX or
Linux systems” on page 31 for the initial part of the uninstallation procedure.
2. Use one of the following methods:
• Use the command line interface by typing the following command:
swremove NMSAP
• Use the swremove GUI program as follows:
a. Type the following swremove command:
swremove -i NMSAP
b. Select Actions > Remove (analysis).
c. When the system analysis is complete, click OK to complete the uninstall.
d. To confirm the uninstall, click Yes.
LGTOnmsap.rte
e. Ensure that the PREVIEW Only option is set to No.
Uninstall NMSAP on Linux
To uninstall NMSAP software on a Linux system:
1. Ensure that you have followed the steps in “Uninstalling NMSAP on UNIX or
Linux systems” on page 31 for the initial part of the uninstallation procedure.
2. Type the following command:
rpm -e lgtonmsap-4.2.0.1-1
Note: On Linux, the NetWorker client software must be uninstalled after the NMSAP
software.
To uninstall both NMSAP and the NetWorker client on Linux, perform one of the
following:
◆
Type this command:
rpm -e lgtonmsap-4.2.0.1-1 lgtoclnt
◆
Type these separate commands, in this order only:
rpm -e lgtonmsap-4.2.0.1-1
rpm -e lgtoclnt
32
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
UNIX and Linux Installation
Uninstall NMSAP on Solaris
To uninstall NMSAP software on a Solaris system:
1. Ensure that you have followed the steps in “Uninstalling NMSAP on UNIX or
Linux systems” on page 31 for the initial part of the uninstallation procedure.
Note: To uninstall NMSAP on Solaris zones, first uninstall NMSAP on the global zone, and
then uninstall NMSAP on each required sparse root zone.
2. Type the following command:
pkgrm LGTOnmsap
3. Perform the following according to the basedir variable setting in the
/var/sadm/install/admin/default file:
• If basedir=default in the file, type y when prompted. The software is
uninstalled from the directory that contains the NetWorker client software.
• If basedir=ask in the file, type the result of the pkgparam LGTOnmsap
BASEDIR command when prompted for the pathname of the base directory.
The software is uninstalled from the specified base directory.
• If basedir=/dirpath in the file, type y when prompted. The software is
uninstalled from the specified /dirpath directory.
Uninstalling NMSAP on UNIX or Linux systems
33
UNIX and Linux Installation
34
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
3
Microsoft Windows
Installation
This chapter includes the following sections:
◆
◆
◆
Installing NMSAP on Microsoft Windows................................................................ 36
Maintaining the installation on Microsoft Windows ............................................... 37
Uninstalling NMSAP on Microsoft Windows........................................................... 37
Microsoft Windows Installation
35
Microsoft Windows Installation
Installing NMSAP on Microsoft Windows
To install NetWorker Module for SAP with Oracle (NMSAP) on a Microsoft Windows
system:
1. Follow the initial steps in “Installation roadmaps” on page 19. Ensure that you are
logged in as administrator, no database backups are running, and that you are in
the correct directory, which contains the NMSAP installation files:
2. Run the NMSAP Setup program, networkr\setup.exe, and follow the
instructions presented by the installation wizard.
By default, the Setup program installs the NMSAP program files in the same
directory as the NetWorker client program files, NetWorker_install_directory\bin.
The EMC NetWorker Installation Guide provides information on nondefault
installations.
Note: If the Setup program detects no NetWorker client program files, it displays an error
message and exits without installing the NMSAP software.
3. To install the RMAN component, select Custom installation and select RMAN.
If NetWorker Module for Databases and Applications (NMDA) or NetWorker
Module for Oracle (NMO) software is already installed on the host, do not install
the RMAN component.
4. Click Finish to exit the Setup program.
When the installation completes, a message describes how to start the backup
configuration wizard. The EMC NetWorker Module for SAP with Oracle
Administration Guide provides details on the wizard.
5. Verify that the system Path environment variable includes the NetWorker client
installation directory. For example:
a. Right-click My Computer and select Manage.
b. Click Properties.
c. On the Advanced tab, under Environment Variables, click Settings.
d. In the System Variables, verify the Path variable. If required, add the
NetWorker client installation directory.
Note: The NetWorker client directory pathname may include spaces, but there cannot be
spaces before or after the pathname.
6. If you installed NetWorker software for the first time or changed the system Path
variable, restart the Windows system, and verify that any required database
instances and services were restarted.
7. When the NMSAP software installation is complete, return to the installation
roadmap to perform any post-installation procedures. “Roadmap to
post-installation procedures” on page 21 provides details.
36
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide
Microsoft Windows Installation
Maintaining the installation on Microsoft Windows
The following sections describe how to modify, repair, or remove an existing NMSAP
installation on Microsoft Windows.
Run the Setup program in maintenance mode
To run the Setup program in maintenance mode:
1. Ensure that you are logged in as the Windows system administrator.
2. Ensure that no database backups are running.
3. Go to the directory that contains the NMSAP installation files, as described in
“Accessing the NMSAP software” on page 17, and run the networkr\setup.exe
program.
4. In the Welcome window, click Next.
5. In the Program Maintenance window, select the maintenance task to perform,
and click Next to proceed:
• Repair — Allows you to replace missing or corrupted files in the NMSAP
installation. “Repair an NMSAP installation” on page 37 provides details.
• Remove — Allows you to remove the NMSAP software.
You can also use Add or Remove Programs in the Windows Control Panel to
remove the components. “Uninstalling NMSAP on Microsoft Windows” on
page 37 provides details.
Repair an NMSAP installation
To repair an NMSAP installation:
1. Start the Setup program in maintenance mode. “Run the Setup program in
maintenance mode” on page 37 provides details.
2. In the Program Maintenance window, select Repair and click Next.
3. In the Ready to Repair the Program window, click Install to begin the
installation. The Setup program reinstalls the NMSAP files as required.
4. In the InstallShield Wizard Completed dialog box, click Finish to exit the
wizard.
The InstallShield Wizard Completed window displays a message on how to
start the NetWorker Client Configuration Wizard.
5. If you changed the system Path variable, reboot the Windows system, and verify
that any required database instances and services were restarted.
Uninstalling NMSAP on Microsoft Windows
To uninstall the NMSAP software on a supported Microsoft Windows system:
1. Log in as the Windows system administrator on the NMSAP host.
Note: If uninstalling the software from a cluster, you must perform the uninstall procedure
on each node of the cluster that has the NMSAP software.
Maintaining the installation on Microsoft Windows
37
Microsoft Windows Installation
2. Ensure that no database backups are running.
Note: A database does not need to be shut down to uninstall the NMSAP software.
3. Remove the backint.exe program file from the folder where the SAP BRTools
reside.
4. Uninstall the NMSAP software by using one of the following methods:
• Setup program method:
a. Run the networkr\setup.exe program, as described in “Run the Setup
program in maintenance mode” on page 37.
b. In the Program Maintenance window, select Remove and click Next.
c. In the Remove the Program window, click Remove to uninstall the
NMSAP software.
• Windows Control Panel method:
a. In the Windows Control Panel window, select either Add or Remove
Programs. or Programs and Features, depending on the Microsoft
Windows version.
b. In the Add or Remove Programs window, select NetWorker Module for
SAP and click Remove.
38
EMC NetWorker Module for SAP with Oracle Release 4.2 Installation Guide