Dell EMC NetWorker Module for SAP

Transcription

1 Dell EMC NetWorker Module for SAP Version 9.2 Installation Guide REV 01

2 Copyright Dell Inc. or its subsidiaries. All rights reserved. Published July 2017 Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS-IS. DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners. Published in the USA. Dell EMC Hopkinton, Massachusetts In North America NetWorker Module for SAP 9.2 Installation Guide

3 CONTENTS Tables 5 Preface 7 Chapter 1 Getting Started 11 Required software...12 NetWorker server software...13 NMC server software...13 NetWorker Authentication Service...13 NetWorker storage node software NetWorker client software NMSAP software SAP BR*Tools software...14 Installation checklists Documents Installation media License enablers...15 Accessing the NMSAP software Accessing NMSAP from the DVD media...15 Accessing NMSAP from the website...16 Installation road maps...17 Road map to install or update NMSAP on an SAP host...17 Road map to update NMSAP with the Package Manager...19 Road map to post-installation procedures Registering NMSAP product information with the SAP SLD repository (optional)...23 Chapter 2 UNIX and Linux Installation 25 Installing NMSAP on AIX systems Installing NMSAP on HP-UX systems Installing NMSAP on Linux systems...28 Installing NMSAP on Solaris systems Enabling the RMAN utility Uninstalling NMSAP on UNIX and Linux systems Uninstalling NMSAP on AIX Uninstalling NMSAP on HP-UX...33 Uninstalling NMSAP on Linux Uninstalling NMSAP on Solaris Chapter 3 Microsoft Windows Installation 35 Installing NMSAP on Microsoft Windows Repairing the installation on Microsoft Windows Uninstalling NMSAP on Microsoft Windows NetWorker Module for SAP 9.2 Installation Guide 3

4 CONTENTS 4 NetWorker Module for SAP 9.2 Installation Guide

5 TABLES Revision history... 7 Style conventions... 8 Typical hosts and software in the NMSAP environment...12 Access the directory that contains the NMSAP software NetWorker startup commands on UNIX and Linux Command to register the wizard...22 Commands to link and unlink the RMAN library file NetWorker Module for SAP 9.2 Installation Guide 5

6 TABLES 6 NetWorker Module for SAP 9.2 Installation Guide

7 Preface As part of an effort to improve product lines, periodic revisions of software and hardware are released. Therefore, all versions of the software or hardware currently in use might not support some functions that are described in this document. The product 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 this document, contact a technical support professional. This document was accurate at publication time. To ensure that you are using the latest version of this document, go to the Support website at support.emc.com. Purpose This document describes how to install, update, and uninstall the NetWorker Module for SAP (NMSAP) version 9.2. Audience This document is intended for system administrators who are responsible for installing NMSAP and maintaining backup and recovery systems. Users of this guide must be familiar with the following topics: SAP terminology and concepts, especially those related to SAP HANA and Oracle database backup and recovery Backup and recovery procedures Disaster recovery procedures Revision history The following table presents the revision history of this document. Table 1 Revision history Revision Date Description 01 July 28, 2017 Initial release of this document for NMSAP 9.2. Related documentation You can find additional publications for this product release and related NetWorker products at the Support website. The NetWorker Online Software Compatibility Matrix at compatibilityguide.emc.com:8080/compguideapp/ provides details about 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. NetWorker Module for SAP 9.2 Installation Guide 7

8 Preface Contains information that is incidental, but not essential, to the topic. Typographical conventions The following type style conventions are used in this document: Table 2 Style conventions Bold Italic Monospace 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 with title, table label, and window. Used for full titles of publications that are referenced in text. Used for: System code System output, such as an error message or script Pathnames, file names, file name extensions, prompts, and syntax Commands and options Monospace italic Monospace bold Used for variables. Used for user input. [ ] Square brackets enclose optional values. Vertical line indicates alternate selections. The vertical line means or for 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 the example. You can use the following resources to find more information about this product, obtain support, and provide feedback. Where to find product documentation Where to get support The Support website at provides access to licensing information, product documentation, advisories, and downloads, as well as how-to and troubleshooting information. This information may enable you to resolve a product issue before you contact Support. To access a product specific Support page: 1. Go to 2. In the Find a Product by Name box, type a product name, and then select the product from the list that appears. 3. Click the following button: 8 NetWorker Module for SAP 9.2 Installation Guide

