networker module for sap 18.2 installation guide › en-us › collaterals › unauth › ... ·...

Dell EMC NetWorker Module for SAPVersion 18.2

Installation Guide302-005-294

REV 01

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

Published December 2018

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 Technologies, Dell, EMC, 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.

Dell EMCHopkinton, Massachusetts 01748-91031-508-435-1000 In North America 1-866-464-7381www.DellEMC.com

2 NetWorker Module for SAP 18.2 Installation Guide

5

7

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

NetWorker server software............................................................13NMC server software..................................................................... 13NetWorker Authentication Service.................................................13NetWorker storage node software................................................. 13NetWorker client software............................................................. 13NMSAP software........................................................................... 14SAP BR*Tools software................................................................. 14

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

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

Installation road maps..................................................................................17Road map to install or update NMSAP on an SAP host...................17Road map to update NMSAP with the Package Manager...............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.......................................................................... 30Uninstalling NMSAP on UNIX and Linux systems........................................ 31

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

Microsoft Windows Installation 35Installing NMSAP on Microsoft Windows................................................... 36Repairing the installation on Microsoft Windows........................................ 38Uninstalling NMSAP on Microsoft Windows............................................... 38

Tables

Preface

Chapter 1

Chapter 2

Chapter 3

CONTENTS

NetWorker Module for SAP 18.2 Installation Guide 3

CONTENTS


Revision history............................................................................................................ 7Style conventions......................................................................................................... 8Typical hosts and software in the NMSAP 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.................................................... 30

1234567

TABLES


TABLES


Preface

As part of an effort to improve product lines, periodic revisions of software andhardware are released. Therefore, all versions of the software or hardware currently inuse might not support some functions that are described in this document. Theproduct release notes provide the most up-to-date information on product features.

If a product does not function correctly or does not function as described in thisdocument, contact a technical support professional.

Note

This document was accurate at publication time. To ensure that you are using thelatest version of this document, go to the Support website https://www.dell.com/support.

PurposeThis document describes how to install, update, and uninstall the NetWorker Modulefor SAP (NMSAP) version 18.2.

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

01 December 14, 2018 Initial release of this document for NMSAP version 18.2.

Related documentationYou can find additional publications for this product release and related NetWorkerproducts at the Support website.

The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhomeprovides details about supported environments and platforms.

Special notice conventions that are used in this documentThe following conventions are used for special notices:

NOTICE

Identifies content that warns of potential business or data loss.


https://www.dell.com/support


https://elabnavigator.emc.com/eln/elnhome

Note

Contains information that is incidental, but not essential, to the topic.

Typographical conventionsThe following type style conventions are used in this document:

Table 2 Style conventions

Bold Used for interface elements that a user specifically selects or clicks,for example, names of buttons, fields, tab names, and menu paths.Also used for the name of a dialog box, page, pane, screen area withtitle, table label, and window.

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, file name extensions, prompts, andsyntax

l Commands and options

Monospace italic Used for variables.

Monospace bold Used for user input.

[ ] Square brackets enclose optional values.

| Vertical line indicates alternate selections. The vertical line means orfor the alternate selections.

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

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

You can use the following resources to find more information about this product,obtain support, and provide feedback.

Where to find product documentation

l https://www.dell.com/support

l https://community.emc.com

Where to get supportThe Support website https://www.dell.com/support provides access to productlicensing, documentation, advisories, downloads, and how-to and troubleshootinginformation. The information can enable you to resolve a product issue before youcontact Support.

To access a product-specific page:

1. Go to https://www.dell.com/support.

2. In the search box, type a product name, and then from the list that appears, selectthe product.

KnowledgebaseThe Knowledgebase contains applicable solutions that you can search for either bysolution number (for example, KB000xxxxxx) or by keyword.

Preface



https://community.emc.com



To search the Knowledgebase:


2. On the Support tab, click Knowledge Base.

3. In the search box, type either the solution number or keywords. Optionally, youcan limit the search to specific products by typing a product name in the searchbox, and then selecting the product from the list that appears.

