Dell EMC NetWorker Module for SAP 19.2 Installation Guide · 2020-07-31 · Note: The term SAP...

Dell EMC NetWorker Module for SAPVersion 19.2

Installation GuideREV 01

November 2019

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

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 Dell EMC NetWorker Module for SAP 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....................................................................... 14SAP host agent 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 SLD repository(optional)............................................................................................. 22

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............................................................ 32Uninstalling NMSAP on Linux...............................................................33Uninstalling NMSAP on Solaris.............................................................33

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

Tables

Preface

Chapter 1

Chapter 2

Chapter 3

CONTENTS

Dell EMC NetWorker Module for SAP 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........................................................................................21Commands 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 and hardware arereleased. Therefore, all versions of the software or hardware currently in use might not supportsome functions that are described in this document. The product release notes provide the mostup-to-date information on product features.

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

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

Purpose

This document describes how to install, update, and uninstall the NetWorker Module for SAP(NMSAP) version 19.2.

Audience

This document is intended for system administrators who are responsible for installing NMSAP andmaintaining 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 Oracle databasebackup and recovery

l Backup and recovery procedures

l Disaster recovery procedures

Revision history

The following table presents the revision history of this document.

Table 1 Revision history

Revision Date Description

01 November 15, 2019 Initial release of this document for NMSAP version 19.2.

Related documentation

You can find additional publications for this product release and related NetWorker products at theSupport website.

The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhome provides detailsabout supported environments and platforms.

Special notice conventions that are used in this document

The following conventions are used for special notices:

NOTICE Identifies content that warns of potential business or data loss.

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

Typographical conventions

The following type style conventions are used in this document:


https://www.dell.com/support

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

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 support

The Support website https://www.dell.com/support provides access to product licensing,documentation, advisories, downloads, and how-to and troubleshooting information. Theinformation can enable you to resolve a product issue before you contact 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, select theproduct.

Knowledgebase

The Knowledgebase contains applicable solutions that you can search for either by solutionnumber (for example, KB000xxxxxx) or by keyword.

To search the Knowledgebase:


2. On the Support tab, click Knowledge Base.

Preface



https://community.emc.com




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

Live chat

To 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 requests

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


2. On the Support tab, click Service Requests.

Note: To create a service request, you must have a valid support agreement. For details abouteither an account or obtaining a valid support agreement, contact a sales representative. Toget the details of a service request, in the Service Request Number field, type the servicerequest 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, click View All DellService Requests.

Online communities

For peer contacts, conversations, and content on product support and solutions, go to theCommunity Network https://community.emc.com. Interactively engage with customers, partners,and certified professionals online.

How to provide feedback

Feedback helps to improve the accuracy, organization, and overall quality of publications. You cansend 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


Required softwareNetWorker Module for SAP (NMSAP) is a NetWorker add-on module that provides dataprotection 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 Oracle server.Before you install NMSAP, install both the NetWorker base client and extended client softwarepackages on the SAP server host.

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

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 HANA server with HANA 2.0 orlater:

n SAP host agent (installed manually)

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/elnhome provides detailsabout the operating systems and software versions that are required for 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 server host. TheNetWorker server host is usually a separate host, but the server host can also be the NMSAP host.

You might require specific NetWorker server versions to support specific NMSAP features asdescribed in the NMSAP release notes.

Use a supported version of the NetWorker server that works with the NetWorker client versioninstalled on the NMSAP host. The operating systems that are used must support the NetWorkerserver version that is used.

NMC server softwareInstall a supported version of the NMC software on a network host to provide a user interface withthe NetWorker software and NMSAP.

NetWorker Authentication ServiceThe NetWorker Authentication Service provides centralized token-based authentication tocomponents in the NetWorker environment. NetWorker uses the NetWorker AuthenticationService to authenticate NMC and CLI users. You can configure the NetWorker AuthenticationService to use a local user database or external identity providers (LDAP and AD) forauthentication.

The NetWorker Installation Guide provides details on the installation and configuration requirementsfor the NetWorker Authentication Service software.

NetWorker storage node softwareInstall a supported version of the NetWorker storage node software on the host that manages thebackup storage devices. You can configure a NetWorker storage node on the same host as theNetWorker server, on the same host as NMSAP to support backups to a local device, or on aseparate host.

Use a supported version of the NetWorker storage node that works with the NetWorker clientversion installed on the NMSAP host and with the NetWorker server. The operating systems thatare used must support the NetWorker storage node version.

NetWorker client softwareInstall a supported version of the NetWorker client software on the supported SAP server hostbefore you install NMSAP on that host. Install both the NetWorker base client and extended clientsoftware packages.