9 Preface 4. (Optional) To add the product to My Saved Products, in the product specific page, click Add to My Saved Products. Knowledgebase The Knowledgebase contains applicable solutions that you can search for by solution number, for example, , or by keyword. To search the Knowledgebase: 1. Go to 2. Click Advanced Search. The screen refreshes and filter options appear. 3. In the Search Support or Find Service Request by Number box, type a solution number or keywords. 4. (Optional) To limit the search to specific products, type a product name in the Scope by product box, and then select the product from the list that appears. 5. In the Scope by resource list box, select Knowledgebase. The Knowledgebase Advanced Search panel appears. 6. (Optional) Specify other filters or advanced options. 7. Click the following button: Live chat To participate in a live interactive chat with a support agent: 1. Go to 2. Click Chat with a Support Agent. Service requests To obtain in-depth help from Support, submit a service request. To submit a service request: 1. Go to 2. Click Create a Service Request. To create a service request, you must have a valid support agreement. Contact a sales representative for details about obtaining a valid support agreement or with questions about an account. To review an open service request: 1. Go to 2. Click Manage service requests. Online communities Go to the Community Network at for peer contacts, conversations, and content on product support and solutions. Interactively engage online with customers, partners, and certified professionals for all products. How to provide feedback Feedback helps to improve the accuracy, organization, and overall quality of publications. You can send feedback to DPAD.Doc.Feedback@emc.com. NetWorker Module for SAP 9.2 Installation Guide 9

10 Preface 10 NetWorker Module for SAP 9.2 Installation Guide

11 CHAPTER 1 Getting Started This chapter includes the following topics: Required software Installation checklists...14 Accessing the NMSAP software...15 Installation road maps Getting Started 11

12 Getting Started Required software NetWorker Module for SAP (NMSAP) is a NetWorker add-on module that provides data protection services for SAP HANA and SAP Oracle data. The term SAP Oracle in this document refers to an SAP environment with an Oracle database. 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 software packages 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 NetWorker base client NetWorker extended client NetWorker storage node NetWorker server NetWorker Authentication Service NetWorker storage node NetWorker base client NetWorker extended client NetWorker storage node NetWorker Management Console (NMC) server NetWorker base client NetWorker extended client NMC server Each SAP server (NMSAP host) SAP database server NetWorker base client NetWorker extended client NMSAP On SAP Oracle server: SAP BR*Tools For split-mirror backups, compatible replication management software for BR*Tools Review the following software descriptions to plan the installation requirements. The NetWorker Online Software Compatibility Matrix at compatibilityguide.emc.com:8080/compguideapp/ provides details about the operating systems and software versions that are required for NMSAP services. 12 NetWorker Module for SAP 9.2 Installation Guide

13 Getting Started NetWorker server software NMC server software NetWorker Authentication Service NetWorker storage node software NetWorker client software The NetWorker Installation Guide describes how to install the NetWorker server, storage node, client, and NMC software. Install a supported version of the NetWorker server software on the NetWorker server host. The NetWorker 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 as described in the NMSAP release notes. Use a supported version of the NetWorker server that works with the NetWorker client version installed on the NMSAP host. The operating systems that are used must support the NetWorker server version that is used. Install a supported version of the NMC software on a network host to provide a user interface with the NetWorker software and NMSAP. The NetWorker Authentication Service provides centralized token-based authentication to components in the NetWorker environment. NetWorker uses the NetWorker Authentication Service to authenticate NMC and CLI users. You can configure the NetWorker Authentication Service to use a local user database or external identity providers (LDAP and AD) for authentication. The NetWorker Installation Guide provides details on the installation and configuration requirements for the NetWorker Authentication Service software. Install a supported version of the NetWorker storage node software on the host that manages the backup storage devices. You can configure a NetWorker storage node on the same host as the NetWorker server, on the same host as NMSAP to support backups to a local device, or on a separate host. Use a supported version of the NetWorker storage node that works with the NetWorker client version installed on the NMSAP host and with the NetWorker server. The operating systems that are used must support the NetWorker storage node version. Install a supported version of the NetWorker client software on the supported SAP server host before you install NMSAP on that host. Install both the NetWorker base client 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 snapshot backups and restores. To enable the snapshot operations, install the NetWorker base client and extended client software packages on both of the following hosts: NMSAP host A mount host NetWorker server software 13

14 Getting Started Some operating systems and volume managers require that you configure a mount host 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 host as the mount host. The NetWorker Snapshot Management Integration Guide provides a full list of restrictions and details. The NetWorker extended client package must be installed to enable the following functionality on the host: NSM CLI utilities for server reporting and administration, such as mminfo, nsradmin, and nsrinfo Cluster integration scripts Custom script integration tools (pre/post save) Audit log Cloning and staging ProtectPoint for VMAX ProtectPoint for RecoverPoint The NetWorker Installation Guide provides details about the NetWorker base and extended client packages. NMSAP software Install 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 software Installation checklists On an SAP Oracle server, install a supported SAP BR*Tools version. The SAP documentation describes the supported operating systems. If you install NMSAP in a non-english environment, ensure that you meet the following requirements: The host operating system supports internationalization (I18N). The SAP Oracle software and BR*Tools software provide the required National Language Support (NLS) or globalization support. The SAP Oracle software and BR*Tools software are configured with the required non-ascii character set. Review the following checklists to ensure that you have the required materials for the NMSAP installation procedures. Documents You can find the required information in the following documents: 14 NetWorker Module for SAP 9.2 Installation Guide

15 Getting Started NetWorker Module for SAP Installation Guide for the existing version, if you are updating from a previous NMSAP version to NMSAP 9.2 NetWorker Module for SAP Version 9.2 Release s NetWorker Module for SAP Version 9.2 Administration Guide NetWorker Administration Guide for the supported NetWorker release NetWorker Online Software Compatibility Matrix Installation media Use one of the following installation media: The DVD from the Information Protection and Availability Product Families Media Kit If you download the software, use the Support website License enablers Enabler codes or licenses activate the functionality of the NMSAP software and are sold separately. Without an enabler code, you can only evaluate the software. The NetWorker Licensing Guide describes licensing. The EMC Software Price Guide describes the licensing requirements for NetWorker modules. Accessing the NMSAP software You can obtain the NMSAP software from the DVD media or the downloads website. Accessing NMSAP from the DVD media The DVD with the NMSAP software is in the Information Protection and Availability Product Families Media Kit. The kit contains the software and online documentation for related products. 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 on Windows. 2. Insert and mount the NetWorker Module DVD in the DVD drive: On UNIX or Linux, mount the DVD drive: mount /dev/dvd_drive_name /mount_point 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 Online Software Compatibility Matrix at compatibilityguide.emc.com:8080/compguideapp/ provides details about the Installation media 15

16 Getting Started operating systems, database software, and application software that NMSAP supports. Table 4 Access the directory that contains the NMSAP software Operating system (NMSAP bitness) AIX (64-bit) HP Itanium (64-bit) HP PA-RISC (64-bit) Linux x64 (64-bit) Linux Power PC (64-bit bigendian) Linux Power PC (64-bit littleendian) Solaris SPARC (64-bit) Solaris AMD (64-bit) Windows x64 (64-bit) Software directory /mount_point/sap/aixpower /mount_point/sap/hpux11_ia64 /mount_point/sap/hpux11_64 /mount_point/sap/linux_x86_64 /mount_point/sap/linuxppc64_64 /mount_point/sap/linuxppc64le_64 /mount_point/volume_label/sap/solaris_64 /mount_point/volume_label/sap/solaris_amd64 DVD_drive_letter:\sap\win_x64 Accessing NMSAP from the website You can download the NMSAP software package from the Support website and extract 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 local administrator user on Windows. 2. Create a temporary installation download directory in a local file system with sufficient free disk space to contain both the downloaded software package and the software installation files that are extracted from the package. 3. Go to the Support website at The NetWorker Online Software Compatibility Matrix at compatibilityguide.emc.com:8080/compguideapp/ provides details about the operating systems and the database and application software 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 9.2 software file to the temporary directory that you created. 5. Extract the installation files from the downloaded software package: On UNIX or Linux: 16 NetWorker Module for SAP 9.2 Installation Guide