Live chatTo participate in a live interactive chat with a support agent:


2. On the Support tab, click Contact Support.

3. On the Contact Information page, click the relevant support, and then proceed.

Service requestsTo obtain in-depth help from Licensing, submit a service request. To submit a servicerequest:


2. On the Support tab, click Service Requests.

Note

To create a service request, you must have a valid support agreement. For detailsabout either an account or obtaining a valid support agreement, contact a salesrepresentative. To get the details of a service request, in the Service RequestNumber field, type the service request number, and then click the right arrow.

To review an open service request:


2. On the Support tab, click Service Requests.

3. On the Service Requests page, under Manage Your Service Requests, clickView All Dell Service Requests.

Online communitiesFor peer contacts, conversations, and content on product support and solutions, go tothe Community Network https://community.emc.com. Interactively engage withcustomers, partners, and certified professionals online.

How to provide feedbackFeedback helps to improve the accuracy, organization, and overall quality ofpublications. You can send feedback to [email protected].

Preface






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 softwareNetWorker Module for SAP (NMSAP) is a NetWorker add-on module that providesdata protection services for SAP HANA and SAP Oracle data.

Note

The term SAP Oracle in this document refers to an SAP environment with an Oracledatabase. The term SAP server refers to either a SAP HANA server or a SAP Oracleserver.Before you install NMSAP, install both the NetWorker base client and extended clientsoftware packages on the SAP server host.

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

Table 3 Typical hosts and software in the NMSAP environment

Host Required software

NetWorker server l NetWorker base client

l NetWorker extended client

l NetWorker storage node

l NetWorker server

l NetWorker Authentication Service

NetWorker storage node l NetWorker base client


l NetWorker storage node

NetWorker Management Console (NMC)server

l NetWorker base client


l NMC server

Each SAP server (NMSAP host) l SAP database server

l NetWorker base client


l NMSAP

l On SAP Oracle server:

n SAP BR*Tools

n For split-mirror backups, compatiblereplication management software forBR*Tools

Review the following software descriptions to plan the installation requirements.

The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhomeprovides details about the operating systems and software versions that are requiredfor NMSAP services.

Getting Started



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

NetWorker server softwareInstall a supported version of the NetWorker server software on the NetWorker serverhost. The NetWorker server host is usually a separate host, but the server host canalso be the NMSAP host.

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

Use a supported version of the NetWorker server that works with the NetWorkerclient version installed on the NMSAP host. The operating systems that are used mustsupport the NetWorker server version that is used.

NMC server softwareInstall a supported version of the NMC software on a network host to provide a userinterface with the NetWorker software and NMSAP.

NetWorker Authentication ServiceThe NetWorker Authentication Service provides centralized token-basedauthentication to components in the NetWorker environment. NetWorker uses theNetWorker Authentication Service to authenticate NMC and CLI users. You canconfigure the NetWorker Authentication Service to use a local user database orexternal identity providers (LDAP and AD) for authentication.

The NetWorker Installation Guide provides details on the installation and configurationrequirements for the NetWorker Authentication Service software.

NetWorker storage node softwareInstall a supported version of the NetWorker storage node software on the host thatmanages the backup storage devices. You can configure a NetWorker storage node onthe same host as the NetWorker server, on the same host as NMSAP to supportbackups to a local device, or on a separate host.

Use a supported version of the NetWorker storage node that works with theNetWorker client version installed on the NMSAP host and with the NetWorkerserver. The operating systems that are used must support the NetWorker storagenode version.

NetWorker client softwareInstall a supported version of the NetWorker client software on the supported SAPserver host before you install NMSAP on that host. Install both the NetWorker baseclient and extended client software packages.

On an SAP Oracle server, NMSAP can use the NetWorker Snapshot Management(NSM) feature to provide a high-availability storage environment for snapshotbackups and restores. To enable the snapshot operations, install the NetWorker baseclient and extended client software packages on both of the following hosts:

l NMSAP host

l A mount host

Getting Started

NetWorker server software 13

Note

Some operating systems and volume managers require that you configure a mounthost on a separate host from the database host. For example, Veritas VolumeManager (VxVM) and Linux Logical Volume Manager (LVM) do not support theuse of the database host as the mount host. The NetWorker Snapshot ManagementIntegration Guide provides a full list of restrictions and details.

The NetWorker extended client package must be installed to enable the followingfunctionality on the host:

l NSM

l CLI utilities for server reporting and administration, such as mminfo, nsradmin,and nsrinfo

l Cluster integration scripts

l Custom script integration tools (pre/post save)

l Audit log

l Cloning and staging

l ProtectPoint for VMAX

l ProtectPoint for RecoverPoint

The NetWorker Installation Guide provides details about the NetWorker base andextended client packages.

NMSAP softwareInstall NMSAP on a supported SAP server.

For split-mirror backups on an SAP Oracle server, also install NMSAP on the mounthost.

SAP BR*Tools softwareOn an SAP Oracle server, install a supported SAP BR*Tools version. The SAPdocumentation describes the supported operating systems.

If you install NMSAP in a non-English environment, ensure that you meet the followingrequirements:

l The host operating system supports internationalization (I18N).

l The SAP Oracle software and BR*Tools software provide the required NationalLanguage Support (NLS) or globalization support.

l The SAP Oracle software and BR*Tools software are configured with the requirednon-ASCII character set.

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

DocumentsYou can find the required information in the following documents:

Getting Started


l NetWorker Module for SAP Installation Guide for the existing version, if you areupdating from a previous NMSAP version to NMSAP 18.2

l NetWorker Module for SAP Version 18.2 Release Notes

l NetWorker Module for SAP Version 18.2 Administration Guide

l NetWorker Administration Guide for the supported NetWorker release

l NetWorker E-LAB Navigator

Installation mediaUse one of the following installation media:

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

l If you download the software, use the Support website

License enablersEnabler codes or licenses activate the functionality of the NMSAP software and aresold separately.

Note

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

The NetWorker Licensing Guide describes licensing.

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

Accessing NMSAP from the DVD mediaThe DVD with the NMSAP software is in the Information Protection and AvailabilityProduct Families Media Kit. The kit contains the software and online documentationfor related products.

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

Procedure

1. Log in to the host as the root user on UNIX or Linux, or as the localadministrator user on Windows.

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_point

l 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 NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhomeprovides 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

Linux Power PC (64-bit big-endian)

/mount_point/sap/linuxppc64_64

Linux Power PC (64-bit little-endian)

/mount_point/sap/linuxppc64le_64

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

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

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

Accessing NMSAP from the websiteYou can download the NMSAP software package from the Support website andextract the installation files from the package to a temporary local directory.

Procedure

1. Log in to the host as the root user on UNIX or Linux, or as the localadministrator user on Windows.

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 that are extracted from the package.

3. Go to the Support website at https://support.emc.com.

The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhomeprovides details about the operating systems and the database and applicationsoftware that NMSAP supports.

On the Downloads page, select the NMSAP software for download:

a. Select DOWNLOADS.

The Downloads page appears.

b. In the Products field, type NetWorker Module for SAP.

4. Download the NMSAP 18.2 software file to the temporary directory that youcreated.

5. 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.gz

Getting Started


https://support.emc.com


b. Extract the software from the uncompressed, tarred file:

tar -xvpBf file_name.tar

The extraction lists the distribution software files on the screen.

c. Go to the directory that contains the NMSAP installation files.

l On Windows:

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

b. Go to the win_x64 directory.

Installation road mapsFollow the proper road map to install NMSAP:

l Road map to install or update NMSAP on an SAP host

l Road map to update NMSAP remotely with the Package Manager

l Road map to perform the post-installation procedures

Road map to install or update NMSAP on an SAP hostTo install or update NMSAP on an SAP host in a supported configuration, completethe procedure as follows.

You can install or update NMSAP in either of the following configurations:

l Single host

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

Note

Install the NetWorker client and NMSAP software on each node host that performsbackup and recovery operations in a cluster, Oracle RAC, or SAP HANA scale-outmultinode environment.

The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhomeprovides details about the supported software versions and supported cluster ormultinode environments.

Procedure

1. Review the Installation checklists on page 14 and verify that you have therequired documentation, installation media, 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 the database during the installation.

Getting Started

Installation road maps 17


5. Ensure that you save a copy of the original parameter file template (init.utl)and original configuration file template (nsrsapsv.cfg) that are supplied withNMSAP before you uninstall a previous NMSAP version. The template files arein 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 and any settingsthat you made in the files.

6. Uninstall any previous version of NMSAP according to the instructions in theinstallation guide for the module version.

NOTICE

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

7. 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

Linux service networker start

Solaris /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.

8. Install NMSAP by following the instructions for the operating system in therequired chapter:

l UNIX and Linux Installation on page 25

l Microsoft Windows Installation on page 35

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

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

Road map to update NMSAP with the Package ManagerYou can update NMSAP on one or more NMSAP hosts by using the Package Managerfeature from a centralized NetWorker server. You can perform the update with thePackage Manager or the nsrpush command. When you use the Package Manager,NMSAP must not be installed on the NetWorker server.

Note

Cluster environments do not support updates with the Package Manager.

The NetWorker Updating from a Previous Release Guide describes the PackageManager, including the following procedures:

l Verifying software that is installed on NetWorker clients.

l Performing and monitoring the updates.

l Managing the repository of media kits that the Package Manager uses to installthe software from the NetWorker server.

Note

To add an NMSAP release to the Package Manager repository, follow theinstructions in the NetWorker Updating from a Previous Release Guide. If you use thensrpush command, type the complete product name as “NetWorker Modulefor SAP” with the quotation marks.

Complete the following steps to update NMSAP with the Package Manager.

Procedure

1. Review the Installation checklists on page 14.

2. Ensure that you meet the following requirements:

l NMSAP 4.5 or later is installed on the NMSAP host, and the operatingsystems support the Package Manager. You cannot perform an update ofearlier NMSAP releases.

Getting Started

Road map to update NMSAP with the Package Manager 19

The NetWorker Updating from a Previous Release Guide at the Supportwebsite describes the operating systems that support the Package Managerfeature on the NMSAP host.

l The NMSAP client host contains a supported version of the NetWorkerclient software.

l The user that performs the update is both an NMC administrator and amember of the application administrator's user group on the NetWorkerserver.

3. Before you start an update, ensure that all backups and restores are stopped onthe client to be updated.

Note

The Package Manager might stop and restart the NetWorker client nsrexecddaemon or service during the installation.

4. On the NetWorker server, perform the update of the NMSAP client by usingthe Package Manager feature or the nsrpush command.

The NetWorker Updating from a Previous Release Guide provides moreinformation.

5. Perform all the required post-installation procedures on the client host. Roadmap 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 with Package Manager, complete the following post-installationprocedures.

Procedure

1. Enable the NMSAP backup program:

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

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

Note

If you installed NMSAP in a nondefault directory, then specify the path tothe sbin 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

Create the opt subdirectory manually if it does not exist. SAP HANArequires the hdbbackint program to be accessible fromthe /usr/sap/SID/SYS/global/hdb/opt directory.Ensure that the SIDadm operating system user has executable permissionson the hdbbackint file, where SID is the system ID of the SAP HANAsystem.

l On an SAP Oracle server, perform one 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 Create a symbolic link that points from where the SAP BR*Tools resideto /usr/sbin/backint (UNIX or Linux only).

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 NetWorker Licensing Guide describes licensing and enabling of software.

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

3. If you perform SAP split-mirror backup operations on an SAP Oracle server,install and enable the required replication management software.

Install NMSAP on both the production host and the mount (data mover) host.Refer to the replication management software documentation for additionaldetails.

4. 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

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 or

Getting Started

Road map to post-installation procedures 21

nsrexecd.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

5. 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.

6. Optionally, register the NMSAP product information with the SAP SystemLandscape Directory (SLD). Registering NMSAP product information with theSAP SLD repository (optional) on page 23 provides details.

7. 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

8. On Windows, to ensure the success of backups and restores, completed thefollowing tasks:

l Restart the database services.

l Close and reopen any command prompt window or console that will be usedto run backups or restores.

9. Configure the NMSAP software.

The NetWorker Module for SAP Administration Guide provides details.

Getting Started


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 the installation with the SAP System Landscape Directory(SLD).

Procedure

1. Locate the nwsldreg.xml file, and open the file in a text editor. Do not use aword processor.

The NMSAP installation stores a copy of this file, which has been preconfiguredwith the NMSAP information except for the 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 -port http_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 that is configured for HTTP connections on the SLDhost.

If you have configured the HTTP server to use HTTPS, add the option -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.................................................................................. 30l Uninstalling NMSAP on UNIX and Linux systems................................................31

UNIX and Linux Installation 25

Installing NMSAP on AIX systemsInstall NMSAP on an AIX system by running the installp command line interface(CLI) program or the AIX System Management Interface Tool (SMIT), which is agraphical 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_pathname is the complete pathname of the correct directorythat contains the installation software as described in Accessing the NMSAPsoftware on page 15.

To verify that the installation succeeded, type the following command:

lslpp -L all | grep -i lgtonmsap

If the lslpp command output includes LGTOnmsap.rte, the installationwas successful.

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

a. Type the following command:

smitty install_latest

b. In the Entry Field, type the location of the NMSAP installation softwareas the complete pathname of the directory that is described in Accessingthe NMSAP 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. To display the list of the NMSAP software packages, select F4=List.

f. To install the NMSAP software, select LGTOnmsap.rte.

g. Set the Preview Only option to No.

h. Select Install and Update Software.



i. To begin the installation, press Enter.

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

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 systemsInstall NMSAP on an HP-UX system by using the swinstall command to run thecommand line interface (CLI) or the graphical user interface (GUI) program.

Procedure






2. To run either the CLI or GUI program, type the swinstall command:

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.

Complete the installation steps in the GUI program:

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


Installing NMSAP on HP-UX systems 27

b. To continue the installation, click OK.

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 Linux systemsInstall NMSAP on a Linux system by running the rpm command. Install NMSAP in thesame directory as the NetWorker client software.

Procedure






2. To install NMSAP, type the required rpm command, for example:

l On Linux x64:

rpm -ivh lgtonmsap-18.2.0.0-1.x86_64.rpm

l On Linux Power PC 64-bit big-endian:

rpm -ivh lgtonmsap-18.2.0.0-1.ppc64.rpm

l On Linux Power PC 64-bit little-endian:

rpm -ivh lgtonmsap-18.2.0.0-1.ppc64le.rpm

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

rpm -aq | grep lgto



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

lgtoclnt-18.2.0.0-1lgtonmc-18.2.0.0-1





Installing NMSAP on Solaris systemsInstall NMSAP on a Solaris system by running the pkgadd command.

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. Type the required pkgadd command:

pkgadd -d /dir_pathname LGTOnmsap

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

3. When prompted to continue the installation, type y.

The system installs the software in the same directory as the NetWorker clientsoftware.



Installing NMSAP on Solaris systems 29




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

Note

To enable NMSAP operations with RMAN, you do not need to install the NetWorkerModule for Databases and Applications (NMDA) software on the system.

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 required commandsthat are 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 required linking commands that are listed in thefollowing table.

n Without copying the libnworasap.xx library file to the defaultdirectory /usr/lib, type the linking commands that are listed in thefollowing table to link the libnworasap.xx file that is located in thenondefault installation directory /relocation_path/lib.

Table 7 Commands to link and unlink the RMAN library file