On an SAP Oracle server, NMSAP can use the NetWorker Snapshot Management (NSM) featureto provide a high-availability storage environment for snapshot backups and restores. To enablethe snapshot operations, install the NetWorker base client and extended client software packageson both of the following hosts:

l NMSAP host

l A mount hostNote: Some operating systems and volume managers require that you configure a mounthost on a separate host from the database host. For example, Veritas Volume Manager(VxVM) and Linux Logical Volume Manager (LVM) do not support the use of the database

Getting Started


host as the mount host. The NetWorker Snapshot Management Integration Guide provides afull list of restrictions and details.

The NetWorker extended client package must be installed to enable the following functionality onthe host:

l NSM

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

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 and extended clientpackages.

NMSAP softwareInstall NMSAP on a supported SAP server.

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

SAP BR*Tools softwareOn an SAP Oracle server, install a supported SAP BR*Tools version. The SAP documentationdescribes 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 National LanguageSupport (NLS) or globalization support.

l The SAP Oracle software and BR*Tools software are configured with the required non-ASCIIcharacter set.

SAP host agent softwareOn an SAP HANA server with HANA 2.0 or later, you must manually install the SAP host agentpackage.

The SAP documentation provides more details about the installation of the SAP host agentpackage.

Installation checklistsReview the following checklists to ensure that you have the required materials for the NMSAPinstallation 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 are updating from aprevious NMSAP version to NMSAP 19.2

l NetWorker Module for SAP Version 19.2 Release Notes

l NetWorker Module for SAP Version 19.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 Media Kit

l If you download the software, use the Support website

License enablersEnabler codes or licenses activate the functionality of the NMSAP software and are soldseparately.

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 Availability ProductFamilies Media Kit. The kit contains the software and online documentation for related products.

About this task

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

Procedure

1. Log in to the host as the root user on UNIX or Linux, or as the local administrator user onWindows.

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/elnhome providesdetails about the operating systems, database software, and application software thatNMSAP supports.

Getting Started



Table 4 Access the directory that contains the NMSAP software

Operating system (NMSAPbitness)

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 and extract theinstallation 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 local administrator user onWindows.

2. Create a temporary installation download directory in a local file system with sufficient freedisk space to contain both the downloaded software package and the software installationfiles 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/elnhome providesdetails about the operating systems and the database and application software that NMSAPsupports.

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 19.2 software file to the temporary directory that you created.

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

l On UNIX or Linux:

a. Uncompress the downloaded package by typing the gunzip command with thefile_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, nmsap192_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, complete the procedureas follows.

About this task

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

The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhome provides detailsabout the supported software versions and supported cluster or multinode environments.

Procedure

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

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

3. Access the NMSAP software as described in Accessing the NMSAP software on page 15and 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 not need to shutdown the database during the installation.

5. Ensure that you save a copy of the original parameter file template (init.utl) and originalconfiguration file template (nsrsapsv.cfg) that are supplied with NMSAP before youuninstall a previous NMSAP version. The template files are in the following directory:

Getting Started



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 the installationguide 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 Exec daemon,nsrexecd, is running on UNIX or Linux, or the NetWorker Remote Exec 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 as root, and typethe 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 the following 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.

Note: If you do not start the NetWorker Remote Exec daemon or service before theNMSAP installation, then the automatic registration of the NMSAP configuration wizardmight not occur and the wizard might fail to detect if NMSAP is installed. Road map topost-installation procedures on page 20 provides details.

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

l UNIX and Linux Installation on page 25

l Microsoft Windows Installation on page 35

Getting Started


After the software installation completes, a message appears about how to start theNMSAP scheduled backup configuration wizard. The NetWorker Module for SAPAdministration Guide describes the wizard.

9. Perform all the required post-installation procedures. Road map to post-installationprocedures 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 Manager featurefrom a centralized NetWorker server. You can perform the update with the Package Manager orthe nsrpush command. When you use the Package Manager, NMSAP must not be installed onthe NetWorker server.

About this task

Note: Cluster environments do not support updates with the Package Manager.

The NetWorker Updating from a Previous Release Guide describes the Package Manager, includingthe 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 install the softwarefrom 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 Module for 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 operating systems supportthe Package Manager. You cannot perform an update of earlier NMSAP releases.

The NetWorker Updating from a Previous Release Guide at the Support website describesthe operating systems that support the Package Manager feature on the NMSAP host.

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

l The user that performs the update is both an NMC administrator and a member of theapplication administrator's user group on the NetWorker server.

3. Before you start an update, ensure that all backups and restores are stopped on the client tobe 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 using the PackageManager feature or the nsrpush command.

The NetWorker Updating from a Previous Release Guide provides more information.

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

Getting Started