17 Getting Started a. Uncompress the downloaded package by typing the gunzip command with the file_name.tar.gz name for the specific download file name: gunzip file_name.tar.gz b. Extract the software from the uncompressed, tarred file: tar -xvpbf file_name.tar Installation road maps The extraction lists the distribution software files on the screen. c. Go to the directory that contains the NMSAP installation files. On Windows: a. Unzip the downloaded software package, nmsap92_win_x64.zip. b. Go to the win_x64 directory. Follow the proper road map to install NMSAP: Road map to install or update NMSAP on an SAP host Road map to update NMSAP remotely with the Package Manager Road map to perform the post-installation procedures Road map to install or update NMSAP on an SAP host To install or update NMSAP on an SAP host in a supported configuration, complete the procedure as follows. You can install or update NMSAP in either of the following configurations: Single host Cluster host, Oracle RAC host, or SAP HANA scale-out host Install the NetWorker client and NMSAP software on each node host that performs backup and recovery operations in a cluster, Oracle RAC, or SAP HANA scale-out multinode environment. The NetWorker Online Software Compatibility Matrix at compatibilityguide.emc.com:8080/compguideapp/ provides details about 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 required documentation, installation media, and license information. 2. Ensure that you have installed the NetWorker client software on the host. The client version must support the NMSAP version to be installed. 3. Access the NMSAP software as described in Accessing the NMSAP software on page 15 and ensure that you start the installation from the correct directory. Installation road maps 17

18 Getting Started If you do not start the installation from the correct directory, the installation might fail. 4. Ensure that no backups or restores are running on the SAP server. You do not need to shut down the database during the installation. 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 with NMSAP before you uninstall a previous NMSAP version. The template files are in the following directory: On UNIX or Linux: /etc On Windows: NetWorker_install_directory\nsr\bin An uninstallation of NMSAP deletes the original template files and any settings that you made in the files. 6. Uninstall any previous version of NMSAP according to the instructions in the installation guide for the module version. NOTICE Do not use an upgrade option on the platform, for example, the rpm -U command 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: On UNIX or Linux, type the following command: ps -ef grep nsrexecd On Windows, use either Component Services or Task Manager. If the NetWorker Remote Exec daemon or service is not running: To start the NetWorker Remote Exec daemon on UNIX or Linux, log in as root, and type the appropriate startup command from the following table. Table 5 NetWorker startup commands on UNIX and Linux Operating system Solaris, Linux HP-UX AIX Startup command /etc/init.d/networker start /sbin/init.d/networker start /etc/rc.nsr To start the NetWorker Remote Exec service on Windows, perform the following steps: 18 NetWorker Module for SAP 9.2 Installation Guide

19 Getting Started 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. If you do not start the NetWorker Remote Exec daemon or service before the NMSAP installation, then the automatic registration of the NMSAP configuration wizard might not occur and the wizard might fail to detect if NMSAP is installed. Road map to post-installation procedures on page 20 provides details. 8. Install NMSAP by following the instructions for the operating system in the required chapter: UNIX and Linux Installation on page 25 Microsoft Windows Installation on page 35 After the software installation completes, a message appears about how to start the NMSAP scheduled backup configuration wizard. The NetWorker Module for SAP Administration Guide describes the wizard. 9. Perform all the required post-installation procedures. Road map to postinstallation procedures on page 20 provides details. Road map to update NMSAP with the Package Manager You can update NMSAP on one or more NMSAP hosts by using the Package Manager feature from a centralized NetWorker server. You can perform the update with the Package Manager or the nsrpush command. When you use the Package Manager, NMSAP must not be installed on the NetWorker server. Cluster environments do not support updates with the Package Manager. The NetWorker Updating from a Previous Release Guide describes the Package Manager, including the following procedures: Verifying software that is installed on NetWorker clients. Performing and monitoring the updates. Managing the repository of media kits that the Package Manager uses to install the software from the NetWorker server. To add an NMSAP release to the Package Manager repository, follow the instructions in the NetWorker Updating from a Previous Release Guide. If you use the nsrpush 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. Road map to update NMSAP with the Package Manager 19