Operatingsystem

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



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

Operatingsystem

Link or unlinkoperation

Install: create symbolic link Uninstall: remove symbolic link

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

Linux x64 Create link cd $ORACLE_HOME/lib

If not relocated:ln -s /usr/lib/libnworasap.so libobk.so

If relocated:ln -s /relocation_path/lib/libnworasap.solibobk.so


rm libobk.so

Solaris AMD

Solaris SPARC

Create link cd $ORACLE_HOME/lib

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


rm libobk.so

Uninstalling NMSAP on UNIX and Linux systemsBefore you uninstall NMSAP, save a copy of the parameter file template, /etc/init.utl, and configuration file template, /etc/nsrsapsv.cfg, supplied withNMSAP. The uninstall of NMSAP deletes these template files and any settings youmade in the files.

You uninstall NMSAP on a UNIX or Linux system by removing any RMAN symbolic link,removing the hdbbackint or backint program, and by using the required uninstallprocedure for the operating system.


Uninstalling NMSAP on UNIX and Linux systems 31

Note

If you uninstall NMSAP in a cluster or multinode environment, perform the uninstallprocedure on each required node.

Procedure

1. Ensure that no backups or restores 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 30 provides details.

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

5. Remove the required program file or symbolic link:

l On an SAP HANA server, remove the hdbbackint program file or symboliclink from the /usr/sap/SID/SYS/global/hdb/opt directory.

l On an SAP Oracle server, remove the backint program file or symbolic linkfrom the directory where the SAP BR*Tools reside, forexample, /usr/sap/SID/SYS/exe/run.

6. Uninstall NMSAP by using the required procedure for the operating system asfollows.

Note

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

Uninstalling NMSAP on AIXUninstall NMSAP on an AIX system by running the installp command or the SMITGUI program.

Procedure

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

2. To uninstall NMSAP, use one of the following methods:

l Use the CLI program by typing the following command:

installp -u LGTOnmsap.rte

l Use the SMIT GUI program:

a. Type the following smitty command:

smitty remove

b. To display a list of the installed software packages, select F4=List.



c. Select the package to uninstall:

LGTOnmsap.rte

d. Set the PREVIEW Only option to No.

e. To uninstall NMSAP, press Enter.

f. Exit the SMIT program.

Uninstalling NMSAP on HP-UXUninstall NMSAP on an HP-UX system by using the swinstall command to run thecommand line interface (CLI) or the graphical user interface (GUI) program.

Procedure


2. To uninstall NMSAP, use one of the following methods:

l Use the CLI program by typing the following command:

swremove NMSAP

l Use the swremove GUI program:

a. Type the following swremove command:

swremove -i NMSAP

b. Select Actions > Remove (analysis).

c. To complete the uninstall when the system analysis is complete, click OK.

d. To confirm the uninstall, click Yes.

Uninstalling NMSAP on LinuxUninstall NMSAP on a Linux system by running the rpm command.

Procedure


2. Complete the required 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, type the followingcommand:

rpm -e lgtonmsap lgtoxtdclnt lgtoclnt


Uninstalling NMSAP on HP-UX 33

Uninstalling NMSAP on SolarisUninstall NMSAP on a Solaris system by running the pkgrm command.

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. When prompted, type y.

The software is uninstalled from the directory that contains the NetWorkerclient software.



CHAPTER 3

Microsoft Windows Installation


l Installing NMSAP on Microsoft Windows...........................................................36l Repairing the installation on Microsoft Windows................................................38l Uninstalling NMSAP on Microsoft Windows.......................................................38

Microsoft Windows Installation 35

Installing NMSAP on Microsoft WindowsInstall NMSAP on a Windows system by running the NMSAP Setup program,win_x64\networkr\NMSAP.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, win_x64\networkr\NMSAP.exe,and follow the instructions in the installation wizard.

By default, the NMSAP Setup program installs the NMSAP program filesin the same directory as the NetWorker client program files,NetWorker_install_directory\bin.