Road map to post-installation proceduresAfter you have installed or updated NMSAP, either directly on a local host or by remote installationwith Package Manager, complete the following post-installation procedures.

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 binary installationdirectory (for example, /usr/sbin) or the /relocation_path/sbin installationdirectory (Linux) to the /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 program file.

Note: Create the opt subdirectory manually if it does not exist. SAP HANA requiresthe hdbbackint program to be accessible from the /usr/sap/SID/SYS/global/hdb/opt directory.Ensure that the SIDadm operating system user has executable permissions on thehdbbackint file, where SID is the system ID of the SAP HANA system.

l On an SAP Oracle server, perform one of the following tasks:

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

n Create a symbolic link that points from where the SAP BR*Tools reside to /usr/sbin/backint (UNIX or Linux only).

n For BR*Tools 7.10 or later, set util_path=full path to directory containing backint inthe BR*Tools configuration file, initDBSID.sap.

2. If you are installing NMSAP for the first time on the host, register and enable NMSAP towork 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 to reenable thesoftware.

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

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

4. Review the following information about the wizard registration:

l If you installed the NMSAP package when the NetWorker Remote Exec service (thensrexecd or nsrexecd.exe program) was running, the automatic wizard registrationoccurred during the installation.

l If you installed the NMSAP package when the NetWorker Remote Exec service (thensrexecd or nsrexecd.exe program) was not running:

Getting Started


n With NetWorker version 18.2 or later, the automatic wizard registration occurs afterthe NetWorker Remote Exec service (the nsrexecd or nsrexecd.exe program) isstarted.

n With NetWorker version pre-18.2, after the NetWorker Remote Exec service (thensrexecd or nsrexecd.exe program) is started, register the wizard manually bytyping the appropriate command as described in the next step.

5. Ensure that the automatic wizard registration succeeded:

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

b. Ensure that the NetWorker Remote Exec service (the nsrexecd or nsrexecd.exeprogram) is running.

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

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

print type: NSR remote agent

Check that the command output includes the correct values for "backup type" (databaseor application type that you want to protect) and "product version" (version of NMSAPthat you installed). You can run the exit command to return to the original console.

If the command output is missing or does not contain the correct values, then theNetWorker Remote Exec service (the nsrexecd or nsrexecd.exe program) was notrunning 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 from the followingtable.

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 man command,modify the MANPATH environment variable to include the pathname of the directory thatcontains the NMSAP man pages.

Getting Started


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

7. Optionally, register the NMSAP product information with the SAP System LandscapeDirectory (SLD). Registering NMSAP product information with the SAP SLD repository(optional) on page 22 provides details.

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

The NMSAP installation sets the permissions to 01777 for /nsr/applogs and itssubdirectories. These permissions are required for non-root database users to createtemporary files and logs during backups and restores. The sticky bit is also set to ensurethat the files can be removed only by the file owners. For example, the permissions appearas follows:

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

9. On Windows, to ensure the success of backups and restores, completed the following tasks:

l Restart the database services.

l Close and reopen any command prompt window or console that will be used to runbackups or restores.

10. Configure the NMSAP software.

The 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 NMSAP productinformation 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 a wordprocessor.

The NMSAP installation stores a copy of this file, which has been preconfigured with theNMSAP information except for the computer hostname, in the following location:

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

l On Windows: NetWorker_install_directory\nsr\bin\nwsldreg.xml2. Change all occurrences of the word ComputerName to the hostname of the computer 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 provides details.

5. Type the following sldreg command at the command line to send the edited file to the SLDserver:

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

Getting Started


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

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


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


Installing NMSAP on AIX systemsInstall NMSAP on an AIX system by running the installp command line interface (CLI) programor the AIX System Management Interface Tool (SMIT), which is a graphical user interface (GUI)program.

Procedure

1. Complete the initial steps in Installation road maps on page 17. Ensure that you meet thefollowing 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 by running 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 directory that containsthe installation software as described in Accessing the NMSAP software 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 installation wassuccessful.

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 software as thecomplete pathname of the directory that is described in Accessing the NMSAPsoftware 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 steps in Enablingthe RMAN utility on page 30.