20 Getting Started Procedure 1. Review the Installation checklists on page Ensure that you meet the following requirements: NMSAP 4.5 or later is installed on the NMSAP host, and the operating systems support the Package Manager. You cannot perform an update of earlier NMSAP releases. The NetWorker Updating from a Previous Release Guide at the Support website describes the operating systems that support the Package Manager feature on the NMSAP host. The NMSAP client host contains a supported version of the NetWorker client software. The user that performs the update is both an NMC administrator and a member of the application 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 to be updated. The Package Manager might stop and restart the NetWorker client nsrexecd daemon or service during the installation. Road map to post-installation procedures 4. On the NetWorker server, perform the update of the NMSAP client by using the Package Manager 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. After you have installed or updated NMSAP, either directly on a local host or by remote installation with Package Manager, complete the following post-installation procedures. Procedure 1. Enable the NMSAP backup program: On an SAP HANA server, perform either of the following tasks: Copy the hdbbackint program file from the default NetWorker binary installation directory (for example, /usr/sbin) or the / relocation_path/sbin installation directory (Linux) to the /usr/sap/sid/sys/global/hdb/opt directory. 20 NetWorker Module for SAP 9.2 Installation Guide If you installed NMSAP in a nondefault directory, then specify the path to the sbin directory. Create a symbolic link that points from /usr/sap/sid/sys/ global/hdb/opt/hdbbackint to the actual hdbbackint program file.

21 Getting Started Create the opt subdirectory manually if it does not exist. SAP HANA requires the 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 the hdbbackint file, where SID is the system ID of the SAP HANA system. On an SAP Oracle server, perform one of the following tasks: Copy the backint program from the /usr/sbin directory (UNIX or Linux) or the NetWorker_install_directory\nsr\bin directory (Windows) to the directory where the SAP BR*Tools reside. Create a symbolic link that points from where the SAP BR*Tools reside to /usr/sbin/backint (UNIX or Linux only). For BR*Tools 7.10 or later, set util_path=full path to directory containing backint in the BR*Tools configuration file, initdbsid.sap. 2. If you are installing NMSAP for the first time on the host, register and enable NMSAP to work with the NetWorker software. The NetWorker Licensing Guide describes licensing and enabling of software. The EMC Software Price Guide describes the licensing requirements for NetWorker modules. If you are updating from a previous NMSAP release, you do not need to reenable 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 additional details. 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: On UNIX or Linux, type the following command: nsradmin -p nsrexecd 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 "backup type" (database or application type that you want to protect) and "product Road map to post-installation procedures 21

22 Getting Started version" (version of NMSAP that 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 the NetWorker Remote Exec service (the nsrexecd or nsrexecd.exe program) was not running during the NMSAP installation. Perform one of the following corrective actions: Start the NetWorker Remote Exec service, and then reinstall NMSAP. Register the wizard manually by typing the appropriate command from the following table. To unregister the wizard manually, use the command from the table but replace 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 man command, modify the MANPATH environment variable to include the pathname of the directory that contains the NMSAP man pages. The NMSAP man pages are located in the same directory as NetWorker client man 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 System Landscape Directory (SLD). Registering NMSAP product information with the SAP SLD repository (optional) on page 23 provides details. 7. On UNIX or Linux, to ensure the success of backups and restores, check that the /nsr/applogs directory and its subdirectories have the permissions. The NMSAP installation sets the permissions to for /nsr/applogs and its subdirectories. These permissions are required for non-root database users to create temporary files and logs during backups and restores. The sticky bit is also set to ensure that the files can be removed only by the file owners. For example, 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 the following tasks: Restart the database services. Close and reopen any command prompt window or console that will be used to run backups or restores. 22 NetWorker Module for SAP 9.2 Installation Guide

23 Getting Started 9. 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 product 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 a word processor. The NMSAP installation stores a copy of this file, which has been preconfigured with the NMSAP information except for the computer hostname, in the following location: On UNIX or Linux: /etc/nwsldreg.xml On Windows: NetWorker_install_directory\nsr\bin \nwsldreg.xml 2. 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 SLD server: sldreg -user username -pass password -host sld_server -port http_port -file nwsldreg.xml where: username and password are the login credentials on the SLD host. sld_server is the name of the SLD host. 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. nwsldreg.xml is the XML file to send to the SLD host. The following sources provide more details: The sldreg command, run without options The SAP website Registering NMSAP product information with the SAP SLD repository (optional) 23