Note

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

b. To install the RMAN component, perform the required task:

Note

Only install the RMAN component on a host that does not use NetWorkerModule for Databases and Applications (NMDA) 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 appears about how to startthe backup configuration wizard. The NetWorker Module for SAPAdministration Guide describes the wizard.

l Silent installation method:

Run the NMSAP.exe command with the appropriate command options:

NMSAP.exe <installation_options>

where <installation_options> includes the following options:



n /s /q suppresses all the UI output.

n /passive displays the progress bar only during the installation.

n /repair runs a repair or (if the software is not installed) an installation.

n /l <pathname> specifies the log file pathname. Enclose <pathname> indouble quotes if it includes a space. The default directory for the log fileis C:\users\username\AppData\Local\temp.

n EnableRMAN=1 installs the RMAN component during the installation.This option sets the EnableRMAN parameter to 1. The default value ofthe parameter is 0.

Note

Only install the RMAN component on a host that does not use NMDA toprotect data.

For example, the following command performs a silent NMSAP installationthat installs the RMAN component and logs messages in the C:\ProgramFiles\EMC NetWorker\nsr\logs\nmsap_installation.log file:

NMSAP.exe /s /q /l "C:\Program Files\EMC NetWorker\nsr\logs\nmsap_installation.log" EnableRMAN=1

3. Verify that the system Path environment variable includes the NetWorker clientinstallation directory. For example:

a. Browse to Control Panel > System > Advanced System Settings.

b. On the Advanced tab, click Environment Variables.

c. In the System Variables section, verify the Path variable. If required, addthe NetWorker 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



Installing NMSAP on Microsoft Windows 37

Repairing the installation on Microsoft WindowsTo repair an NMSAP installation on a Microsoft Windows system, complete thefollowing steps.

Procedure

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


3. Go to the directory that contains the NMSAP installation files as described in Accessing the NMSAP software on page 15.

4. Run the win_x64\networkr\NMSAP.exe program.

5. In the Welcome window, click Next.

6. In the Program Maintenance dialog box, select Repair, and then click Next.

7. To begin the installation, in the Ready to Repair the Program dialog box, clickInstall. The Setup program reinstalls the NMSAP files as required.

8. To exit the wizard, in the Installation Wizard Completed dialog box, clickFinish.

The Installation Wizard Completed dialog box displays a message about howto start the NetWorker Client Configuration Wizard. The NetWorker Module forSAP Version 18.2 Administration Guide describes the configuration wizard.

9. If you changed the system Path variable, restart the Windows system, and thenverify that any required database instances and services are restarted.

Uninstalling NMSAP on Microsoft WindowsBefore you uninstall NMSAP, 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.

Uninstall NMSAP on a Windows system by removing the backint.exe program andby using the Setup program method or Windows Control Panel method to uninstall theNMSAP software.

Note

If you uninstall NMSAP in a cluster, then perform the uninstall procedure on each nodeof the cluster that contains NMSAP.

Procedure

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


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.exe program 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. Go to the directory that contains the NMSAP installation files asdescribed in Accessing the NMSAP software on page 15, and then runthe win_x64\networkr\NMSAP.exe program.

b. In the Program Maintenance window, select Remove, and then clickNext.

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

l Silent uninstallation method:

Run the NMSAP.exe command with the appropriate command options:

NMSAP.exe /uninstall <uninstallation_options>

where <uninstallation_options> includes the following options:

n /s /q suppresses all the UI output.

n /l <pathname> specifies the log file pathname. Enclose <pathname> indouble quotes if it includes a space. The default directory for the log fileis C:\users\username\AppData\Local\temp.

For example, the following command performs a silent NMSAP uninstallationthat logs messages in the C:\Program Files\EMC NetWorker\nsr\logs\nmsap_uninstallation.log file:

NMSAP.exe /uninstall /s /q /l "C:\Program Files\EMC NetWorker\nsr\logs\nmsap_uninstallation.log"

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 39