EMC NetWorker Module for SAP · EMC NetWorker Module for SAP 8.2 and Service Packs ... Getting Started 11. ... The term “SAP Oracle” used throughout this document refers to a

EMC® NetWorker® Module for SAPVersion 8.2 and Service Packs

Installation Guide302-001-224

REV 04

Copyright © 2009-2017 Dell Inc. or its subsidiaries. All rights reserved.

Published February 2017

Dell 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.“ DELL 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 DELL SOFTWARE DESCRIBED

IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.

Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.

Published in the USA.

EMC CorporationHopkinton, Massachusetts 01748-91031-508-435-1000 In North America 1-866-464-7381www.EMC.com

2 EMC NetWorker Module for SAP 8.2 and Service Packs Installation Guide

5

7

Getting Started 11Required software.......................................................................................12

NetWorker server software............................................................13NetWorker storage node software................................................. 13NMC server software..................................................................... 13NetWorker client software............................................................. 13NMSAP software........................................................................... 14SAP BR*Tools software................................................................. 14Replication Manager software........................................................14

Installation checklists.................................................................................. 14Documents..................................................................................... 14Installation media........................................................................... 15License enablers.............................................................................15

Accessing the NMSAP software................................................................. 15Accessing NMSAP from the DVD media.........................................15Accessing NMSAP from the EMC website..................................... 16

Installation road maps..................................................................................17Road map to install or update NMSAP on a local host.................... 17Road map to update NMSAP remotely by push install....................19Road map to post-installation procedures..................................... 20Registering NMSAP product information with the SAP SLDrepository (optional)......................................................................23

UNIX and Linux Installation 25Installing NMSAP on AIX systems.............................................................. 26Installing NMSAP on HP-UX systems......................................................... 27Installing NMSAP on Linux systems............................................................28Installing NMSAP on Solaris systems......................................................... 29Enabling the RMAN utility........................................................................... 31Uninstalling NMSAP on UNIX and Linux systems........................................32

Uninstalling NMSAP on AIX........................................................... 33Uninstalling NMSAP on HP-UX......................................................33Uninstalling NMSAP on Linux........................................................ 34Uninstalling NMSAP on Solaris...................................................... 34

Microsoft Windows Installation 37Installing NMSAP on Microsoft Windows................................................... 38Maintaining the installation on Microsoft Windows.....................................39

Running the Setup program in maintenance mode.........................39Repairing an NMSAP installation................................................... 40

Uninstalling NMSAP on Microsoft Windows...............................................40

Tables

Preface

Chapter 1

Chapter 2

Chapter 3

CONTENTS

EMC NetWorker Module for SAP 8.2 and Service Packs Installation Guide 3

CONTENTS


Revision history............................................................................................................ 7Style conventions......................................................................................................... 9Typical hosts and software in the NMSAP backup and recovery environment............ 12Access the directory that contains the NMSAP software........................................... 16NetWorker startup commands on UNIX and Linux...................................................... 18Command to register the wizard.................................................................................22Commands to link and unlink the RMAN library file..................................................... 31

1234567

TABLES


TABLES


Preface

As part of an effort to improve its product lines, EMC periodically releases revisions ofits software and hardware. Therefore, some functions described in this documentmight not be supported by all versions of the software or hardware currently in use.The product release notes provide the most up-to-date information on productfeatures.

Contact your EMC technical support professional if a product does not functioncorrectly or does not function as described in this document.

Note