24 Getting Started 24 NetWorker Module for SAP 9.2 Installation Guide

25 CHAPTER 2 UNIX and Linux Installation This chapter includes the following topics: Installing NMSAP on AIX systems Installing NMSAP on HP-UX systems...27 Installing NMSAP on Linux systems Installing NMSAP on Solaris systems Enabling the RMAN utility Uninstalling NMSAP on UNIX and Linux systems...31 UNIX and Linux Installation 25

26 UNIX and Linux Installation Installing NMSAP on AIX systems Install NMSAP on an AIX system by running the installp command line interface (CLI) program or 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 the following requirements: You are logged in as the root user. No backups or restores are running. The nsrexecd daemon is running. You can check the daemon status by running the ps -ef grep nsrexecd command. You are in the correct directory that contains the NMSAP installation files. 2. Run either the installp CLI program or the SMIT GUI program: 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 contains the 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 was successful. 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 the complete pathname of the directory that is described in Accessing the 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. 26 NetWorker Module for SAP 9.2 Installation Guide

27 UNIX and Linux Installation i. To begin the installation, press Enter. 3. If you use the RMAN utility for backup and restore operations, follow the steps in Enabling the RMAN utility on page Return to the installation road map to perform any post-installation procedures. As part of these procedures, ensure that the NMSAP automatic wizard registration succeeded by using the following commands: nsradmin -p nsrexecd nsradmin> print type: NSR remote agent Road map to post-installation procedures on page 20 provides complete details. Installing NMSAP on HP-UX systems Install NMSAP on an HP-UX system by using the swinstall command to run the command line interface (CLI) or the graphical user interface (GUI) program. Procedure 1. Complete the initial steps in Installation road maps on page 17. Ensure that you meet the following requirements: You are logged in as the root user. No backups or restores are running. The nsrexecd daemon is running. You can check the daemon status by running the ps -ef grep nsrexecd command. You are in the correct directory that contains the NMSAP installation files. 2. To run either the CLI or GUI program, type the swinstall command: 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 the software installation files as described in Accessing the NMSAP software on page 15. 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 the software 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. The message displays as normal. Installing NMSAP on HP-UX systems 27

28 UNIX and Linux Installation b. To continue the installation, click OK. The NMSAP installation on HP-UX stores informational messages including installation errors in the /var/adm/sw/swagent.log file. If an error occurs during the installation, check this file to obtain details about the error. 3. If you use the RMAN utility for backup and restore operations, follow the steps in Enabling the RMAN utility on page Return to the installation road map to perform any post-installation procedures. As part of these procedures, ensure that the NMSAP automatic wizard registration succeeded by using the following commands: nsradmin -p nsrexecd nsradmin> print type: NSR remote agent Road map to post-installation procedures on page 20 provides complete details. Installing NMSAP on Linux systems Install NMSAP on a Linux system by running the rpm command. Install NMSAP in the same directory as the NetWorker client software. Procedure 1. Complete the initial steps in Installation road maps on page 17. Ensure that you meet the following requirements: You are logged in as the root user. No backups or restores are running. The nsrexecd daemon is running. You can check the daemon status by running the ps -ef grep nsrexecd command. You are in the correct directory that contains the NMSAP installation files. 2. To install NMSAP, type the required rpm command, for example: On Linux x64: rpm -ivh lgtonmsap x86_64.rpm On Linux Power PC 64-bit big-endian: rpm -ivh lgtonmsap ppc64.rpm On Linux Power PC 64-bit little-endian: rpm -ivh lgtonmsap ppc64le.rpm 3. To verify that the installation was successful, type the rpm -aq command: rpm -aq grep lgto 28 NetWorker Module for SAP 9.2 Installation Guide

29 UNIX and Linux Installation The command output must include the proper lines, for example: lgtoclnt lgtonmc If you use the RMAN utility for backup and restore operations, follow the steps in Enabling the RMAN utility on page Return to the installation road map to perform any post-installation procedures. As part of these procedures, ensure that the NMSAP automatic wizard registration succeeded by using the following commands: nsradmin -p nsrexecd nsradmin> print type: NSR remote agent Road map to post-installation procedures on page 20 provides complete details. Installing NMSAP on Solaris systems Install NMSAP on a Solaris system by running the pkgadd command. Procedure 1. Complete the initial steps in Installation road maps on page 17. Ensure that you meet the following requirements: You are logged in as the root user. No backups or restores are running. The nsrexecd daemon is running. You can check the daemon status by running the ps -ef grep nsrexecd command. You are in the correct directory that contains the NMSAP installation files. If the Solaris system has Solaris zones (containers) and the NMSAP program is to run on a sparse root zone, install NMSAP on the global zone and on each required sparse root zone. 2. Type the required pkgadd command: pkgadd -d /dir_pathname LGTOnmsap where /dir_pathname is the complete pathname of the directory that contains the LGTOnmsap package. 3. When prompted to continue the installation, type y. The system installs the software in the same directory as the NetWorker client software. 4. If you use the RMAN utility for backup and restore operations, follow the steps in Enabling the RMAN utility on page 30. Installing NMSAP on Solaris systems 29

30 UNIX and Linux Installation 5. Return to the installation road map to perform any post-installation procedures. As part of these procedures, ensure that the NMSAP automatic wizard registration succeeded by using the following commands: nsradmin -p nsrexecd nsradmin> print type: NSR remote agent Road map to post-installation procedures on page 20 provides complete details. Enabling the RMAN utility If you want to use Oracle RMAN software for backup and restore operations on a UNIX or Linux operating system, create a symbolic link to the NMSAP RMAN library file. To enable NMSAP operations with RMAN, you do not need to install the NetWorker Module 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 the following options: If you installed NMSAP in the default directory, type the required commands that are listed in the following table. If you installed NMSAP in a nondefault directory, perform one of the following actions: Copy the libnworasap.xx library file to the default directory /usr/ lib, and type the required linking commands that are listed in the following table. 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 the libnworasap.xx file that is located in the nondefault installation directory /relocation_path/lib. Table 7 Commands to link and unlink the RMAN library file Operating system Link or unlink operation 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 30 NetWorker Module for SAP 9.2 Installation Guide

31 UNIX and Linux Installation Table 7 Commands to link and unlink the RMAN library file (continued) Operating system Link or unlink operation 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 Remove link cd $ORACLE_HOME/lib rm libobk.so HP PA-RISC Create link cd $ORACLE_HOME/lib ln -s /usr/lib/libnworasap.sl libobk.sl Remove link cd $ORACLE_HOME/lib 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.so libobk.so Remove link cd $ORACLE_HOME/lib Solaris AMD Solaris SPARC Create link Remove link rm libobk.so cd $ORACLE_HOME/lib ln -s /usr/lib/libnworasap.so libobk.so cd $ORACLE_HOME/lib rm libobk.so Uninstalling NMSAP on UNIX and Linux systems Before you uninstall NMSAP, save a copy of the parameter file template, /etc/ init.utl, and configuration file template, /etc/nsrsapsv.cfg, supplied with NMSAP. The uninstall of NMSAP deletes these template files and any settings you made 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 uninstall procedure for the operating system. Uninstalling NMSAP on UNIX and Linux systems 31

32 UNIX and Linux Installation If you uninstall NMSAP in a cluster or multinode environment, perform the uninstall procedure 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. 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: On an SAP HANA server, remove the hdbbackint program file or symbolic link from the /usr/sap/sid/sys/global/hdb/opt directory. On an SAP Oracle server, remove the backint program file or symbolic link from the directory 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. You do not need to shut down a database to uninstall NMSAP. Uninstalling NMSAP on AIX Uninstall 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 Linux systems on page 31 for the initial part of the uninstall procedure. 2. To uninstall NMSAP, use one of the following methods: Use the CLI program by typing the following command: installp -u LGTOnmsap.rte 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. 32 NetWorker Module for SAP 9.2 Installation Guide