4. Return to the installation road map to perform any post-installation procedures. As part ofthese procedures, ensure that the NMSAP automatic wizard registration succeeded byusing 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 the command lineinterface (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 that contains thesoftware installation files as described in Accessing the NMSAP software 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 that contains thesoftware installation files as described in Accessing the NMSAP software 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 message appears. Themessage displays as normal.

b. To continue the installation, click OK.

The NMSAP installation on HP-UX stores informational messages including installationerrors in the /var/adm/sw/swagent.log file. If an error occurs during 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 the samedirectory as the NetWorker client software.

Procedure






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

l On Linux x64:

rpm -ivh lgtonmsap-19.2.0.0-1.x86_64.rpm

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

rpm -ivh lgtonmsap-19.2.0.0-1.ppc64.rpm

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

rpm -ivh lgtonmsap-19.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-19.2.0.0-1lgtonmc-19.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 is torun on a sparse root zone, install NMSAP on the global zone and on each requiredsparse root zone.

2. Type the required pkgadd command:

pkgadd -d /dir_pathname LGTOnmsap

where /dir_pathname is the complete pathname of the directory that contains theLGTOnmsap package.

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

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







Enabling the RMAN utilityIf you want to use Oracle RMAN software for backup and restore operations on a UNIX or Linuxoperating system, create a symbolic link to the NMSAP RMAN library file.

About this task

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 following command:

su ORACLE_HOME_owner

2. Create a symbolic link to the RMAN libnworasap.xx library file by using one of thefollowing options:

l If you installed NMSAP in the default directory, type the required commands that arelisted in the following table.

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

n Copy the libnworasap.xx library file to the default directory /usr/lib, and typethe required linking commands that are listed in the following table.

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

Table 7 Commands to link and unlink the RMAN library file

Operatingsystem

Link or unlinkoperation

Install: create symbolic linkUninstall: 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




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

Operatingsystem

Link or unlinkoperation

Install: create symbolic linkUninstall: remove symbolic link

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, andconfiguration file template, /etc/nsrsapsv.cfg, supplied with NMSAP. The uninstall ofNMSAP deletes these template files and any settings you made in the files.

About this task

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

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 theRMAN 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 symbolic link fromthe /usr/sap/SID/SYS/global/hdb/opt directory.



l On an SAP Oracle server, remove the backint program file or symbolic link from thedirectory where the SAP BR*Tools reside, for example, /usr/sap/SID/SYS/exe/run.

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

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 SMIT GUI program.

Procedure

1. Ensure that you have completed the steps in Uninstalling NMSAP on UNIX and Linuxsystems 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 the commandline 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 following command:

rpm -e lgtonmsap lgtoxtdclnt lgtoclnt

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 NetWorker client software.





CHAPTER 3

Microsoft Windows Installation


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


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 by runningeither 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 theinstructions in the installation wizard.

By default, the NMSAP Setup program installs the NMSAP program files in the samedirectory 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 installing NMSAP.

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 on the OracleRMAN support screen.

n For an update installation, select the NMSAP Oracle RMAN feature on theCustom Setup screen.

c. To exit the Setup program, click Finish.

When the installation completes, a message appears about how to start the backupconfiguration wizard. The NetWorker Module for SAP Administration Guide describesthe 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> in doublequotes if it includes a space. The default directory for the log file is C:\users\username\AppData\Local\temp.

n EnableRMAN=1 installs the RMAN component during the installation. This optionsets the EnableRMAN parameter to 1. The default value of the 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 installation that installsthe RMAN component and logs messages in the C:\Program Files\EMCNetWorker\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 client installationdirectory. 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, add the NetWorkerclient 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 system Path variable,restart the Windows system and verify that any required database instances and serviceswere restarted.


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


Repairing the installation on Microsoft WindowsTo repair an NMSAP installation on a Microsoft Windows system, complete the following 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 theNMSAP 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, click Install. TheSetup program reinstalls the NMSAP files as required.

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

The Installation Wizard Completed dialog box displays a message about how to start theNetWorker Client Configuration Wizard. The NetWorker Module for SAP Version 19.2Administration Guide describes the configuration wizard.

9. If you changed the system Path variable, restart the Windows system, and then verify thatany 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 file template,NetWorker_install_directory\nsr\bin\insrsapsv.cfg, supplied with NMSAP. Theuninstall of NMSAP deletes these template files and any settings you made in the files.

About this task

Uninstall NMSAP on a Windows system by removing the backint.exe program and by using theSetup program method or Windows Control Panel method to uninstall the NMSAP 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, theNMSAP wizard information (not the binary) is left on the local host.

4. Remove the backint.exe program file from the folder where the SAP BR*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 as described in Accessing the NMSAP software on page 15, and then run the win_x64\networkr\NMSAP.exe program.

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

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> in doublequotes if it includes a space. The default directory for the log file is C:\users\username\AppData\Local\temp.

For example, the following command performs a silent NMSAP uninstallation that logsmessages 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 Remove Programs orPrograms and Features, depending on the Microsoft Windows version.

b. In the Add or Remove Programs window, select NetWorker Module for SAP andclick Remove.





Date post:	04-Aug-2020
Category:	Documents
Upload:	others
View:	50 times
Download:	7 times