This document was accurate at publication time. Go to EMC Online Support (https://support.emc.com) to ensure that you are using the latest version of this document.

PurposeThis document describes how to install, update, and remove EMC NetWorker Modulefor SAP (NMSAP) 8.2 and Service Packs.

AudienceThis document is intended for system administrators who are responsible for installingNMSAP and maintaining backup and recovery systems.

Users of this guide must be familiar with the following topics:

l SAP terminology and concepts, especially those related to SAP HANA and Oracledatabase backup and recovery

l Backup and recovery procedures

l Disaster recovery procedures

Revision historyThe following table presents the revision history of this document.

Table 1 Revision history

Revision Date Description

04 February 20, 2017 Updated the following information:

l Road map to install or update NMSAP on a local host on page 17—Updated step 6 with requirements for the NetWorker Remote Exec daemonor service.

l Road map to post-installation procedures on page 20—Updated step 5with requirements for the wizard registration, and added step 8.

l Installing NMSAP on AIX systems on page 26—Updated step 1, andadded details in step 4 about verifying the wizard registration.

l Installing NMSAP on HP-UX systems on page 27—Updated step 1, andadded details in step 4 about verifying the wizard registration.

l Installing NMSAP on Linux systems on page 28—Updated step 1, andadded details in step 5 about verifying the wizard registration.


https://support.emc.com/


Table 1 Revision history (continued)

Revision Date Description

l Installing NMSAP on Solaris systems on page 29—Updated step 1, andadded details in step 6 about verifying the wizard registration.

l Uninstalling NMSAP on UNIX and Linux systems on page 32—Added step2 with a requirement for the NetWorker Remote Exec daemon.

l Installing NMSAP on Microsoft Windows on page 38—Updated step 1,and added details in step 5 about verifying the wizard registration.

l Uninstalling NMSAP on Microsoft Windows on page 40—Added step 3with a requirement for the NetWorker Remote Exec service.

03 November 21, 2016 Updated the following information:

l Accessing NMSAP from the EMC website on page 16—Updated the filename in step 6 for the downloaded Windows software package.

l Installing NMSAP on Microsoft Windows on page 38—Added informationto step 2 about the silent installation method.

l Uninstalling NMSAP on Microsoft Windows on page 40—Addedinformation to step 4 about the silent uninstallation method.

02 September 30, 2015 Updated the following information:

l Updated the title of this guide and any references to other NMSAP guidetitles that changed for the NMSAP 8.2 SP2 release.

l Registering NMSAP product information with the SAP SLD repository(optional) on page 23—Updated steps 2 and 4 in the procedure.

l Installing NMSAP on AIX systems on page 26—Updated the lslppcommand output for NMSAP 8.2 SP2.

l Installing NMSAP on Linux systems on page 28—Updated the softwarepackage name and rpm -aq command output for NMSAP 8.2 SP2.

l Uninstalling NMSAP on Linux on page 34—Updated the softwarepackage names for NMSAP 8.2 SP2.

01 January 28, 2015 Initial release of NMSAP 8.2 SP1.

Related documentationYou can find additional EMC publications for this product release and relatedNetWorker products at EMC Online Support.

The EMC NetWorker Module for SAP Release 8.2 and Service Packs Release Notesprovides details about supported environments and platforms.

Special notice conventions that are used in this documentEMC uses the following conventions for special notices:

NOTICE

Addresses practices that are not related to personal injury.

Preface


Note

Presents information that is important, but not hazard-related.

Typographical conventionsEMC uses the following type style conventions in this document:

Table 2 Style conventions

Bold Used for names of interface elements, such as names of buttons,fields, tab names, and menu paths (what the user specifically selectsor clicks)

Italic Used for full titles of publications that are referenced in text

Monospace Used for:

l System code

l System output, such as an error message or script

l Pathnames, file names, prompts, and syntax

l Commands and options

Monospace italic Used for variables

Monospace bold Used for user input

[ ] Square brackets enclose optional values

| Vertical bar indicates alternate selections - the bar means “or”

{ } Braces enclose content that the user must specify, such as x or y orz

... Ellipses indicate non-essential information that is omitted from theexample

Where to get helpEMC support, product, and licensing information can be obtained as follows:

Product informationFor documentation, release notes, software updates, or information about EMCproducts, go to EMC Online Support at https://support.emc.com.

Technical supportGo to EMC Online Support and click Service Center. Several options for contactingEMC Technical Support appear on the site. Note that to open a service request, youmust have a valid support agreement. Contact your EMC sales representative fordetails about obtaining a valid support agreement or with questions about youraccount.

Online communitiesGo to EMC Community Network at https://community.emc.com for peer contacts,conversations, and content on product support and solutions. Interactively engageonline with customers, partners, and certified professionals for all EMC products.

Your commentsYour suggestions help to improve the accuracy, organization, and overall quality of theuser publications. Send your opinions of this document to [email protected].

Preface


https://support.emc.com

https://community.emc.com

mailto:[email protected]

Preface


CHAPTER 1

Getting Started

This chapter includes the following topics:

l Required software.............................................................................................. 12l Installation checklists..........................................................................................14l Accessing the NMSAP software.........................................................................15l Installation road maps......................................................................................... 17

Getting Started 11

Required softwareEMC® NetWorker® Module for SAP (NMSAP) is an add-on module for theNetWorker server and client software that provides backup and recovery services forSAP HANA and SAP Oracle data.

Note

The term “SAP Oracle” used throughout this document refers to a SAP environmentwith an Oracle database.

The following table lists the hosts and software that you might need for NMSAPservices.

Table 3 Typical hosts and software in the NMSAP backup and recovery environment

Host Required software

NetWorker server l NetWorker client

l NetWorker storage node

l NetWorker server

NetWorker storage node l NetWorker client

l NetWorker storage node

NetWorker Management Console (NMC)server

l NetWorker client

l NMC server

Each SAP server l SAP database server

l NetWorker client

l NMSAP

l On SAP Oracle server:

n SAP BR*Tools

n For split-mirror backups, compatibleEMC Replication Manager software forBR*Tools

Review the following software descriptions to plan your installation requirements.

The EMC NetWorker Module for SAP Release 8.2 and Service Packs Release Notesprovides details about the operating systems and software versions required forNMSAP services.

The Support link at EMC Online Support describes the patches required for aparticular system.

The EMC NetWorker Installation Guide describes how to install the NetWorker server,storage node, client, and NMC software.

Getting Started


NetWorker server softwareYou must install a supported version of the NetWorker server software with allapplicable patches on the NetWorker server host. The NetWorker server host isusually a separate host, but the server host can also be the NMSAP host.

You might require specific NetWorker server versions to support specific NMSAPfeatures as described in the NMSAP release notes.

You must use a certified version of the NetWorker server that works with theNetWorker client version installed on the NMSAP host. The operating systems usedmust support the NetWorker server version.

NetWorker storage node softwareYou must install a supported version of the NetWorker storage node software with allapplicable patches on the host that manages the backup storage devices. You caninstall the NetWorker storage node on the same host as the NetWorker server, on thesame host as NMSAP (to support backups to a local device), or on a separate host.

You must use a certified version of the NetWorker storage node that works with theNetWorker client version installed on the NMSAP host and with the NetWorkerserver. The operating systems used must support the NetWorker storage nodeversion.

NMC server softwareYou must install a supported version of the NMC software on a network host toprovide a user interface with the NetWorker software and NMSAP.

NetWorker client softwareYou must install a supported version of the NetWorker client software with allapplicable patches on the supported SAP server host before you install NMSAP onthat host.

You might require specific NetWorker client versions to support specific NMSAPfeatures as described in the NMSAP release notes.

You must use a certified version of the NetWorker client that runs on the operatingsystem.

NetWorker client release 8.1 or later includes the NetWorker Snapshot Management(NSM) feature that integrates and replaces the previous stand-alone EMC NetWorkerPowerSnap™ Module.

On a SAP Oracle server, NMSAP can use NSM to provide a high-availability storageenvironment for snapshot backups and restores. To enable the snapshot operations,you must install the NetWorker client release 8.1 or later on both of the followinghosts:

l NMSAP host

l A separate proxy client host, also called the data mover, which can be aNetWorker storage node

Getting Started

NetWorker server software 13

Note

Some operating systems and volume managers require the proxy client host to bea separate host. For example, Veritas Volume Manager (VxVM) and Linux LogicalVolume Manager (LVM) do not support the use of the database host as the mounthost. The EMC NetWorker Snapshot Management Integration Guide provides a fulllist of restrictions and details.

NMSAP softwareYou must install NMSAP on the SAP server. You must install NMSAP on a supportedoperating system version.

For split-mirror backups on a SAP Oracle server, you must also install NMSAP on themount host (data mover).

SAP BR*Tools softwareOn a SAP Oracle server, you must install a supported SAP BR*Tools version. You mustuse a certified version of SAP BR*Tools that runs on the operating system. The SAPdocumentation describes the supported operating systems.

If you install NMSAP in a non-English environment, ensure that the host operatingsystem supports internationalization (I18N). Also ensure that the SAP Oracle softwareand BR*Tools software provide the required National Language Support (NLS) orglobalization support, and are configured with the required non-ASCII character set.

Replication Manager softwareTo enable split-mirror backup features on a SAP Oracle server, EMC ReplicationManager server software must work with Replication Manager agent softwareinstalled on both of the following hosts:

l SAP Oracle server

l A separate mount host (data mover), which can be a NetWorker storage node

The EMC Replication Manager documentation describes the installation.

Installation checklistsReview the following checklists to ensure that you have the required materials for theinstallation procedures.

DocumentsYou can find the required information in the following documents:

l EMC NetWorker Module for SAP Installation Guide for the existing version, if youmust uninstall a previous version of NMSAP before you can install the NMSAP 8.2Service Pack version

l EMC NetWorker Module for SAP Release 8.2 and Service Packs Release Notes

l EMC NetWorker Module for SAP Release 8.2 and Service Packs Administration Guide

l EMC NetWorker Administration Guide for the supported NetWorker release

Getting Started


Installation mediaYou must use one of the following installation media:

l DVD from the EMC Information Protection and Availability Product Families MediaKit

l Link to the EMC website if you download the software

License enablersYou must use the following license enablers:

l Evaluation enabler

l Enabler certificate

NMSAP has separate license enablers for UNIX, Linux, and Microsoft Windowssystems.

Note

Without an enabler code, you can only evaluate the software.

The EMC NetWorker Licensing Guide describes licensing.

The EMC Price Guide describes the licensing requirements for NetWorker modules.

Accessing the NMSAP softwareYou can obtain the NMSAP software from the DVD media or the EMC website.

Accessing NMSAP from the DVD mediaThe DVD with the NMSAP software is in the EMC Information Protection andAvailability Product Families Media Kit. The kit contains the software and onlinedocumentation for related products.

You can access the NMSAP software files from the DVD on a host with a local DVDdrive.

Procedure

1. Log in as the root user (UNIX or Linux) or system administrator (Windows) onthe host.

2. Insert and mount the NetWorker Module DVD in the DVD drive:

l On UNIX or Linux, mount the DVD drive:

mount /dev/DVD_drive_name /mount_pointl On Windows, select the DVD drive in Windows Explorer.

3. Go to the directory that contains the software as shown in the following table.

The EMC NetWorker Module for SAP Release 8.2 and Service Packs Release Notesprovides details about the operating systems, database software, andapplication software that NMSAP supports.

Getting Started

Installation media 15

Table 4 Access the directory that contains the NMSAP software

Operating system (NMSAP bitness) Software directory

AIX (64-bit) /mount_point/sap/aixpower

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

Solaris SPARC (64-bit) /mount_point/volume_label/sap/solaris_64

Solaris x64 (64-bit) /mount_point/volume_label/sap/solaris_amd64

Windows x64 (64-bit) DVD_drive_letter:\sap\win_x64

Accessing NMSAP from the EMC websiteYou can download the NMSAP software package from the EMC Online Supportwebsite and extract the installation files from the package to a temporary localdirectory.

Procedure

1. Log in as the root user (UNIX or Linux) or system administrator (Windows) onthe host.

2. Create a temporary installation download directory in a local file system withsufficient free disk space to contain both the downloaded software package andthe software installation files extracted from the package. For example:

l On UNIX or Linux:

mkdir /usr/nsr_extract_nmsapl On Windows:

mkdir C:\Downloads\nmsap3. Go to EMC Online Support at https://support.emc.com.

4. Go to the Downloads for NetWorker Module for SAP page.

The EMC NetWorker Module for SAP Release 8.2 and Service Packs Release Notesprovides details about the operating systems and the database and applicationsoftware that NMSAP supports.

5. Download the NMSAP 8.2 SP1 software file to the temporary directory that youcreated.

6. Extract the installation files from the downloaded software package:

l On UNIX or Linux:

a. Uncompress the downloaded package by typing the gunzip commandwith the file_name.tar.gz name for the specific download file name:

gunzip file_name.tar.gzb. Extract the software from the uncompressed, tarred file:

tar -xvpBf file_name.tar

Getting Started


https://support.emc.com

The extraction lists the distribution software files on the screen.

c. Remain in the directory for the installation.

l On Windows:

a. Unzip the downloaded software package, nmsap82x_win_x64.zip.

b. Go to the win_x64 directory.

Installation road mapsYou must follow the appropriate road map to install NMSAP:

l A road map to install or update NMSAP on a local host

l A road map to update NMSAP remotely by push install

l A road map to perform the post-installation procedures

Road map to install or update NMSAP on a local hostYou must follow the instructions to install or update NMSAP locally on a host in eitherof the following configurations.

l Single host

l Cluster host, Oracle RAC host, or SAP HANA scale-out host

Note

You must install the NetWorker client and NMSAP software on each node host thatwill perform backup and recovery operations in a cluster, Oracle RAC, or SAP HANAscale-out multinode environment.

The EMC NetWorker Module for SAP Release 8.2 and Service Packs Release Notesprovides details about the supported versions and cluster or multinode environments.

Procedure

1. Review the Installation checklists on page 14 and verify that you have therequired documentation, installation media, pathnames, and license information.

2. Ensure that you have installed the NetWorker client software on the host. Theclient version must support the NMSAP version to be installed.

3. Access the NMSAP software as described in Accessing the NMSAP softwareon page 15 and ensure that you start the installation from the correct directory.

Note

If you do not start the installation from the correct directory, the installationmight fail.

4. Ensure that no backups or restores are running on the SAP server. You do notneed to shut down a supported database during the installation.

5. If a previous version of NMSAP is already installed, uninstall the previousversion according to the instructions in the installation guide for the previousversion.

Getting Started

Installation road maps 17

NOTICE

Do not use an upgrade option on the platform, for example, the rpm -Ucommand on Linux.

Before you uninstall a previous NMSAP version, ensure that you save a copy ofthe original parameter file template (init.utl) and original configuration filetemplate (nsrsapsv.cfg) supplied with NMSAP. The template files arelocated in the following directory:

l On UNIX or Linux: /etcl On Windows: NetWorker_install_directory\nsr\bin

Note

An uninstallation of NMSAP deletes the original template files along with anysettings you made in the files.

6. Before the NMSAP installation, ensure that the NetWorker Remote Execdaemon, nsrexecd, is running on UNIX or Linux, or the NetWorker RemoteExec service, nsrexecd.exe, is running on Windows.

To verify that the NetWorker Remote Exec daemon or service is running:

l On UNIX or Linux, type the following command:

ps -ef | grep nsrexecd

l On Windows, use either Component Services or Task Manager.

If the NetWorker Remote Exec daemon or service is not running:

l To start the NetWorker Remote Exec daemon on UNIX or Linux, log in asroot, and type the appropriate startup command from the following table.

Table 5 NetWorker startup commands on UNIX and Linux

Operating system Startup command

Solaris, Linux /etc/init.d/networker start

HP-UX /sbin/init.d/networker start

AIX /etc/rc.nsr

l To start the NetWorker Remote Exec service on Windows, perform thefollowing steps:

a. Log in as a Windows Administrator.

b. Right-click My Computer, and select Manage.

c. Expand Configuration, and select Services.

d. Right-click the NetWorker Remote Exec Service, and select Start.

Getting Started


Note

If you do not start the NetWorker Remote Exec daemon or service before theNMSAP installation, then the automatic registration of the NMSAPconfiguration wizard might not occur and the wizard might fail to detect ifNMSAP is installed. Road map to post-installation procedures on page 20provides details.

7. Install the NMSAP software by following the instructions for the operatingsystem in the appropriate chapter:

l UNIX and Linux Installation on page 25

l Microsoft Windows Installation on page 37

After the software installation completes, a message appears about how tostart the NMSAP scheduled backup configuration wizard. The EMC NetWorkerModule for SAP Administration Guide describes the wizard.

8. Perform all the required post-installation procedures. Road map to post-installation procedures on page 20 provides details.

Road map to update NMSAP remotely by push installYou can update NMSAP on one or more remote NMSAP hosts with the softwaredistribution feature, known as push install, from a centralized NetWorker server. Youcan perform a push install with the Software Administration Wizard or the nsrpushcommand.

Note

Cluster environments do not support push install updates.

The EMC NetWorker Installation Guide describes the software distribution feature,including the following procedures:

l Verifying software installed on NetWorker clients

l Performing and monitoring push installs

l Managing the repository of software to push install from the NetWorker server

Note

To add a new version of NMSAP to the NetWorker server repository, you mustfollow the NetWorker installation guide instructions for the nsrpush command.For the Product Name variable, you must type the complete name “NetWorkerModule for SAP” with the quotation marks.

You must complete the required steps to update NMSAP remotely by push install.

Procedure

1. Review the Installation checklists on page 14.

2. Ensure that you meet the following requirements:

l The remote NMSAP clients contain NMSAP 3.5 or later, and the clientoperating systems support push install. You cannot perform a remote updateof earlier NMSAP versions.

Getting Started

Road map to update NMSAP remotely by push install 19

The EMC NetWorker Module for SAP Release 8.2 and Service Packs ReleaseNotes describes the operating systems that support a push install on theNMSAP host.

l The remote NMSAP client hosts contain a supported version of theNetWorker client software.

The EMC NetWorker Module for SAP Release 8.2 and Service Packs ReleaseNotes provides details.

l The remote NetWorker server hosts that serve the NetWorker clientscontain NetWorker 7.5 or later server software.

l The NetWorker Console server includes administrative privileges for the userwho performs the update.

3. Ensure that all NetWorker backups are stopped before you start any push installupdates.

Note

The software distribution program might stop and restart the NetWorker clientnsrexecd daemon during the installation.

4. On the NetWorker server, perform the push installation to update the NMSAPclients by using the Software Administration Wizard or the nsrpush command.

The EMC NetWorker Installation Guide describes the different methods of pushinstall with the NetWorker software distribution feature.

5. Perform all the required post-installation procedures. Road map to post-installation procedures on page 20 provides details.

Road map to post-installation proceduresAfter you have installed or updated NMSAP, either directly on a local host or byremote installation (push install), you must complete the post-installation procedures.

The EMC NetWorker Installation Guide and the EMC NetWorker Release Notes providemore information.

Procedure

1. Enable the NMSAP backup program:

l On a SAP HANA server, perform either of the following tasks:

n Copy the hdbbackint program file from the /usr/sbin or /relocation_path/sbin installation directory (Linux) tothe /usr/sap/SID/SYS/global/hdb/opt directory.

Note

Copy from the /relocation_path/sbin directory in this step only ifNMSAP has been installed in the nondefault relocation directory.

n Create a symbolic link that points from /usr/sap/SID/SYS/global/hdb/opt/hdbbackint to the actual hdbbackint programfile.

Getting Started


Note

You must manually create the opt subdirectory if it does not exist. SAPHANA requires the hdbbackint program to be accessible fromthe /usr/sap/SID/SYS/global/hdb/opt directory.Ensure that the hdbbackint file has the required executable permissionsfor the operating system user SIDadm to run the program, where SID is thesystem ID of the SAP HANA system.

l On a SAP Oracle server, perform either of the following tasks:

n Copy the backint program from the /usr/sbin directory (UNIX orLinux) or the NetWorker_install_directory\nsr\bin directory(Windows) to the directory where the SAP BR*Tools reside.

n For BR*Tools 7.10 or later, set util_path=full path to directory containingbackint in the BR*Tools configuration file, initDBSID.sap.

2. If you are installing NMSAP for the first time on the host, register and enableNMSAP to work with the NetWorker software.

The EMC NetWorker Licensing Guide describes licensing and enabling ofsoftware.

The EMC Price Guide describes the licensing requirements for NetWorkermodules.

If you are updating from a previous NMSAP release, you do not need toreenable the software.

3. If you will perform NSM snapshot backups and restores on a SAP Oracle server,ensure that NetWorker client release 8.1 or later is installed on the NMSAP hostand the data mover (proxy client) host.

The NSM documentation and the EMC NetWorker Module for SAP AdministrationGuide provide details.

4. If you will perform SAP split-mirror backup operations on a SAP Oracle server,install and enable the required Replication Manager software.

You must install NMSAP and Replication Manager software on both theproduction host and the mount (backup) host.

The EMC Replication Manager documentation and the EMC NetWorker Modulefor SAP Administration Guide provide details.

5. Ensure that the automatic wizard registration succeeded:

a. Log in as the root user (UNIX or Linux) or system administrator (Windows).

b. At a new command prompt, type the appropriate command:

l On UNIX or Linux, type the following command:

nsradmin -p nsrexecd

l On Windows, type the following command:

nsradmin.exe -p nsrexecd

Getting Started

Road map to post-installation procedures 21

c. At the nsradmin> prompt, type the following command:

print type: NSR remote agent

Check that the command output includes the correct values for "backuptype" (database or application type that you want to protect) and "productversion" (version of NMSAP that you installed). You can run the exitcommand to return to the original console.

If the command output is missing or does not contain the correct values,then the NetWorker Remote Exec service (the nsrexecd ornsrexecd.exe program) was not running during the NMSAP installation.Perform one of the following corrective actions:

l Start the NetWorker Remote Exec service, and then reinstall NMSAP.

l Register the wizard manually by typing the appropriate command fromthe following table.

Note

To unregister the wizard manually, use the command from the table butreplace the -i option with -u.

Table 6 Command to register the wizard

Operating system Wizard registration command

UNIX or Linux For SAP HANA: nsrhanara -i

For SAP Oracle: nsrsapra -i

Microsoft Windows For SAP Oracle: nsrsapra.exe -i

6. If you cannot access the NMSAP man pages (UNIX or Linux only) with the mancommand, modify the MANPATH environment variable to include the pathnameof the directory that contains the NMSAP man pages.

The NMSAP man pages are located in the same directory as NetWorker clientman pages. For example, if the man pages are located in the default directory,ensure that MANPATH includes /usr/share/man.

7. Optionally, register the NMSAP product. Registering NMSAP productinformation with the SAP SLD repository (optional) on page 23 providesdetails.

8. On UNIX or Linux, to ensure the success of backups and restores, check thatthe /nsr/applogs directory and its subdirectories have the 01777permissions.

The NMSAP installation sets the permissions to 01777 for /nsr/applogs andits subdirectories. These permissions are required for non-root database usersto create temporary files and logs during backups and restores. The sticky bit isalso set to ensure that the files can be removed only by the file owners. Forexample, the permissions appear as follows:

drwxrwxrwt 2 root root 4096 Dec 22 12:17 /nsr/applogs

Getting Started


9. Configure the NMSAP software.

The EMC NetWorker Module for SAP Administration Guide provides details.

Registering NMSAP product information with the SAP SLD repository(optional)

As part of the NMSAP installation, SAP recommends that you register the NMSAPproduct information for your installation with the SAP System Landscape Directory(SLD).

Procedure

1. Locate the nwsldreg.xml file, and open the file in a text editor, such as vi.Do not use a word processor.

The NMSAP installation stores a copy of this file, which has been preconfiguredwith the NMSAP information except for your computer hostname, in thefollowing location:

l On UNIX or Linux: /etc/nwsldreg.xml

l On Windows: NetWorker_install_directory\nsr\bin\nwsldreg.xml

2. Change all occurrences of the word ComputerName to the hostname of thecomputer on which you installed NMSAP, using the FQDN for the hostname.

3. Save the file.

4. Ensure that the SAP SLD server is running. The SAP documentation providesdetails.

5. Type the following sldreg command at the command line to send the editedfile to the SLD server:

sldreg -user username -pass password -host sld_server -porthttp_port -file nwsldreg.xml

where:

l username and password are the login credentials on the SLD host.

l sld_server is the name of the SLD host.

l 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 theoption -usehttps.

l nwsldreg.xml is the XML file to send to the SLD host.

The following sources provide more details:

l The sldreg command, run without options

l The SAP website

Getting Started

Registering NMSAP product information with the SAP SLD repository (optional) 23

Getting Started


CHAPTER 2

UNIX and Linux Installation


l Installing NMSAP on AIX systems...................................................................... 26l Installing NMSAP on HP-UX systems.................................................................27l Installing NMSAP on Linux systems................................................................... 28l Installing NMSAP on Solaris systems................................................................. 29l Enabling the RMAN utility...................................................................................31l Uninstalling NMSAP on UNIX and Linux systems............................................... 32

UNIX and Linux Installation 25

Installing NMSAP on AIX systemsYou can install NMSAP on an AIX system by running the installp command lineinterface (CLI) program or the AIX System Management Interface Tool (SMIT), whichis a graphical user interface (GUI) program.

Procedure

1. Complete the initial steps in Installation road maps on page 17. Ensure that youmeet the following requirements:

l You are logged in as the root user.

l No backups or restores are running.

l The nsrexecd daemon is running. You can check the daemon status byrunning the ps -ef | grep nsrexecd command.

l You are in the correct directory that contains the NMSAP installation files.

2. Run either the installp CLI program or the SMIT GUI program:

l To run the CLI program, type the following command:

installp -a -d /dir_pathname LGTOnmsap.rte

where /dir_pathnameis the complete pathname of the correct directory thatcontains the installation software as described in Accessing the NMSAPsoftware on page 15.

To verify that the installation was successful, type the following command:

lslpp -L all | grep -i lgtonmsap

If the lslpp command output includes LGTOnmsap.rte 8.2.2.0, then theinstallation was successful.

l To run the SMIT GUI program, perform the following steps:

a. Type the following command:

smitty install_latestb. In the Entry Field, type the location of the NMSAP installation software

as the complete pathname of the directory described in Accessing theNMSAP software on page 15.

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 the NMSAP software packages.

f. Select LGTOnmsap.rte to install the NMSAP software.

g. Set the Preview Only option to No.

h. Select Install and Update Software.

i. Press Enter to begin the installation.

3. If you use the RMAN utility for backup and restore operations, follow the stepsin Enabling the RMAN utility on page 31.



4. Return to the installation road map to perform any post-installation procedures.As part of these procedures, ensure that the NMSAP automatic wizardregistration succeeded by using the following commands:

nsradmin -p nsrexecdnsradmin> print type: NSR remote agent

Road map to post-installation procedures on page 20 provides complete details.

Installing NMSAP on HP-UX systemsYou can install NMSAP on an HP-UX system by using the swinstall command torun the command line interface (CLI) or the graphical user interface (GUI) program.

Procedure






2. Type the swinstall command to run either the CLI or GUI program:

l To run 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 thatcontains the software installation files as described in Accessing the NMSAPsoftware on page 15.

l To run 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 thatcontains the software installation files as described in Accessing the NMSAPsoftware on page 15.

a. From the Actions menu, select Install (analysis).When the analysis is complete, a “Ready with Warnings” messageappears. The message is normal.

b. Click OK to continue the installation.

The NMSAP installation on HP-UX stores informational messages includinginstallation errors in the /var/adm/sw/swagent.log file. If an error occursduring the installation, check this file to obtain details about the error.



Installing NMSAP on HP-UX systems 27




Installing NMSAP on Linux systemsYou can install NMSAP on a Linux system by running the rpm command. You canoptionally install NMSAP in a nondefault directory on Linux.

Procedure






2. To install NMSAP in the default directory, type the following rpm command:

rpm -i lgtonmsap-8.2.2.0-1.x86_64.rpm

Note

You must install NMSAP in the same directory as the NetWorker clientsoftware.

If you installed the NetWorker client software in a nondefault directory, add thefollowing option to the rpm command:

--relocate /usr=NetWorker_base_dir

where NetWorker_base_dir is the directory where the NetWorker clientsoftware resides.

3. To verify that the installation was successful, type the rpm -aq command:

rpm -aq | grep -i lgto

The command output must include the appropriate lines, for example:

lgtoclnt-8.2.2.0-1lgtonmsap-8.2.2.0-1







Installing NMSAP on Solaris systemsYou can install NMSAP on a Solaris system by running the pkgadd command. You canoptionally install NMSAP in a nondefault directory on Solaris.

Procedure






Note

If the Solaris system has Solaris zones (containers) and the NMSAP program isto run on a sparse root zone, install NMSAP on the global zone and on eachrequired sparse root zone.

2. Verify the basedir variable setting in the /var/sadm/install/admin/default file.

You must install NMSAP in the same base directory as the NetWorker clientsoftware. You can set the basedir variable in this file to one of three possiblevalues:

l If basedir=default, the system installs the software in the same directory asthe NetWorker client software.

l If basedir=ask, the system prompts you for the name of the base directorywhere the software will be installed.

l If basedir=/dirpath, the system installs the software in the /dirpathdirectory. The /dirpath must be the pathname of the NetWorker clientsoftware base directory as determined by the following pkgparamcommand:

pkgparam LGTOclnt BASEDIR3. Type the appropriate pkgadd command:

pkgadd -d /dir_pathname LGTOnmsap

where /dir_pathname is the complete pathname of the directory that containsthe LGTOnmsap package.


Installing NMSAP on Solaris systems 29

4. Complete the NMSAP installation, depending on the basedir variable setting inthe /var/sadm/install/admin/default file:

l If basedir=default in the file, type y when prompted whether to continue theinstallation.

The system installs the software in the same directory as the NetWorkerclient software.

l If basedir=ask in the file, perform the following steps:

a. When prompted for the pathname of the base directory, type the resultof the pkgparam LGTOclnt BASEDIR command that provides thepath of the NetWorker client software.

b. Type y when prompted whether to continue the installation.The system installs the software in the specified base directory.

Note

If you type an incorrect pathname, where the NetWorker client is notlocated, the installation displays an error and the software is installed in theincorrect directory. In this case, perform the following steps:

a. Uninstall the software by typing the pkgrm LGTOnmsap command.

b. Reinstall the software by typing the correct pathname at the firstpkgadd prompt.

l If basedir=/dirpath in the file, type y when prompted whether to continuethe installation.

The system installs the software in the specified /dirpath directory.

Note

If /dirpath is not the base directory where the NetWorker client software isinstalled, the installation displays an error and the software is installed in theincorrect directory. In this case, perform the following steps:

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.







Enabling the RMAN utilityIf you want to use Oracle RMAN software for backup and restore operations on aUNIX or Linux operating system, you must create a symbolic link to the NMSAPRMAN library file.

Procedure

1. Log in as the $ORACLE_HOME owner. For example, type the followingcommand:

su ORACLE_HOME_owner

2. Create a symbolic link to the RMAN libnworasap.xx library file by using oneof the following options:

l If you installed NMSAP in the default directory, type the appropriatecommands listed in the following table.

l If you installed NMSAP in a nondefault directory, perform one of thefollowing actions:

n Copy the libnworasap.xx library file to the default directory /usr/lib, and type the appropriate linking commands listed in the followingtable.

n Without copying the libnworasap.xx library file to the defaultdirectory /usr/lib, type the linking commands listed in the followingtable to link the libnworasap.xx file located in the nondefaultinstallation directory /relocation_path/lib.

Table 7 Commands to link and unlink the RMAN library file

Operating system Link or unlinkoperation

Install: create symbolic link Uninstall: remove symbolic link

AIX Create link cd $ORACLE_HOME/lib

ln -s /usr/lib/libnworasap.a libobk.a

Remove link cd $ORACLE_HOME/lib

rm libobk.a

HP Itanium Create link cd $ORACLE_HOME/lib

ln -s /usr/lib/libnworasap.so libobk.so


rm libobk.so

HP PA-RISC Create link cd $ORACLE_HOME/lib

ln -s /usr/lib/libnworasap.sl libobk.sl


rm libobk.sl


Enabling the RMAN utility 31

Table 7 Commands to link and unlink the RMAN library file (continued)

Operating system Link or unlinkoperation

Install: create symbolic link Uninstall: remove symbolic link

Linux x64 Create link cd $ORACLE_HOME/lib

If not relocated:


If relocated:

ln -s /relocation_path/lib/libnworasap.solibobk.so


rm libobk.so

Solaris x64

Solaris SPARC

Create link cd $ORACLE_HOME/lib



rm libobk.so

Uninstalling NMSAP on UNIX and Linux systemsBefore you uninstall NMSAP, you can save a copy of the parameter filetemplate, /etc/init*.utl, and configuration file template, /etc/nsrsapsv.cfg,supplied with NMSAP. The uninstall of NMSAP deletes these template files and anysettings you made in the files.

You can uninstall NMSAP on a UNIX or Linux system by removing any RMAN symboliclink, removing the hdbbackint or backint program, and using the appropriateuninstall procedure for the operating system.

Note

If you uninstall NMSAP in a cluster or multinode environment, you must perform theuninstall procedure on each required node.

Procedure

1. Ensure that no database backups or application backups are running.

2. Ensure that the NetWorker Remote Exec daemon, nsrexecd, is running.

Note

If the NetWorker Remote Exec daemon is not running during the uninstallation,the NMSAP wizard information (not the binary) is left on the local host.

3. If you enabled the RMAN feature, remove the symbolic link for the library file. Enabling the RMAN utility on page 31 provides details.



4. Log in as the root user on the NMSAP host.

5. Remove the required program file:

l On a SAP HANA server, remove the hdbbackint program file fromthe /usr/sap/SID/SYS/global/hdb/opt directory.

l On a SAP Oracle server, remove the backint program file from thedirectory where the SAP BR*Tools reside, forexample, /usr/sap/SID/SYS/exe/run.

6. Uninstall NMSAP by using the appropriate procedure for the operating systemas follows.

Note

You do not need to shut down a database to uninstall NMSAP.

Uninstalling NMSAP on AIXYou can uninstall NMSAP on an AIX system by running the installp command orthe SMIT GUI program.

Procedure

1. Ensure that you have completed the steps in Uninstalling NMSAP on UNIX andLinux systems on page 32 for the initial part of the uninstall procedure.

2. Use one of the following methods to uninstall NMSAP:

l Use the CLI program by typing the following command:

installp -u LGTOnmsap.rtel Use the SMIT GUI program:

a. Type the following smitty command:

smitty removeb. Select F4=List to display a list of the installed software packages.

c. Select the package to uninstall:

LGTOnmsap.rted. Set the PREVIEW Only option to No.

e. Press Enter to uninstall NMSAP.

f. Exit the SMIT program.

Uninstalling NMSAP on HP-UXYou can uninstall NMSAP on an HP-UX system by running the swremove command orGUI program.

Procedure


2. Use one of the following methods to uninstall NMSAP:

l Use the CLI program by typing the following command:

swremove NMSAP


Uninstalling NMSAP on AIX 33

l Use the swremove GUI program:

a. Type the following swremove command:

swremove -i NMSAPb. Select Actions > Remove (analysis).

c. When the system analysis is complete, click OK to complete the uninstall.

d. To confirm the uninstall, click Yes.

e. Set the PREVIEW Only option to No.

Uninstalling NMSAP on LinuxYou can install NMSAP on a Linux system by running the rpm command.

Procedure


2. Complete the appropriate uninstall procedure on Linux:

l To uninstall NMSAP only, type the following command:

rpm -e lgtonmsap

Note

You must uninstall the NetWorker client software after NMSAP.

l To uninstall both NMSAP and the NetWorker client, use one of the followingmethods:

n Type the following rpm command:

rpm -e lgtonmsap lgtoclntn Type the following separate commands in order:

rpm -e lgtonmsaprpm -e lgtoclnt

Uninstalling NMSAP on SolarisYou can uninstall NMSAP on a Solaris system by running the pkgrm command.

Procedure


Note

To uninstall NMSAP on Solaris zones, first uninstall NMSAP on the global zoneand then uninstall NMSAP on each required sparse root zone.

2. Type the following command:

pkgrm LGTOnmsap

3. Perform the appropriate task according to the basedir variable setting inthe /var/sadm/install/admin/default file:



l If basedir=default in the file, type y when prompted.

The system uninstalls the software from the directory that contains theNetWorker client software.

l If basedir=ask in the file, type the result of the pkgparam LGTOnmsapBASEDIR command when prompted for the pathname of the base directory.

The system uninstalls the software from the specified base directory.

l If basedir=/dirpath in the file, type y when prompted.

The system uninstalls the software from the specified /dirpath directory.


Uninstalling NMSAP on Solaris 35



CHAPTER 3

Microsoft Windows Installation


l Installing NMSAP on Microsoft Windows...........................................................38l Maintaining the installation on Microsoft Windows............................................ 39l Uninstalling NMSAP on Microsoft Windows.......................................................40

Microsoft Windows Installation 37

Installing NMSAP on Microsoft WindowsYou can install NMSAP on a Windows system by running the NMSAP Setup program,networkr\setup.exe.

Procedure


l You are logged in as an administrator.


l The nsrexecd.exe service is running. You can check the service status byrunning either Component Services or Task Manager.


2. Install NMSAP by using one of the following methods:

l Setup program method with installation wizard:

a. Run the NMSAP Setup program, networkr\setup.exe, and follow theinstructions in the installation wizard.

By default, the Setup program installs the NMSAP software in the samedirectory as the NetWorker client software.

Note

If the Setup program detects no NetWorker client program files, theprogram displays an error message and exits without installing NMSAP.

b. Perform the required task to install the RMAN component:

Note

Only install the RMAN component on a host that does not use NetWorkerModule for Databases and Applications (NMDA) or NetWorker Modulefor Oracle (NMO) software to protect data.

n For a new installation, select Install the Oracle RMAN component onthe Oracle RMAN support screen.

n For an update installation, select the NMSAP Oracle RMAN featureon the Custom Setup screen.

c. To exit the Setup program, click Finish.

When the installation completes, a message describes how to start thebackup configuration wizard. The EMC NetWorker Module for SAPAdministration Guide describes the wizard.

l Silent installation method:

a. At the command prompt, navigate to the folder where you extracted theNMSAP installation software, which contains the setup.exe program.

b. Run the setup.exe command with the appropriate command options:

setup.exe /S /v" /qn /l*v filename.log"



where filename.log is the name of the log file for the installation logmessages. The installation process creates the log file in the directorywhere you run setup.exe. When you omit /l*v filename.log, theinstallation process does not record any log messages.

The setup.exe program installs the NMSAP software in the samedirectory as the NetWorker client software.

Note

A silent installation always installs the NMSAP Oracle RMAN component.

3. Verify that the system Path environment variable includes the NetWorker clientinstallation 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 theNetWorker client installation directory.

Note

The NetWorker client directory pathname can include spaces. There cannot bespaces before or after the pathname.

4. If you installed NetWorker software for the first time or changed the systemPath variable, restart the Windows system and verify that any requireddatabase instances and services were restarted.


nsradmin.exe -p nsrexecdnsradmin> print type: NSR remote agent


Maintaining the installation on Microsoft WindowsYou can modify, repair, or remove an existing NMSAP installation on a MicrosoftWindows system by following the appropriate instructions.

Running the Setup program in maintenance modeProcedure

1. Log 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 15, and run the networkr\setup.exe program.


Maintaining the installation on Microsoft Windows 39

4. In the Welcome window, click Next.

5. In the Program Maintenance window, select the maintenance task to performand click Next to continue:

l Repair—Enables you to replace missing files or corrupted files in theNMSAP installation. Repairing an NMSAP Installation provides details.

l Remove—Enables you to remove the NMSAP software.

You can also use Add or Remove Programs in the Windows Control Panelto remove the components. Uninstalling NMSAP on Microsoft Windowsprovides details.

Repairing an NMSAP installationProcedure

1. Start the Setup program in maintenance mode. Running the Setup program inmaintenance mode on page 39 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 theinstallation. The Setup program reinstalls the NMSAP files as required.

4. In the InstallShield Wizard Completed dialog box, click Finish to exit thewizard.

The InstallShield Wizard Completed window displays a message about how tostart the NetWorker Client Configuration Wizard.

5. If you changed the system Path variable, restart the Windows system, andverify that any required database instances and services were restarted.

Uninstalling NMSAP on Microsoft WindowsBefore you uninstall NMSAP, you can save a copy of the parameter file template,NetWorker_install_directory\nsr\bin\init*.utl, and configuration filetemplate, NetWorker_install_directory\nsr\bin\insrsapsv.cfg,supplied with NMSAP. The uninstall of NMSAP deletes these template files and anysettings you made in the files.

You can uninstall NMSAP on a Windows system by removing the backint.exeprogram and by using the Setup program method or Windows Control Panel methodto uninstall the NMSAP software.

Note

If you uninstall NMSAP in a cluster, you must perform the uninstall procedure on eachnode of the cluster that contains NMSAP.

Procedure

1. Log in as the Windows system administrator on the NMSAP host.

2. Ensure that no database backups are running.

Note

You do not need to shut down a database to uninstall NMSAP.



3. Ensure that the NetWorker Remote Exec service, nsrexecd.exe, is running.

Note

If the NetWorker Remote Exec service is not running during the uninstallation,the NMSAP wizard information (not the binary) is left on the local host.

4. Remove the backint.exeprogram file from the folder where the SAPBR*Tools reside.

5. Uninstall NMSAP by using one of the following methods:

l Setup program method with installation wizard:

a. Run the networkr\setup.exe program as described in Running theSetup program in maintenance mode on page 39.

b. In the Program Maintenance window, select Remove and click Next.

c. In the Remove the Program window, click Remove.

l Silent uninstallation method:

a. At the command prompt, navigate to the networkr subfolder in thefolder where you extracted the NMSAP installation software. Thenetworkr subfolder contains the NetWorker Module for SAP.msifile.

b. Run the msiexec.exe command with the appropriate commandoptions:

msiexec /quiet /uninstall "NetWorker Module for SAP"

l Windows Control Panel method:

a. In the Windows Control Panel window, select either Add or RemovePrograms or Programs and Features, depending on the MicrosoftWindows version.

b. In the Add or Remove Programs window, select NetWorker Module forSAP and click Remove.


Uninstalling NMSAP on Microsoft Windows 41



Copyright © 2015 EMC Corporation. All rights reserved. Published in USA. 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. EMC², EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United States and other countries. All other trademarks used herein are the property of their respective owners. For the most up-to-date regulatory document for your product line, go to EMC Online Support (https://support.emc.com).