33 UNIX and Linux Installation c. Select the package to uninstall: Uninstalling NMSAP on HP-UX LGTOnmsap.rte d. Set the PREVIEW Only option to No. e. To uninstall NMSAP, press Enter. f. Exit the SMIT program. Uninstall NMSAP on an HP-UX system by using the swinstall command to run the command line interface (CLI) or the graphical user interface (GUI) program. Procedure 1. Ensure that you have completed the steps in Uninstalling NMSAP on UNIX and Linux systems on page 31 for the initial part of the uninstall procedure. 2. To uninstall NMSAP, use one of the following methods: Use the CLI program by typing the following command: swremove NMSAP Use the swremove GUI program: a. Type the following swremove command: Uninstalling NMSAP on Linux 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. Uninstall NMSAP on a Linux system by running the rpm command. Procedure 1. Ensure that you have completed the steps in Uninstalling NMSAP on UNIX and Linux systems on page 31 for the initial part of the uninstall procedure. 2. Complete the required uninstall procedure on Linux: To uninstall NMSAP only, type the following command: rpm -e lgtonmsap You must uninstall the NetWorker client software after NMSAP. To uninstall both NMSAP and the NetWorker client, type the following command: rpm -e lgtonmsap lgtoxtdclnt lgtoclnt Uninstalling NMSAP on HP-UX 33

34 UNIX and Linux Installation Uninstalling NMSAP on Solaris Uninstall NMSAP on a Solaris system by running the pkgrm command. Procedure 1. Ensure that you have completed the steps in Uninstalling NMSAP on UNIX and Linux systems on page 31 for the initial part of the uninstall procedure. 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. 34 NetWorker Module for SAP 9.2 Installation Guide

35 CHAPTER 3 Microsoft Windows Installation This chapter includes the following topics: Installing NMSAP on Microsoft Windows...36 Repairing the installation on Microsoft Windows...38 Uninstalling NMSAP on Microsoft Windows...38 Microsoft Windows Installation 35

36 Microsoft Windows Installation Installing NMSAP on Microsoft Windows Install NMSAP on a Windows system by running the NMSAP Setup program, win_x64\networkr\nmsap.exe. Procedure 1. Complete the initial steps in Installation road maps on page 17. Ensure that you meet the following requirements: You are logged in as an administrator. No backups or restores are running. The nsrexecd.exe service is running. You can check the service status by running either Component Services or Task Manager. You are in the correct directory that contains the NMSAP installation files. 2. Install NMSAP by using one of the following methods: 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 files in the same directory as the NetWorker client program files, NetWorker_install_directory\bin. 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: Only install the RMAN component on a host that does not use NetWorker Module for Databases and Applications (NMDA) to protect data. For a new installation, select Install the Oracle RMAN component on the Oracle RMAN support screen. For an update installation, select the NMSAP Oracle RMAN feature on the Custom Setup screen. c. To exit the Setup program, click Finish. When the installation completes, a message appears about how to start the backup configuration wizard. The NetWorker Module for SAP Administration Guide describes the wizard. Silent installation method: Run the NMSAP.exe command with the appropriate command options: NMSAP.exe <installation_options> 36 NetWorker Module for SAP 9.2 Installation Guide where <installation_options> includes the following options:

37 Microsoft Windows Installation /s /q suppresses all the UI output. /passive displays the progress bar only during the installation. /repair runs a repair or (if the software is not installed) an installation. /l <pathname> specifies the log file pathname. Enclose <pathname> in double quotes if it includes a space. The default directory for the log file is C:\users\username\AppData\Local\temp. EnableRMAN=1 installs the RMAN component during the installation. This option sets the EnableRMAN parameter to 1. The default value of the parameter is 0. Only install the RMAN component on a host that does not use NMDA to protect data. For example, the following command performs a silent NMSAP installation that installs the RMAN component and logs messages in the C:\Program Files\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 client installation 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, add the NetWorker client installation directory. The NetWorker client directory pathname can include spaces. There cannot be spaces 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 services were restarted. 5. Return to the installation road map to perform any post-installation procedures. As part of these procedures, ensure that the NMSAP automatic wizard registration succeeded by using the following commands: nsradmin.exe -p nsrexecd nsradmin> print type: NSR remote agent Road map to post-installation procedures on page 20 provides complete details. Installing NMSAP on Microsoft Windows 37