Академический Документы
Профессиональный Документы
Культура Документы
Version 19.1
Installation Guide
302-005-548
REV 01
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, 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 01748-9103
1-508-435-1000 In North America 1-866-464-7381
www.DellEMC.com
Tables 5
Preface 7
1 Revision history............................................................................................................ 7
2 Style conventions......................................................................................................... 8
3 Typical hosts and software in the NMSAP environment..............................................12
4 Access the directory that contains the NMSAP software........................................... 16
5 NetWorker startup commands on UNIX and Linux...................................................... 19
6 Command to register the wizard.................................................................................22
7 Commands to link and unlink the RMAN library file.................................................... 30
Note
This document was accurate at publication time. To ensure that you are using the
latest version 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.1.
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:
l SAP terminology and concepts, especially those related to SAP HANA and Oracle
database backup and recovery
l Backup and recovery procedures
l Disaster recovery procedures
Revision history
The following table presents the revision history of this document.
Related documentation
You can find additional publications for this product release and related NetWorker
products at the Support website.
The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhome
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
Note
Typographical conventions
The following type style conventions are used in this document:
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 with
title, 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, and
syntax
l Commands and options
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. The information 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
the product.
Knowledgebase
The Knowledgebase contains applicable solutions that you can search for either by
solution number (for example, KB000xxxxxx) or by keyword.
Note
To create a service request, you must have a valid support agreement. For details
about either an account or obtaining a valid support agreement, contact a sales
representative. To get the details of a service request, in the Service Request
Number field, type the service request number, and then click the right arrow.
l Required software.............................................................................................. 12
l Installation checklists..........................................................................................15
l Accessing the NMSAP software.........................................................................15
l Installation road maps......................................................................................... 17
Getting Started 11
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.
Note
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.
backups and restores. To enable the snapshot operations, install the NetWorker base
client and extended client software packages on both of the following hosts:
l NMSAP host
l A mount host
Note
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:
l NSM
l CLI utilities for server reporting and administration, such as mminfo, nsradmin,
and nsrinfo
l Cluster integration scripts
l Custom script integration tools (pre/post save)
l Audit log
l Cloning and staging
l ProtectPoint for VMAX
l ProtectPoint for RecoverPoint
The NetWorker Installation Guide provides details about the NetWorker base 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.
Installation checklists
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:
l NetWorker Module for SAP Installation Guide for the existing version, if you are
updating from a previous NMSAP version to NMSAP 19.1
l NetWorker Module for SAP Version 19.1 Release Notes
l NetWorker Module for SAP Version 19.1 Administration Guide
l NetWorker Administration Guide for the supported NetWorker release
l NetWorker E-LAB Navigator
Installation media
Use 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 enablers
Enabler codes or licenses activate the functionality of the NMSAP software and are
sold separately.
Note
a. Select DOWNLOADS.
The Downloads page appears.
gunzip file_name.tar.gz
Note
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.
Note
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:
l On UNIX or Linux: /etc
l On Windows: NetWorker_install_directory\nsr\bin
Note
An uninstallation of NMSAP deletes the original template files and any settings
that you made in the files.
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:
l On UNIX or Linux, type the following command:
AIX /etc/rc.nsr
Note
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 21
provides details.
8. Install NMSAP by following the instructions for the operating system in the
required chapter:
l UNIX and Linux Installation on page 25
l Microsoft Windows Installation on page 35
Note
The NetWorker Updating from a Previous Release Guide describes the Package
Manager, including the following procedures:
l Verifying software that is installed on NetWorker clients.
l Performing and monitoring the updates.
l Managing the repository of media kits that the Package Manager uses to install
the software from the NetWorker server.
Note
Complete the following steps to update NMSAP with the Package Manager.
Procedure
1. Review the Installation checklists on page 15.
2. Ensure that you meet the following requirements:
l 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.
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 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.
Note
The Package Manager might stop and restart the NetWorker client nsrexecd
daemon or service during the installation.
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 21 provides details.
Note
Note
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.
nsradmin -p nsrexecd
nsradmin.exe -p nsrexecd
Check that the command output includes the correct values for "backup
type" (database or application type that you want to protect) and "product
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:
l Start the NetWorker Remote Exec service, and then reinstall NMSAP.
l Register the wizard manually by typing the appropriate command from
the following table.
Note
To unregister the wizard manually, use the command from the table but
replace the -i option with -u.
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 01777
permissions.
The NMSAP installation sets the permissions to 01777 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:
l 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.
Registering NMSAP product information with the SAP SLD repository (optional) 23
Getting Started
5. Type the following sldreg command at the command line to send the edited
file to the SLD server:
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
2. Run either the installp CLI program or the SMIT GUI program:
l To run the CLI program, 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:
nsradmin -p nsrexecd
nsradmin> print type: NSR remote agent
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 -i -s /
dir_pathname/LGTOnmsap.pkg NMSAP
nsradmin -p nsrexecd
nsradmin> print type: NSR remote agent
3. To verify that the installation was successful, type the rpm -aq command:
The command output must include the proper lines, for example:
lgtoclnt-19.1.0.0-1
lgtonmc-19.1.0.0-1
4. If you use the RMAN utility for backup and restore operations, follow the steps
in Enabling the RMAN utility on page 30.
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
Note
If the Solaris system has Solaris zones (containers) and the NMSAP program is
to run on a sparse root zone, install NMSAP on the global zone and on each
required sparse root zone.
nsradmin -p nsrexecd
nsradmin> print type: NSR remote agent
Note
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:
l If you installed NMSAP in the default directory, type the required commands
that are listed 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 type the 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 the libnworasap.xx file that is located in the
nondefault installation directory /relocation_path/lib.
ln -s /usr/lib/libnworasap.a libobk.a
Table 7 Commands to link and unlink the RMAN library file (continued)
rm libobk.a
ln -s /usr/lib/libnworasap.so libobk.so
rm libobk.so
ln -s /usr/lib/libnworasap.sl libobk.sl
rm libobk.sl
If not relocated:
ln -s /usr/lib/libnworasap.so libobk.so
If relocated:
ln -s /relocation_path/lib/libnworasap.so
libobk.so
rm libobk.so
rm libobk.so
Note
Procedure
1. Ensure that no backups or restores are running.
2. Ensure that the NetWorker Remote Exec daemon, nsrexecd, is running.
Note
If the NetWorker Remote Exec daemon is not running during the uninstallation,
the NMSAP wizard information (not the binary) is left on the local host.
3. If you enabled the RMAN feature, remove the symbolic link for the library file.
Enabling the RMAN utility on page 30 provides details.
4. Log in as the root user on the NMSAP host.
5. Remove the required program file or symbolic link:
l On an SAP HANA server, remove the hdbbackint program file or symbolic
link from the /usr/sap/SID/SYS/global/hdb/opt directory.
l 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.
Note
installp -u LGTOnmsap.rte
smitty remove
LGTOnmsap.rte
swremove NMSAP
swremove -i NMSAP
rpm -e lgtonmsap
Note
Note
To uninstall NMSAP on Solaris zones, first uninstall NMSAP on the global zone,
and then uninstall NMSAP on each required sparse root zone.
pkgrm LGTOnmsap
Note
Note
Only install the RMAN component on a host that does not use NetWorker
Module for Databases and Applications (NMDA) to protect data.
NMSAP.exe <installation_options>
Note
Only install the RMAN component on a host that does not use NMDA to
protect data.
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.
Note
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
9. If you changed the system Path variable, restart the Windows system, and then
verify that any required database instances and services are restarted.
Note
If you uninstall NMSAP in a cluster, then perform the uninstall procedure on each node
of the cluster that contains NMSAP.
Procedure
1. Log in as the Windows system local administrator user on the NMSAP host.
2. Ensure that no backups or restores are running.
Note
Note
If the NetWorker Remote Exec service is not running during the uninstallation,
the NMSAP wizard information (not the binary) is left on the local host.
4. Remove the backint.exe program file from the folder where the 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: