Dell EMC NetWorker Module for Databases

and Applications
Version 19.1

Installation Guide
302-005-543
REV 01
Copyright © 2009-2019 Dell Inc. or its subsidiaries. All rights reserved.

Published May 2019

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

2 NetWorker Module for Databases and Applications 19.1 Installation Guide

CONTENTS

Tables 5

Preface 7

Chapter 1 Getting Started 11

NMDA software requirements.....................................................................12
Database or application server software.........................................13
NetWorker server software............................................................13
NMC server software..................................................................... 13
NetWorker Authentication Service.................................................13
NetWorker storage node software................................................. 14
NetWorker client software............................................................. 14
NMDA software............................................................................. 15
Data Domain BoostFS software..................................................... 15
Installation checklists.................................................................................. 15
Documents.....................................................................................15
Installation media........................................................................... 15
License enablers.............................................................................16
Accessing the NMDA software................................................................... 16
Accessing NMDA from the DVD media...........................................16
Accessing NMDA from the website................................................ 17
Accessing the Data Domain BoostFS software............................................18
Installation road maps................................................................................. 18
Road map to install or update NMDA on a database or application
host................................................................................................19
Road map to update NMDA with the Package Manager................. 21
Road map to post-installation procedures......................................22

Chapter 2 UNIX and Linux Installation 25

Installing NMDA on AIX systems.................................................................26
Installing NMDA on HP-UX systems........................................................... 27
Installing NMDA on Linux systems.............................................................. 28
Enabling Data Domain BoostFS for Orchestrated Application
Protection..................................................................................... 29
Installing NMDA on Solaris systems............................................................ 31
Linking and unlinking NMDA in the environment on UNIX or Linux............. 32
Linking NMDA in a DB2 environment............................................. 32
Linking and unlinking NMDA in an Informix environment................33
Linking and unlinking NMDA in a MySQL environment...................33
Linking and unlinking NMDA in an Oracle environment.................. 36
Linking and unlinking NMDA in an SAP IQ environment................. 38
Linking and unlinking NMDA in a Sybase ASE environment............38
Uninstalling NMDA on UNIX or Linux systems.............................................41
Uninstalling NMDA on AIX systems................................................ 41
Uninstalling NMDA on HP-UX systems.......................................... 42
Uninstalling NMDA on Linux systems.............................................42

NetWorker Module for Databases and Applications 19.1 Installation Guide 3

CONTENTS

Uninstalling NMDA on Solaris systems...........................................43

Chapter 3 Microsoft Windows Installation 45

Installing NMDA on Microsoft Windows..................................................... 46
Linking and unlinking NMDA in the environment on Windows..................... 48
Linking NMDA in a DB2 environment............................................. 48
Linking and unlinking NMDA in an Informix environment................49
Linking and unlinking NMDA in a Lotus Notes environment........... 50
Linking and unlinking NMDA in a Sybase ASE environment............ 51
Repairing the installation on Microsoft Windows........................................ 52
Uninstalling NMDA on Microsoft Windows................................................. 52

Chapter 4 NMDA with Mixed 32-bit and 64-bit Databases and Applications
55
Coexistence of 32-bit and 64-bit databases and applications..................... 56
Installing NMDA to enable 32-bit and 64-bit coexistence........................... 56
Uninstalling 32-bit NMDA on a 32-bit/64-bit system................................. 59

Appendix A Uninstalling ISM on an Informix Server 61

ISM software on an Informix server............................................................62
Uninstalling ISM on UNIX or Linux.............................................................. 62
Uninstalling ISM on Microsoft Windows..................................................... 63
Uninstalling ISM on Windows with the Setup program.................. 63
Uninstalling ISM on Windows manually.......................................... 64

4 NetWorker Module for Databases and Applications 19.1 Installation Guide

TABLES

1 Revision history............................................................................................................ 7
2 Style conventions......................................................................................................... 8
3 Typical hosts and software in the NMDA environment................................................ 12
4 Software directory on the DVD................................................................................... 16
5 Zipped download file and software directory for install............................................... 18
6 NetWorker startup commands on UNIX and Linux......................................................20
7 Command to register the wizard.................................................................................23
8 Linking and unlinking commands for Oracle library file on UNIX or Linux.................... 37
9 Linking and unlinking commands for Sybase ASE library file on UNIX or Linux........... 39
10 Additional steps to enable NMDA for a 32-bit application........................................... 57

NetWorker Module for Databases and Applications 19.1 Installation Guide 5

TABLES

6 NetWorker Module for Databases and Applications 19.1 Installation Guide

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.

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 Databases and Applications (NMDA) version 19.1.
Audience
This document is intended for system administrators or database administrators
(DBAs) who are responsible for installing software and maintaining backup and
recovery systems for databases or applications.
Users of this guide must be familiar with the following topics:
l Backup, recovery, databases, applications, and network terminology
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 May 20, 2019 Initial release of this document for NMDA version 19.1.

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.
The following additional documentation might be useful:
l Database or application server documentation
l Database or application backup and recovery documentation
Special notice conventions that are used in this document
The following conventions are used for special notices:

NetWorker Module for Databases and Applications 19.1 Installation Guide 7

Preface

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:

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

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

8 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Preface

Knowledgebase
The Knowledgebase contains applicable solutions that you can search for either by
solution number (for example, KB000xxxxxx) or by keyword.
To search the Knowledgebase:
1. Go to https://www.dell.com/support.
2. On the Support tab, click Knowledge Base.
3. In the search box, type either the solution number or keywords. Optionally, you
can limit the search to specific products by typing a product name in the search
box, and then selecting the product from the list that appears.
Live chat
To participate in a live interactive chat with a support agent:
1. Go to https://www.dell.com/support.
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:
1. Go to https://www.dell.com/support.
2. On the Support tab, click Service Requests.

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.

To review an open service request:

1. Go to https://www.dell.com/support.
2. On the Support tab, click Service Requests.
3. On the Service Requests page, under Manage Your Service Requests, click
View All Dell Service Requests.
Online communities
For peer contacts, conversations, and content on product support and solutions, go to
the Community 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 can send feedback to [email protected].

NetWorker Module for Databases and Applications 19.1 Installation Guide 9

Preface

10 NetWorker Module for Databases and Applications 19.1 Installation Guide

CHAPTER 1
Getting Started

This chapter includes the following topics:

l NMDA software requirements............................................................................ 12

l Installation checklists..........................................................................................15
l Accessing the NMDA software........................................................................... 16
l Accessing the Data Domain BoostFS software................................................... 18
l Installation road maps......................................................................................... 18

Getting Started 11
Getting Started

NMDA software requirements

NetWorker Module for Databases and Applications (NMDA) is a NetWorker add-on
module that provides data protection services for the supported DB2, Informix, Lotus
Domino/Notes, MySQL, Oracle, SAP IQ, and Sybase ASE databases.
The following table lists the hosts and software that you might require for NMDA
services.

Note
Before you install NMDA, install both the NetWorker base client and extended client
software packages on the database server host.
The product name Sybase ASE is synonymous with the name SAP ASE.

Table 3 Typical hosts and software in the NMDA 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 extended client
l NetWorker storage node

NetWorker Management Console (NMC) l NetWorker base client

server
l NetWorker extended client
l NMC server

Each supported database server (NMDA l Supported database or application server

host)
l NetWorker base client
l NetWorker extended client
l NMDA
l For snapshot operations with Oracle
ASM: Replication management software
l For Orchestrated Application Protection:
Data Domain Boost - File System
software

Review the following software descriptions to plan the installation requirements.

The bitness (32-bit or 64-bit) of NMDA software that is required depends on the
bitness of the database or application server being protected:
l With one exception, you require 32-bit NMDA to support a 32-bit database or
application server and 64-bit NMDA to support a 64-bit database or application

12 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Getting Started

server, regardless of the operating system bitness. The exception applies to

Sybase ASE releases earlier than 16.0 SP02. For those Sybase ASE releases, 32-
bit NMDA supports both 32-bit and 64-bit Sybase ASE on AIX and Solaris SPARC.
l If only 32-bit database or application servers are installed on a 64-bit system, then
you only need to install 32-bit NMDA on the system.
l With 32-bit NMDA on Linux, ensure that the 32-bit NetWorker client is installed.
With 64-bit NMDA on Linux, ensure that the 64-bit NetWorker client is installed.
NMDA does not support 32-bit and 64-bit coexistence on Linux.
l If both 32-bit and 64-bit database or application servers are installed on the same
system, refer to the sections in this guide about NMDA with mixed 32-bit and 64-
bit databases and applications.
The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhome
provides details about the operating systems and software versions that are required
for NMDA services.
The NetWorker Installation Guide describes how to install the NetWorker server,
storage node, client, and NMC software.

Database or application server software

Ensure that the supported DB2, Informix, Lotus Domino/Notes, MySQL, Oracle, SAP
IQ, or Sybase ASE database or application server is installed on an operating system
that supports the NetWorker client and NMDA version to be installed on that host.
If you install NMDA in a non-English environment, ensure that you meet the following
requirements:
l The host operating system supports internationalization (I18N).
l The database or application software provides the required National Language
Support (NLS) or globalization support.
l The database or application software is configured with the required non-ASCII
character set.

NetWorker server 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 NMDA host.
You might require specific NetWorker server versions to support specific NMDA
features as described in the NetWorker Module for Databases and Applications Version
19.1 Release Notes.
Use a supported version of the NetWorker server that works with the NetWorker
client version installed on the NMDA host. The operating systems that are used must
support the NetWorker server version that is used.

NMC server software

Install a supported version of the NMC software on a network host to provide a user
interface with the NetWorker software and NMDA.

NetWorker Authentication Service

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

Database or application server software 13

Getting Started

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.

NetWorker storage node 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 NMDA 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 that is installed on the NMDA host and the NetWorker
server. The operating systems that are used must support the NetWorker storage
node version.

NetWorker client software

Install a supported version of the NetWorker client software on the supported
database or application server host before you install NMDA on that host. Install both
the NetWorker base client and extended client software packages.
With 32-bit NMDA on Linux, ensure that the 32-bit NetWorker client is installed. With
64-bit NMDA on Linux, ensure that the 64-bit NetWorker client is installed. NMDA
does not support 32-bit and 64-bit coexistence on Linux.
NMDA can use the NetWorker Snapshot Management (NSM) feature to provide a
high-availability storage environment for snapshot backups and restores of DB2 and
Oracle data. To enable the snapshot-based operations, install the NetWorker base
client and extended client software packages on both of the following hosts:
l NMDA host
l A mount host
The mount host can be either of the following hosts:
n A separate host, to offload the data transfer from the database host
n The same host as the database or application host

Note

Some operating systems and volume managers require that you configure a mount
host on a separate host from the database or application host. For example,
Veritas Volume Manager (VxVM) and Linux Logical Volume Manager (LVM) do not
support the use of the database or application 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)

14 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Getting Started

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.

NMDA software
Install NMDA on a supported database server or application server.
For Oracle ASM snapshot backups and restores with replication management
software, also install NMDA on the mount host.

Data Domain BoostFS software

For Orchestrated Application Protection, install the Data Domain BoostFS on the
supported database server or application server.

Installation checklists
Review the following checklists to ensure that you have the required materials for the
NMDA installation procedures.

Documents
You can find the required information in the following documents:
l NetWorker Module for Databases and Applications Installation Guide for the existing
version, if you are updating from a previous NMDA version to NMDA 19.1
l NetWorker Module for Databases and Applications Version 19.1 Release Notes
l NetWorker Module for Databases and Applications Version 19.1 Administration Guide
l NetWorker Administration Guide for the supported NetWorker release
l NetWorker E-LAB Navigator
l Data Domain BoostFS Configuration Guide

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

NMDA software 15
Getting Started

License enablers
Enabler codes or licenses activate the functionality of the NMDA software and are
sold separately.

Note

Without an enabler code, you can only evaluate the software that is obtained from the
DVD or the website.

The NetWorker Licensing Guide describes licensing.

Accessing the NMDA software

The NMDA software is distributed on DVD media and on the downloads website.

Accessing NMDA from the DVD media

The DVD 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 NMDA software files from the NetWorker Module 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 then 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
provides details about the operating systems and the database and application
software that NMDA supports.
Table 4 Software directory on the DVD

Operating system Software directory

(NMDA bitness)
AIX (32-bit) /mount_point/nmda/aixpower_32

AIX (64-bit) /mount_point/nmda/aixpower_64

HP Itanium (64-bit) /mount_point/nmda/hpux11_ia64

HP PA-RISC (64-bit) /mount_point/nmda/hpux11_64

Linux s390x (64-bit) /mount_point/nmda/linuxs390x

Linux x64 (64-bit) /mount_point/nmda/linux_x86_64

Linux x86 (32-bit) /mount_point/nmda/linux_x86

16 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Getting Started

Table 4 Software directory on the DVD (continued)

Operating system Software directory

(NMDA bitness)
Linux Power PC (64-bit little- /mount_point/nmda/linuxppc64le_64
endian)

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

Solaris SPARC (32-bit) /mount_point/volume_label/nmda/solaris_32

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

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

Windows x86 (32-bit) DVD_drive_letter:\nmda\win_x86

Accessing NMDA from the website

You can download the NMDA software files from the Support website.
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. Review the details in the NetWorker E-LAB Navigator at https://
elabnavigator.emc.com/eln/elnhome about the operating systems and the
database and application software that NMDA supports.
4. Complete the following steps on the Support website at https://
support.emc.com:
a. Select Drivers & Downloads.
The Drivers & Downloads page appears.

b. In the search box, type NetWorker Module for Databases and

Applications.
5. Download the NMDA release 19.1 software file to the temporary directory that
you created.
6. 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 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

The extraction lists the distribution software files on the screen.

Accessing NMDA from the website 17

Getting Started

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

l On Windows:
a. Unzip the downloaded software package as shown in the following table.
b. Go to the correct directory as shown in the following table.

Table 5 Zipped download file and software directory for install

Downloaded software file Directory for install

nmda191_win_x64.zip win_x64

nmda191_win_x86.zip win_x86

Accessing the Data Domain BoostFS software

If you want to enable and leverage the Orchestrated Application Protection feature,
you can download the Data Domain BoostFS software files from the Support website.
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. Download the required Data Domain BoostFS software:
a. On the Support website at https://support.emc.com, select Drivers &
Downloads.
The Drivers & Downloads page appears.

b. In the search box, type Data Domain Boost and then select Data Domain
Boost – File System.
c. Select the Data Domain BoostFS 1.1.0.1 or later version, and download the
Data Domain BoostFS software file to the temporary directory that you
created in step 2.
4. Review the required documentation:
a. Go to https://support.emc.com/products.
b. In the search box, type Data Domain Boost and then select Data Domain
Boost – File System.
c. Click Documentation.
d. Download the Data Domain BoostFS Configuration Guide, and review the
"Supported Environments" section about the operating system and FUSE
that Data Domain BoostFS supports.

Installation road maps

Follow the proper road map to install NMDA:

18 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Getting Started

l Road map to install or update NMDA on a database or application host

l Road map to update NMDA remotely with the Package Manager
l Road map to perform the post-installation procedures

Road map to install or update NMDA on a database or application host

To install or update NMDA on a database or application host in any of the supported
configurations, complete the procedure as follows.
You can install or update NMDA in any of the following configurations:
l Single host
l Active-passive cluster
l Active-active application cluster, such as DB2 Database Partitioning Feature
(DPF), DB2 pureScale, Informix Multi-node Active Clusters for High Availability or
High Availability Clusters (MACH), Oracle Real Application Clusters (RAC), and
Sybase ASE Cluster Edition

Note

Install NMDA on each node host in a cluster that performs backup and recovery
operations.

The NetWorker E-LAB Navigator at https://elabnavigator.emc.com/eln/elnhome

provides details about the supported software versions and cluster environments.
Procedure
1. Review the Installation checklists on page 15 and verify that you have the
required documentation, installation media, and license information.
2. If you installed Informix Storage Manager (ISM) on the host, uninstall ISM
according to the instructions in Uninstalling ISM on an Informix Server on page
61.
3. Ensure that you have installed the NetWorker client software on the host. The
client version must support the NMDA version to be installed.

4. Access the NMDA software as described in Accessing the NMDA software on

page 16, and then ensure that you are in the correct directory.

Note

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

5. Ensure that no backups or restores are running on the database server or

application server. You do not need to shut down the database or application
during the installation.
6. Uninstall any previous version of NMDA 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.

Road map to install or update NMDA on a database or application host 19

Getting Started

7. Before the NMDA 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 type the appropriate startup command from the following table.

Table 6 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 the
NMDA installation, then the automatic registration of the NMDA configuration
wizard might not occur and the wizard might fail to detect if NMDA is installed.
Road map to post-installation procedures on page 22 describes the manual
wizard registration.

8. If you want to install NMDA on a system that runs both a 32-bit and 64-bit
database or application that NMDA supports, follow the instructions in NMDA
with Mixed 32-bit and 64-bit Databases and Applications on page 55.
For example, follow the instructions for a mixed 32-bit/64-bit system if the
same host runs both 32-bit and 64-bit Lotus Domino or runs both 32-bit Sybase
ASE and 64-bit DB2.

If the system runs a single database or application or if the system runs multiple
databases or applications that are all supported by a single NMDA package,
then skip this step.

9. If you performed step 8, then skip this step. Otherwise, install NMDA by
following the instructions for the operating system in the correct chapter:

20 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Getting Started

l UNIX and Linux Installation on page 25

l Microsoft Windows Installation on page 45

Note

If only 32-bit database or application servers are installed on a 64-bit system,

then you only need to install 32-bit NMDA on the system.

After the software installation completes, a message appears about how to

start the NMDA scheduled backup configuration wizard. The NetWorker Module
for Databases and Applications Version 19.1 Administration Guide describes the
wizard.

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

Road map to update NMDA with the Package Manager

You can update NMDA on one or more NMDA 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,
NMDA must not be installed on the NetWorker server.

Note

Cluster environments do not support updates with the Package Manager. You cannot
use the Package Manager to update 32-bit NMDA on a 64-bit operating system.

The NetWorker Updating from a Previous Release Guide describes the Package
Manager, including the following procedures:
l Viewing 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

To add an NMDA 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 Databases and Applications” with the quotation marks.

Complete the following steps to update NMDA with the Package Manager.
Procedure
1. Review the Installation checklists on page 15.
2. Ensure that you meet the following requirements:
l NMDA 1.5 or later is installed on the NMDA host, and the operating systems
support the Package Manager. You cannot perform an update of earlier
NMDA 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 NMDA host.

Road map to update NMDA with the Package Manager 21

Getting Started

l The NMDA 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 NMDA 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 22 provides details.

Road map to post-installation procedures

After you have installed or updated NMDA, either directly on a local host or by remote
installation with Package Manager, complete the following post-installation
procedures.
Procedure
1. If you are installing NMDA for the first time on the host, register and enable
NMDA to work with the NetWorker software.
The NetWorker Licensing Guide describes licensing and enabling of software.

2. If you perform snapshot backups for Oracle ASM on the host, install and enable
the required replication management software on the NMDA host and the
mount host.
3. Ensure that the automatic wizard registration succeeded:
a. Log in as the root user (UNIX or Linux) or system administrator (Windows).
b. At a new command prompt, type the appropriate command:
l On UNIX or Linux, type the following command:

nsradmin -p nsrexecd

l On Windows, type the following command:

nsradmin.exe -p nsrexecd

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

print type: NSR remote agent

Check that the command output includes the correct values for "backup
type" (database or application type that you want to protect) and "product

22 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Getting Started

version" (version of NMDA 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 NMDA installation.
Perform one of the following corrective actions:
l Start the NetWorker Remote Exec service, and then reinstall NMDA.
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.

Table 7 Command to register the wizard

Database or application Wizard registration command

DB2 nsrdb2ra(.exe) -i

Informix nsrifmxra(.exe) -i

Lotus nsrlotusra(.exe) -i

MySQL nsrmysqlra(.exe) -i

Oracle nsrorara(.exe) -i

Sybase ASE nsrsybra(.exe) -i

4. On UNIX or Linux, to ensure the success of backups and restores, check that
the /nsr/apps directory and its subdirectories have the 01777 permissions.
The NMDA installation sets the permissions to 01777 for /nsr/apps 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 6 root root 4096 Dec 22 12:17 /nsr/apps

5. 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 run backups or restores.

6. Configure the NMDA software.

The NetWorker Module for Databases and Applications Version 19.1 Administration
Guide provides details.

Road map to post-installation procedures 23

Getting Started

24 NetWorker Module for Databases and Applications 19.1 Installation Guide

CHAPTER 2
UNIX and Linux Installation

This chapter includes the following topics:

l Installing NMDA on AIX systems........................................................................ 26

l Installing NMDA on HP-UX systems...................................................................27
l Installing NMDA on Linux systems..................................................................... 28
l Installing NMDA on Solaris systems.................................................................... 31
l Linking and unlinking NMDA in the environment on UNIX or Linux..................... 32
l Uninstalling NMDA on UNIX or Linux systems.................................................... 41

UNIX and Linux Installation 25

UNIX and Linux Installation

Installing NMDA on AIX systems

Install NMDA 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 18. Ensure that you
meet the following requirements:
l You are logged in as the root user.
l No backups or restores are running.
l The nsrexecd daemon is running. You can check the daemon status by
running the ps -ef | grep nsrexecd command.
l You are in the correct directory that contains the NMDA 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 LGTOnmda.rte

where /dir_pathname is the complete pathname of the correct directory

that contains the installation software as described in Accessing the NMDA
software on page 16.
To verify that the installation succeeded, type the following command:

lslpp -L all | grep -i lgtonmda

If the lslpp command output includes LGTOnmda.rte, the installation was

successful.
l To run the SMIT GUI program, perform the following steps:
a. Type the following command:

smitty install_latest

b. In the Entry Field, type the location of the NMDA installation software as
the complete pathname of the directory that is described in Accessing
the NMDA software on page 16.
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 NMDA software packages, select F4=List.
f. To install the NMDA software, select LGTOnmda.rte.
g. Set the Preview Only option to No.
h. Select Install and Update Software.

26 NetWorker Module for Databases and Applications 19.1 Installation Guide

 UNIX and Linux Installation

i. To begin the installation, press Enter.

3. Link NMDA to the database server environment by completing the steps in
Linking and unlinking NMDA in the environment on UNIX or Linux on page 32.
4. Return to the installation road map to perform any post-installation procedures.
As part of these procedures, ensure that the NMDA 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 22 provides complete details.

Installing NMDA on HP-UX systems

Install NMDA 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 18. Ensure that you
meet the following requirements:
l You are logged in as the root user.
l No backups or restores are running.
l The nsrexecd daemon is running. You can check the daemon status by
running the ps -ef | grep nsrexecd command.
l You are in the correct directory that contains the NMDA installation files.

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/

LGTOnmda.pkg NMDA

where /dir_pathname is the complete pathname of the directory that

contains the software installation files as described in Accessing the NMDA
software on page 16.
l To run the swinstall GUI program, type the following command:

swinstall -x mount_all_filesystems=false -i -s /
dir_pathname/LGTOnmda.pkg NMDA

where /dir_pathname is the complete pathname of the directory that

contains the software installation files as described in Accessing the NMDA
software on page 16.
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 NMDA on HP-UX systems 27

UNIX and Linux Installation

b. To continue the installation, click OK.

The NMDA 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. Link NMDA to the database server environment by completing the steps in
Linking and unlinking NMDA in the environment on UNIX or Linux on page 32.
4. Return to the installation road map to perform any post-installation procedures.
As part of these procedures, ensure that the NMDA 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 22 provides complete details.

Installing NMDA on Linux systems

Install NMDA on a Linux system by running the rpm command. Install NMDA in the
same directory as the NetWorker client software.
Procedure
1. Complete the initial steps in Installation road maps on page 18. Ensure that you
meet the following requirements:
l You are logged in as the root user.
l No backups or restores are running.
l The nsrexecd daemon is running. You can check the daemon status by
running the ps -ef | grep nsrexecd command.
l You are in the correct directory that contains the NMDA installation files.

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

l On Linux s390x (zLinux) 64-bit:

rpm -ivh lgtonmda-19.1.0.0-1.s390x.rpm

l On Linux x64:

rpm -ivh lgtonmda-19.1.0.0-1.x86_64.rpm

l On Linux x86:

rpm -ivh lgtonmda-19.1.0.0-1.i686.rpm

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

rpm -ivh lgtonmda-19.1.0.0-1.ppc64le.rpm

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

rpm -aq | grep lgto

28 NetWorker Module for Databases and Applications 19.1 Installation Guide

 UNIX and Linux Installation

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

lgtoclnt-19.1.0.0-1
lgtonmda-19.1.0.0-1
lgtoxtdclnt-19.1.0.0-1

4. To enable support of the Orchestrated Application Protection feature on Linux

x64, complete the steps in Enabling Data Domain BoostFS for Orchestrated
Application Protection on page 29.
5. Link NMDA to the database server environment by completing the steps in
Linking and unlinking NMDA in the environment on UNIX or Linux on page 32.
6. Return to the installation road map to perform any post-installation procedures.
As part of these procedures, ensure that the NMDA 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 22 provides complete details.

Enabling Data Domain BoostFS for Orchestrated Application Protection

To enable the Orchestrated Application Protection feature on Linux x64, install the
Data Domain BoostFS version 1.1 or later client package in the default location. Data
Domain BoostFS user documentation describes the Data Domain OS version
requirements. Ensure that you also complete the required post-installation settings.

Note

If you have an existing Data Domain BoostFS installation, perform only the following
steps 3 to 5 to enable Orchestrated Application Protection with the existing
installation.

Procedure
1. Log in as the root user on the Linux x64 system.
2. To install the Data Domain BoostFS 1.1 or later package in the default location,
run the appropriate rpm -i command. For example:
l On Linux RHEL:

# rpm -i DDBoostFS-1.1.0.1-565598.rhel.x86_64.rpm

l On Linux SuSE:

# rpm -i DDBoostFS-1.1.0.1-565598.sles.x86_64.rpm

Note

The Orchestrated Application Protection feature does not support the relocated
installation of the Data Domain BoostFS package in a nondefault location.

3. Create an initial entry in the lockbox by using dummy information, such as the
string aaaa as a dummy password. Ensure that you set the permissions to

Enabling Data Domain BoostFS for Orchestrated Application Protection 29

UNIX and Linux Installation

enable only the root user to read and write the lockbox and log files. For
example:

# /opt/emc/boostfs/bin/boostfs lockbox set -d aaaa -s aaaa -u

aaaa

Enter storage unit user password:

Enter storage unit user password again to confirm:
Lockbox entry set

# chmod 0700 /opt/emc/boostfs/lockbox/*

# chmod 1700 /opt/emc/boostfs/lockbox
# chmod 1700 /opt/emc/boostfs/log

4. Assign the ACL permissions to the OS users that will run the Orchestrated
Application Protection backups and restores, including the application daemon
that runs with the user accounts of these OS users. For example, the following
commands set the ACL permissions for the OS user with username mysql:

# setfacl -m u:mysql:rwx /opt/emc/boostfs/lockbox

# setfacl -m u:mysql:rw /opt/emc/boostfs/lockbox/*
# setfacl -m u:mysql:rwx /opt/emc/boostfs/log

5. Check the fusermount binary permissions. When possible, limit the number of
OS users that have read and execute permissions for the fusermount
command.
Ensure that the OS users that will run the Orchestrated Application Protection
backups and restores have the read and execute permissions for the
fusermount command. For example, this OS user has the username mysql as
follows:

# which fusermount

/bin/fusermount

# ls -l /bin/fusermount

-rwsr-xr-x 1 root fuse 32336 Dec 7 2011 /bin/fusermount

# chmod o-rx /bin/fusermount

# ls -l /bin/fusermount

-rwsr-x--- 1 root fuse 32336 Dec 7 2011 /bin/fusermount

# setfacl -m u:mysql:rx /bin/fusermount

30 NetWorker Module for Databases and Applications 19.1 Installation Guide

 UNIX and Linux Installation

Installing NMDA on Solaris systems

Install NMDA on a Solaris system by running the pkgadd command.
Procedure
1. Complete the initial steps in Installation road maps on page 18. Ensure that you
meet the following requirements:
l You are logged in as the root user.
l No backups or restores are running.
l The nsrexecd daemon is running. You can check the daemon status by
running the ps -ef | grep nsrexecd command.
l You are in the correct directory that contains the NMDA installation files.

Note

If the Solaris system has Solaris zones (containers) and NMDA is to run on a
sparse root zone, install NMDA on the global zone and on each required sparse
root zone.

2. Type the required pkgadd command:

pkgadd -d /dir_pathname LGTOnmda

where /dir_pathname is the complete pathname of the directory that

contains the LGTOnmda 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. Link NMDA to the database server environment by completing the steps in
Linking and unlinking NMDA in the environment on UNIX or Linux on page 32.
5. Return to the installation road map to perform any post-installation procedures.
As part of these procedures, ensure that the NMDA 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 22 provides complete details.

Installing NMDA on Solaris systems 31

UNIX and Linux Installation

Linking and unlinking NMDA in the environment on UNIX or

Linux
After you install NMDA on UNIX or Linux as described in the preceding topics of this
chapter, perform an additional procedure to link NMDA to the database environment.
Before you uninstall NMDA, perform the procedure to unlink NMDA.
Use the correct instructions that follow to perform the linking or unlinking procedure
for the database:
l Linking NMDA in a DB2 environment
l Linking and unlinking NMDA in an Informix environment
l Linking and unlinking NMDA in an Oracle environment
l Linking and unlinking NMDA in a Sybase ASE environment

Note

In a Lotus Domino environment, you do not require the linking or unlinking procedure
to install or uninstall NMDA.

Linking NMDA in a DB2 environment

NOTICE

You must not set the DB2_VENDOR_INI registry variable. Also, if the $INSTHOME/
sqllib/cfg/vendor.cfg file exists, either remove the file or remove all the NMDA
parameter settings from the file.
DB2_VENDOR_INI is deprecated in DB2 9.5 and discontinued in DB2 10.1, as
announced by IBM. However, DB2_VENDOR_INI might still be in effect in some DB2
versions, such as a DB2 version later than 10.1.
You do not require unlinking steps to uninstall NMDA in a DB2 environment.

After you install NMDA on a DB2 server, use the db2set command to check if the
DB2_VENDOR_INI registry variable is set. The db2set command displays all the
variable settings.
You must complete the required steps to implement the changes on the DB2 server.
Procedure
1. Log in as the DB2 user.
2. Remove the $INSTHOME/sqllib/cfg/vendor.cfg file, or edit the file and
remove all the NMDA parameter settings.
3. Unset the DB2_VENDOR_INI variable:
a. Stop the database instance with the db2stop command.
b. Unset the DB2_VENDOR_INI registry variable with the db2set command:

db2set DB2_VENDOR_INI=

c. Restart the database instance with the db2start command.

32 NetWorker Module for Databases and Applications 19.1 Installation Guide

 UNIX and Linux Installation

Linking and unlinking NMDA in an Informix environment

Perform the required link or unlink procedure in an Informix environment:
l After you install NMDA, perform the procedure to link NMDA.
l Before you uninstall NMDA, perform the procedure to unlink NMDA.

Linking NMDA to the Informix server environment

After you install NMDA, link NMDA to the Informix server environment.
Procedure
1. Log in as the Informix user.
2. Edit the Informix $ONCONFIG file and set the BAR_BSALIB_PATH variable to
the full pathname of the NMDA libnsrifmx (XBSA) library.
The default library pathname is /usr/lib/libnsrifmx.xx where xx is the
platform-specific extension:
l sl on HP-UX 64-bit systems
l so on Linux and other UNIX systems

3. Update the sm_versions file (Informix user password required) by typing the
following command:

echo "1|1.0.1|nwbsa|1">> $INFORMIXDIR/etc/sm_versions

This action updates the NMDA Informix library links. Without the required
values, ON-Bar commands fail and the following message appears:

ERROR: Version 1.0.1 of the XBSA shared library is not

compatible with version 1 of ON-Bar.

4. Restart the IDS server to apply the $ONCONFIG file changes.

Unlinking NMDA from the Informix server environment

Before you uninstall NMDA, unlink NMDA from the Informix server environment.
Procedure
1. Log in as the Informix user.
2. Edit the Informix $ONCONFIG file and remove the setting from the
BAR_BSALIB_PATH variable.
3. Restore the copy of the sm_versions file that Informix stored in
$INFORMXIDIR/etc/sm_versions.std.
4. Restart the IDS server to apply the $ONCONFIG file changes.

Linking and unlinking NMDA in a MySQL environment

Perform the required link or unlink procedure in a MySQL environment:
l After you install NMDA, perform the procedure to link NMDA.
l Before you uninstall NMDA, perform the procedure to unlink NMDA.

Linking and unlinking NMDA in an Informix environment 33

UNIX and Linux Installation

Linking NMDA in a MySQL environment

Ensure that you meet the following requirements for MySQL support with NMDA on a
MySQL database server host:
l A supported version of MySQL Enterprise Backup (MEB) software is installed on
the MySQL server host, as detailed in the NetWorker Module for Databases and
Applications Version 19.1 Release Notes.
l MySQL client library libmysqlclient.so version 18 (MySQL 5.5 and 5.6) or
version 20 (MySQL 5.7) is installed on the MySQL server host, and the
corresponding symbolic link is created.

Note

If the symbolic link /usr/lib/libmysqlclient.so or /usr/lib/nsr/apps/

libmysqlclient.so (32-bit) or /usr/lib64/libmysqlclient.so
or /usr/lib/nsr/apps/lib64/libmysqlclient.so (64-bit) does not exist on
the MySQL host, use the following steps to install the MySQL client library and create
the symbolic link. If the symbolic link already exists, ignore the following steps.

Procedure
1. To install MySQL libmysqlclient.so version 18 or 20, download the
appropriate package from MySQL, and then install the package on the MySQL
server host:
l For MySQL version 5.5 or 5.6 with libmysqlclient.so.18, install
MySQL-shared-advanced-version.rpm, where version depends on the
Linux operating system and MySQL version in use.
l For MySQL version 5.7 with libmysqlclient.so.20, install mysql-
commercial-libs-version.rpm, where version depends on the Linux
operating system and MySQL version in use.
The libmysqlclient.so.20 libraries are installed in /usr/lib/mysql
(32-bit) or /usr/lib64/mysql (64-bit).

2. For MySQL version 5.7, create a symbolic link from the file named
libmysqlclient.so to the actual library file. For MySQL 5.5 and 5.6, this
step is required only if you installed the MySQL library in a nondefault location:

Note

On 32-bit Linux, NMDA searches for the library in the /usr/lib/nsr/apps/

directory first, before the /usr/lib/ directory. On 64-bit Linux, NMDA
searches for the library in the /usr/lib/nsr/apps/lib64/ directory first,
before the /usr/lib64/ directory.

l If you installed the MySQL 5.5 or 5.6 library in a nondefault location:

n On 32-bit Linux, type one of the following commands:

ln –s <install_pathname>/libmysqlclient.so.
18 /usr/lib/nsr/apps/libmysqlclient.so

ln –s <install_pathname>/libmysqlclient.so.18 /usr/lib/
libmysqlclient.so

34 NetWorker Module for Databases and Applications 19.1 Installation Guide

 UNIX and Linux Installation

n On 64-bit Linux, type one of the following commands:

ln –s <install_pathname>/libmysqlclient.so.
18 /usr/lib/nsr/apps/lib64/libmysqlclient.so

ln –s <install_pathname>/libmysqlclient.so.18 /usr/lib64/
libmysqlclient.so

l If you installed the MySQL 5.7 library in the default location:

n On 32-bit Linux, type one of the following commands:

ln –s /usr/lib/mysql/libmysqlclient.so.20 /usr/lib/nsr/
apps/libmysqlclient.so

ln –s /usr/lib/mysql/libmysqlclient.so.20 /usr/lib/
libmysqlclient.so

n On 64-bit Linux, type one of the following commands:

ln –s /usr/lib64/mysql/libmysqlclient.so.20 /usr/lib/nsr/
apps/lib64/libmysqlclient.so

ln –s /usr/lib64/mysql/libmysqlclient.so.20 /usr/lib64/
libmysqlclient.so

l If you installed the MySQL 5.7 library in a nondefault location:

n On 32-bit Linux, type one of the following commands:

ln –s <install_pathname>/libmysqlclient.so.
20 /usr/lib/nsr/apps/libmysqlclient.so

ln –s <install_pathname>/libmysqlclient.so.20 /usr/lib/
libmysqlclient.so

n On 64-bit Linux, type one of the following commands:

ln –s <install_pathname>/libmysqlclient.so.
20 /usr/lib/nsr/apps/lib64/libmysqlclient.so

ln –s <install_pathname>/libmysqlclient.so.20 /usr/lib64/
libmysqlclient.so

To verify the version of the installed MySQL client library, use the ls -lart
command. For example:
l On 32-bit Linux, type the appropriate command:

ls -lart /usr/lib/nsr/apps/libmysqlclient*

Linking and unlinking NMDA in a MySQL environment 35

UNIX and Linux Installation

or

ls -lart /usr/lib/libmysqlclient*

l On 64-bit Linux, type the appropriate command:

ls -lart /usr/lib/nsr/apps/lib64/libmysqlclient*

or

ls -lart /usr/lib64/libmysqlclient*

Unlinking NMDA in a MySQL environment

Before you uninstall NMDA, unlink NMDA from the MySQL environment. Use the rm
command to remove any libmysqlclient.so symbolic link that you created
manually for the NMDA installation.
Use the appropriate rm command to remove the symbolic link:
l For 32-bit NMDA, run the appropriate command:

rm /usr/lib/nsr/apps/libmysqlclient.so

or

rm /usr/lib/libmysqlclient.so

l For 64-bit NMDA, run the appropriate command:

rm /usr/nsr/apps/lib64/libmysqlclient.so

or

rm /usr/lib64/libmysqlclient.so

Linking and unlinking NMDA in an Oracle environment

Perform the required link or unlink procedure in an Oracle environment:
l After you install NMDA, perform the procedure to link NMDA.
l Before you uninstall NMDA, perform the procedure to unlink NMDA.

Linking NMDA to the Oracle server environment

Note

You do not need to shut down and restart Oracle instances to perform this procedure.

After you install NMDA, link NMDA to the Oracle server environment.

36 NetWorker Module for Databases and Applications 19.1 Installation Guide

 UNIX and Linux Installation

Procedure
1. Log in as the $ORACLE_HOME owner.
2. Create the symbolic link by using one of the following options:
l If you installed NMDA in the default directory, type the required commands
that are listed in the following table.
l If you installed NMDA in a nondefault directory, perform one of the following
actions:
n Copy the libnsrora.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 libnsrora.xx library file to the default
directory /usr/lib, type the linking commands that are listed in the
following table to link the libnsrora.xx file in the nondefault
installation directory /relocation_path/lib.

Note

The commands apply only to Oracle base releases. The commands might vary
for patched releases of the Oracle server.

Table 8 Linking and unlinking commands for Oracle library file on UNIX or Linux

Operating Create or Install: create the symbolic link Uninstall:

system remove link remove the symbolic link
AIX Create link cd $ORACLE_HOME/lib

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

Remove link cd $ORACLE_HOME/lib

rm libobk.a

HP PA-RISC Create link cd $ORACLE_HOME/lib

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

Remove link cd $ORACLE_HOME/lib

rm libobk.sl

l HP Itanium Create link cd $ORACLE_HOME/lib

l Linux s390x If not relocated:

ln -s /usr/lib/libnsrora.so libobk.so
l Linux x64
l Linux x86 If relocated:
ln -s /relocation_path/lib/libnsrora.so
l Solaris SPARC libobk.so
l Solaris x64
Remove link cd $ORACLE_HOME/lib

rm libobk.so

Linking and unlinking NMDA in an Oracle environment 37

UNIX and Linux Installation

Unlinking NMDA from the Oracle server environment

Before you uninstall NMDA, unlink NMDA from the Oracle server environment.
Procedure
1. Log in as the $ORACLE_HOME owner.
2. Type the required commands that are listed in Table 8 on page 37 to remove
the link.
3. If you copied the libnsrora.xx library file from the installation location to the
default directory /usr/lib, remove the library from the default directory.

Linking and unlinking NMDA in an SAP IQ environment

Perform the required link or unlink procedure in an SAP IQ server environment:
l After you install NMDA, perform the procedure to link NMDA.
l Before you uninstall NMDA, perform the procedure to unlink NMDA.

Linking NMDA to the SAP IQ server

After you install NMDA on an SAP IQ server, link NMDA to the server environment.
Procedure
1. Log in as the SAP IQ user on the Linux system.
2. Create the symbolic link by typing the following commands:

cd <SAP_IQ_installation_directory>/IQ-16_0/lib64
ln -s /usr/lib/libnsriqbr.so libnsriqbr.so

Unlinking NMDA from the SAP IQ server

Before you uninstall NMDA, unlink NMDA from the SAP IQ server environment.
Procedure
1. Log in as the SAP IQ user on the Linux system.
2. Remove the symbolic link by typing the following commands:

cd <SAP_IQ_installation_directory>/IQ-16_0/lib64
rm libnsriqbr.so

Linking and unlinking NMDA in a Sybase ASE environment

Perform the required link or unlink procedure in a Sybase ASE Backup Server
environment:
l After you install NMDA, perform the procedure to link NMDA.
l Before you uninstall NMDA, perform the procedure to unlink NMDA.

38 NetWorker Module for Databases and Applications 19.1 Installation Guide

 UNIX and Linux Installation

Linking NMDA to the Sybase ASE server

After you install NMDA on a Sybase ASE server, link NMDA to the server environment.
Procedure
1. Log in as the Sybase ASE user.
2. Create the symbolic link by using one of the following options:
l If you installed NMDA in the default directory, type the required commands
that are listed in the following table.
l If you installed NMDA in a nondefault directory, perform one of the following
actions:
n Copy the libnsrsyb.xx library file to the default directory, and type
the required linking commands that are listed in the following table.
n Without copying the libnsrsyb.xx library file to the default directory,
type the linking commands that are listed in the following table to link the
libnsrsyb.xx file in the nondefault installation directory /
relocation_path/lib.

Table 9 Linking and unlinking commands for Sybase ASE library file on UNIX or Linux

Operating Create or Install: create the symbolic link

system remove link
Uninstall: remove the symbolic link

AIX Create link cd $SYBASE/$SYBASE_ASE/lib

HP-UX Itanium If not relocated:

Linux x64 ln -s /usr/lib/libnsrsyb.so libnsrsyb.so

Linux x86 If relocated:

Solaris SPARC ln -s /relocation_path/lib/libnsrsyb.so

libnsrsyb.so
Solaris x64
Remove link cd $SYBASE/$SYBASE_ASE/lib

rm libnsrsyb.so

3. On SuSE Linux, if the LANG environment variable is set to POSIX, then create
the /nsr/nsrrc file if it does not exist. Also set LANG in the file to one of the
locales that the Sybase server supports. If you do not have a preferred locale
value, set LANG to C:

# cat /nsr/nsrrc
LANG=C
export LANG

After you set the environment variable, restart the NetWorker client. The
NetWorker Administration Guide provides details about the NetWorker software.

4. With 64-bit Sybase ASE 16.0 SP02, Sybase delivers a 64-bit backup server in
addition to a 32-bit backup server on AIX and Solaris. The ASE backup server
script points to the 64-bit backup server by default.

Linking and unlinking NMDA in a Sybase ASE environment 39

UNIX and Linux Installation

NMDA 9.1 introduced support for the 64-bit backup server in Sybase ASE 16.0
SP02 or later for AIX and Solaris. You should use the 64-bit NMDA Sybase
package on AIX and Solaris with Sybase ASE 16.0 SP02 or later.
If a 32-bit backup server is being used, then a DBA can change the ASE backup
server script to start the 64-bit backup server. This script change may be
necessary when you upgrade from a previous version of NMDA where the 64-
bit backup server is not supported and the 32-bit backup server is used.
The following example shows a backup server run script for a 32-bit backup
server:

#!/bin/sh
#
# Error log path: /space2/sybase/ASE-16_0/install/
sybase160_BS.log
# Maximum number of network connections: 25
# Maximum number of server connections: 20
# Interfaces file path: /space2/sybase/interfaces
# Multibuf executable path: /space2/sybase/ASE-16_0/bin/
sybmultbuf
# Backup Server name: sybase160_BS
#
/space2/sybase/ASE-16_0/bin/backupserver32 \
-e/space2/sybase/ASE-16_0/install/sybase160_BS.log \
-N25 \
-C20 \
-I/space2/sybase/interfaces \
-M/space2/sybase/ASE-16_0/bin/sybmultbuf32 \
-Ssybase160_BS \

If you remove the "32" suffix from "backupserver32" and "sybmultbuf32" in the
script, then the script starts the 64-bit backup server. Change the two lines in
the script to point to the 64-bit backup server:
l Change the following line:
/space2/sybase/ASE-16_0/bin/backupserver32 \
Change the line to appear as follows:
/space2/sybase/ASE-16_0/bin/backupserver \
l Change the following line:
-M/space2/sybase/ASE-16_0/bin/sybmultbuf32 \
Change the line to appear as follows:
-M/space2/sybase/ASE-16_0/bin/sybmultbuf \

Unlinking NMDA from the Sybase ASE server

Before you uninstall NMDA, unlink NMDA from the Sybase ASE server environment.
Procedure
1. Log in as the Sybase ASE user.
2. Type the required commands from Table 9 on page 39 to remove the link.

40 NetWorker Module for Databases and Applications 19.1 Installation Guide

 UNIX and Linux Installation

Uninstalling NMDA on UNIX or Linux systems

Note

If you installed NMDA to support the coexistence of 32-bit and 64-bit databases and
applications on the same host, perform the procedure for Uninstalling 32-bit NMDA on
a 32-bit/64-bit system on page 59.

To uninstall NMDA in any of these configurations, complete the steps in the following
procedure:
l Single host
l Active-passive cluster
l Active-active application cluster, such as DB2 DPF, DB2 pureScale, Informix
MACH, Oracle RAC, or Sybase ASE Cluster Edition
When you uninstall NMDA in a cluster, perform the uninstall procedure on each node
of the cluster that contains the NMDA software.
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 NMDA wizard information (not the binary) is left on the local host.

3. Unlink NMDA from the database environment according to the instructions in

Linking and unlinking NMDA in the environment on UNIX or Linux on page 32.
4. As the root user, uninstall NMDA according to the following uninstall
instructions for the AIX, HP-UX, Linux, or Solaris operating system.

Note

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

Uninstalling NMDA on AIX systems

Uninstall NMDA 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 NMDA on UNIX or
Linux systems on page 41 for the initial part of the uninstall procedure.
2. To uninstall NMDA, use one of the following methods:
l Use the command line interface by typing the following command:

installp -u LGTOnmda.rte

l Use the SMIT GUI program:

Uninstalling NMDA on UNIX or Linux systems 41

UNIX and Linux Installation

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:

LGTOnmda.rte

d. Set the PREVIEW Only option to No.

e. To uninstall NMDA, press Enter.
f. Exit the SMIT GUI program.

Uninstalling NMDA on HP-UX systems

Uninstall NMDA 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 NMDA on UNIX or
Linux systems on page 41 for the initial part of the uninstall procedure.
2. To uninstall NMDA, use one of the following methods:
l Use the CLI program by typing the following command:

swremove NMDA

l Use the swremove GUI program:

a. Type the following swremove command:

swremove -i NMDA

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 NMDA on Linux systems

Uninstall NMDA on a Linux system by running the rpm command.
Procedure
1. Ensure that you have completed the steps in Uninstalling NMDA on UNIX or
Linux systems on page 41 for the initial part of the uninstall procedure.
2. Type the following command:

rpm -e lgtonmda

Note

On Linux, uninstall NMDA before you uninstall the NetWorker client software.

42 NetWorker Module for Databases and Applications 19.1 Installation Guide

 UNIX and Linux Installation

Uninstalling NMDA on Solaris systems

Uninstall NMDA on a Solaris system by running the pkgrm command.
Procedure
1. Ensure that you have completed the steps in Uninstalling NMDA on UNIX or
Linux systems on page 41 for the initial part of the uninstall procedure.

Note

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

2. Type the following command:

pkgrm LGTOnmda

3. When prompted, type y.

The software is uninstalled from the directory that contains the NetWorker
client software.

Uninstalling NMDA on Solaris systems 43

UNIX and Linux Installation

44 NetWorker Module for Databases and Applications 19.1 Installation Guide

CHAPTER 3
Microsoft Windows Installation

This chapter includes the following topics:

l Installing NMDA on Microsoft Windows............................................................. 46

l Linking and unlinking NMDA in the environment on Windows............................ 48
l Repairing the installation on Microsoft Windows................................................52
l Uninstalling NMDA on Microsoft Windows.........................................................52

Microsoft Windows Installation 45

Microsoft Windows Installation

Installing NMDA on Microsoft Windows

Install NMDA on a Windows system by running the NMDA Setup program,
win_x64\networkr\NMDA.exe.
Procedure
1. Complete the initial steps in Installation road maps on page 18. Ensure that you
meet the following requirements:
l You are logged in as an administrator.
l No backups or restores are running.
l The nsrexecd.exe service is running. You can check the service status by
running either Component Services or Task Manager.
l You are in the correct directory that contains the NMDA installation files.

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

l Setup program method with installation wizard:
a. Run the NMDA Setup program, win_x64\networkr\NMDA.exe, and
follow the instructions that the installation wizard provides.

Note

If the NMDA Setup program detects no NetWorker client program files,

the program displays an error message and exits without installing
NMDA.

When the installation completes, a message appears about how to start

the NMDA scheduled backup configuration wizard. The NetWorker
Module for Databases and Applications Version 19.1 Administration Guide
describes the wizard.
b. To exit the Setup program, click Finish.
l Silent installation method:
Run the NMDA.exe command with the appropriate command options:

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

46 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Microsoft Windows Installation

For example, the following command performs a silent NMDA installation

that logs messages in the C:\Program Files\EMC NetWorker\nsr
\logs\nmda_installation.log file:

NMDA.exe /s /q /l "C:\Program Files\EMC NetWorker\nsr\logs

\nmda_installation.log"

When the NMDA package has the same bitness as the NetWorker client
package that is installed on the system, the NMDA program files are installed in
the same directory as the NetWorker client program files,
NetWorker_install_path\bin.
When you install a 32-bit NMDA package on 64-bit Windows with a 64-bit
NetWorker client package, the NMDA program files are installed in
%SystemDrive%\Program Files (x86)\Legato\nsr\bin, regardless of
where the NetWorker client program files are installed.

3. Verify that the system Path environment variable includes the required
directories, including the NetWorker client installation directory and NMDA
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. The Path variable
must include the following directories:
l NetWorker client installation directory, for example,
NetWorker_install_dir\bin.
l NMDA installation directory, as described in step 2.

Note

The directory pathname can include spaces, but there cannot be spaces
before or after the pathname.

d. If you modified the Path variable, restart the NetWorker Remote Exec
Service (the program nsrexecd.exe).
4. Restart the database server, if required:
l If you installed the NetWorker client software for the first time in a
particular directory on a DB2, Oracle, or a Sybase ASE server before you
installed NMDA, then restart the DB2, Oracle, or Sybase ASE server
instance.
l If you installed 32-bit NMDA for the first time with a 64-bit NetWorker client
on a Sybase ASE server and you will perform Client Direct backups to a Data
Domain device, restart the Sybase ASE server.
5. If you installed a 32-bit NMDA package on 64-bit Windows with a 64-bit
NetWorker client package, then restart the NetWorker Remote Exec Service
(the program nsrexecd.exe).
6. Link NMDA to the database or the application server environment by
completing the steps in Linking and unlinking NMDA in the environment on
Windows on page 48.

Installing NMDA on Microsoft Windows 47

Microsoft Windows Installation

7. Return to the installation road map to perform any post-installation procedures.

As part of these procedures, ensure that the NMDA 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 22 provides complete details.

Linking and unlinking NMDA in the environment on Windows

After you install NMDA on Windows as described in the preceding part of this chapter,
perform an additional procedure to link NMDA to the database or application
environment. Before you uninstall NMDA, perform the procedure to unlink NMDA.
Use the correct instructions that follow to perform the linking or unlinking procedure
for the database or application:
l Linking NMDA in a DB2 environment
l Linking and unlinking NMDA in an Informix environment
l Linking and unlinking NMDA in a Lotus Notes environment (optional)
l Linking and unlinking NMDA in a Sybase ASE environment

Note

In an Oracle environment, you do not require the linking or unlinking procedure to

install or uninstall NMDA.

Linking NMDA in a DB2 environment

NOTICE

You must not set the DB2_VENDOR_INI registry variable. Also, if the %INSTHOME%
\sqllib\cfg\vendor.cfg file exists, either remove the file or remove all the
NMDA parameter settings from the file.
DB2_VENDOR_INI is deprecated in DB2 9.5 and discontinued in DB2 10.1, as
announced by IBM. However, DB2_VENDOR_INI might still be in effect in some DB2
versions, such as a DB2 version later than 10.1.
You do not require unlinking steps to uninstall NMDA in a DB2 environment.

After you install NMDA on a DB2 server, use the db2set command to check if the
DB2_VENDOR_INI registry variable is set. The db2set command displays all the
variable settings. For example:

C:\Program Files\IBM\SQLLIB\BIN>db2set
DB2ACCOUNTNAME=CORP\brownr1
DB2INSTOWNER=CA-RBROWN-4
DB2PORTRANGE=60000:60003
DB2INSTPROF=C:\PROGRAMDATA\IBM\DB2\DB2COPY1
DB2COMM=TCPIP

Complete the following steps to implement the changes on the DB2 server.

48 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Microsoft Windows Installation

Procedure
1. Log in as the DB2 user.
2. Remove the %INSTHOME%\sqllib\cfg\vendor.cfg file, or edit the file and
remove all the NMDA parameter settings.
3. Stop the database engine with the db2stop command.
4. Unset the DB2_VENDOR_INI variable with the db2set command:

db2set DB2_VENDOR_INI=

5. If the stack size for the db2syscs.exe file is less than 1024, use the
db2hdr.exe utility to increase the stack size to a minimum of 1024. For
example:

C:\Program Files\IBM\SQLLIB\BIN> ..\misc\db2hdr

db2syscs.exe /s 1024,32

Note

Insufficient stack size can cause backup failure with the error SQL2079N return
code 30.

6. Restart the database engine with the db2start command.

Linking and unlinking NMDA in an Informix environment

Perform the required link or unlink procedure in an Informix environment:
l After you install NMDA, perform the procedure to link NMDA.
l Before you uninstall NMDA, perform the procedure to unlink NMDA.

Linking NMDA to the Informix server environment

After you install NMDA, link NMDA to the Informix server environment.
Procedure
1. Log in as the Informix user.
2. Edit the Informix %ONCONFIG% file and set the BAR_BSALIB_PATH variable
to the full pathname of the NMDA libxbsa.dll (XBSA) library.
The default library pathname is NetWorker_install_path\bin
\libxbsa.dll.

3. Use the type command to ensure that the sm_versions file in the
%INFORMIXDIR%\etc directory includes the following line, and if it does not,
change it:

type sm_versions

1|1.0.1|nwbsa|1

Linking and unlinking NMDA in an Informix environment 49

Microsoft Windows Installation

This action updates the NMDA Informix library links. Without the required
values, ON-Bar commands fail and the following message appears:

ERROR: Version 1.0.1 of the XBSA shared library is not

compatible with version 1 of ON-Bar.

4. Restart the IDS server to apply the %ONCONFIG% file changes.

Unlinking NMDA from the Informix server environment

Before you uninstall NMDA, unlink NMDA from the Informix server environment.
Procedure
1. Log in as the Informix user.
2. Edit the Informix %ONCONFIG% file and unset the BAR_BSALIB_PATH
variable.
3. Restore the copy of the sm_versions file that Informix stored in
%INFORMXIDIR%\etc\sm_versions.std.
4. Restart the IDS server to apply the %ONCONFIG% file changes.

Linking and unlinking NMDA in a Lotus Notes environment

Perform the required link or unlink procedure in a Lotus Notes environment:
l After you install NMDA, perform the procedure to link NMDA.
l Before you uninstall NMDA, perform the procedure to unlink NMDA.
You require these procedures on Windows only when you want to use the NMDA
Lotus document-level restore through the Lotus Notes client GUI to restore deleted or
modified Notes documents.

Note

The 32-bit NMDA Windows package must be installed on the Notes client host.

Linking NMDA to Lotus Notes

After you install NMDA, you can add the document-level recovery feature to the Lotus
Notes client software. The NetWorker Module for Databases and Applications Version
19.1 Administration Guide describes the feature.
Complete the following steps to add the document-level recovery feature.
Procedure
1. Exit the Lotus Notes client or administrator GUI.
2. Copy the nsrdoclb.dll file from the NMDA software directory to the Notes
directory that contains the notes.ini file, which is typically %SystemDrive%
\Lotus\Notes.
3. In the Notes directory, add the following line to the notes.ini file:

AddInMenus=nsrdoclb.dll

If an AddInMenus item exists, you can place a comma after it and add your item
as follows:

AddInMenus=command.dll, nsrdoclb.dll

50 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Microsoft Windows Installation

4. Start the Lotus Notes client software.

The Lotus Notes client Actions menu displays the following choices:
l NMDA Lotus - Restore Selected Documents
l NMDA Lotus - Restore Deleted Documents

Unlinking NMDA from Lotus Notes

Before you uninstall NMDA, remove the NMDA document-level recovery feature from
the Notes Client software.
Procedure
1. Exit the Lotus Notes client or administrator GUI.
2. In the Notes directory, remove the following line from the notes.ini file:

AddInMenus=nsrdoclb.dll

3. Delete the nsrdoclb.dll file from the Notes directory, which is typically
%SystemDrive%\Lotus\Notes.
4. Start the Lotus Notes client software.
The recovery items previously added to the Lotus Notes client Actions menu
are removed.

Linking and unlinking NMDA in a Sybase ASE environment

Perform the required link or unlink procedure in a Sybase ASE Backup Server
environment:
l After you install NMDA, perform the procedure to link NMDA.
l Before you uninstall NMDA, perform the procedure to unlink NMDA.

Linking NMDA to the Sybase ASE server environment

Copy the libnsrsyb.dll file from the NetWorker location to the Sybase ASE
location.
Procedure
1. Go to the directory that contains the NMDA installed files,
NetWorker_install_path\bin.
2. Copy the libnsrsyb.dll file to the %SYBASE%\%SYBASE_ASE%\lib
directory.

Unlinking NMDA from the Sybase ASE server environment

Before you uninstall NMDA, remove the link to the Sybase ASE server environment.
Procedure
1. Open the %SYBASE%\%SYBASE_ASE%\lib directory.
2. Delete the libnsrsyb.dll entry.

Linking and unlinking NMDA in a Sybase ASE environment 51

Microsoft Windows Installation

Repairing the installation on Microsoft Windows

To repair an NMDA installation on a Microsoft Windows system, complete the
following steps.
Procedure
1. Log in as the Windows system local administrator user on the NMDA host.
2. Ensure that no backups or restores are running.
3. Go to the directory that contains the NMDA installation files as described in
Accessing the NMDA software on page 16.
4. Run the win_x64\networkr\NMDA.exe program.
5. In the Welcome dialog box, 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. The Setup program reinstalls the NMDA 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 the NetWorker Client Configuration Wizard. The NetWorker Module for
Databases and Applications Version 19.1 Administration Guide describes the
configuration wizard.

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

Uninstalling NMDA on Microsoft Windows

Note

If you installed NMDA to support the coexistence of 32-bit and 64-bit databases and
applications on the same host, perform the procedure for Uninstalling 32-bit NMDA on
a 32-bit/64-bit system on page 59.

To uninstall NMDA in any of the following configurations, complete the procedure as

follows:
l Single host
l Active-passive cluster
l Active-active application cluster, such as DB2 DPF, Informix MACH, Oracle RAC,
or Sybase ASE Cluster Edition
When you uninstall NMDA in a cluster, perform the uninstall procedure on each node
of the cluster that contains the NMDA software.
Procedure
1. Log in as the Windows system local administrator user on the NMDA host.
2. Ensure that no backups or restores are running.
3. Ensure that the NetWorker Remote Exec service, nsrexecd.exe, is running.

52 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Microsoft Windows Installation

Note

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

4. Unlink NMDA from the database or application environment according to the

instructions in Linking and unlinking NMDA in the environment on Windows on
page 48.
5. Uninstall NMDA by using one of the following methods:

Note

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

l Setup program method with installation wizard:

a. Go to the directory that contains the NMDA installation files as described
in Accessing the NMDA software on page 16, and then run the
win_x64\networkr\NMDA.exe program.
b. In the Program Maintenance dialog box, select Remove, and then click
Next.
c. In the Remove the Program dialog box, click Remove.
l Silent uninstallation method:
Run the NMDA.exe command with the appropriate command options:

NMDA.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
double quotes 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 NMDA uninstallation
that logs messages in the C:\Program Files\EMC NetWorker\nsr
\logs\nmda_uninstallation.log file:

NMDA.exe /uninstall /s /q /l "C:\Program Files\EMC NetWorker

\nsr\logs\nmda_uninstallation.log"

l Windows Control Panel method:

a. In the Windows Control Panel window, select Add or Remove
Programs or Programs and Features, depending on the Microsoft
Windows version.
b. In the Add or Remove Programs window, select NetWorker Module for
Databases and Applications and click Remove.

Uninstalling NMDA on Microsoft Windows 53

Microsoft Windows Installation

54 NetWorker Module for Databases and Applications 19.1 Installation Guide

CHAPTER 4
NMDA with Mixed 32-bit and 64-bit Databases
and Applications

This chapter includes the following topics:

l Coexistence of 32-bit and 64-bit databases and applications.............................56

l Installing NMDA to enable 32-bit and 64-bit coexistence...................................56
l Uninstalling 32-bit NMDA on a 32-bit/64-bit system......................................... 59

NMDA with Mixed 32-bit and 64-bit Databases and Applications 55

NMDA with Mixed 32-bit and 64-bit Databases and Applications

Coexistence of 32-bit and 64-bit databases and applications

NMDA supports specific combinations of 32-bit and 64-bit database and application
software that are installed on the same 64-bit operating system.
For example, NMDA supports the combination of 32-bit Informix and 64-bit Oracle
servers on the same 64-bit Windows system.
Refer to the documentation for the database or application that you are using for
details about the versions of 32-bit and 64-bit application software that can coexist on
the same 64-bit system.
The NMDA support for 32-bit and 64-bit application coexistence on 64-bit systems
includes the following limitations:
l You cannot use the NMDA wizard to configure backups of 32-bit DB2 or 32-bit
Lotus on a 64-bit Windows system where 32-bit and 64-bit applications coexist.
l You cannot use the NMDA wizard to configure backups of 32-bit Lotus on a 64-bit
AIX system where 32-bit and 64-bit applications coexist.
l You cannot use the NetWorker User for Lotus program for backups or restores of
32-bit Notes on a 64-bit Windows system where 32-bit and 64-bit applications
coexist.
l 32-bit or 64-bit Sybase cannot coexist with DB2, Informix, Lotus Domino/Notes,
or Oracle on a 64-bit Windows system.
l You cannot relocate the software on a 64-bit Solaris SPARC system where 32-bit
and 64-bit applications coexist.
l NMDA does not support 32-bit and 64-bit application coexistence on a 64-bit
Linux system.
The following topics describe how to install and uninstall NMDA on a system with both
32-bit and 64-bit databases or applications:
l Installing NMDA to enable 32-bit and 64-bit coexistence
l Uninstalling 32-bit NMDA on a 32-bit/64-bit system
The NetWorker Module for Databases and Applications Version 19.1 Administration Guide
provides configuration instructions and special considerations for NMDA in an
environment with both 32-bit and 64-bit databases and applications.

Installing NMDA to enable 32-bit and 64-bit coexistence

To install NMDA on a 64-bit operating system where both 32-bit and 64-bit databases
or applications are running, install 64-bit NMDA and enable NMDA for 32-bit use.

Note

NMDA does not support 32-bit and 64-bit application coexistence on a 64-bit Linux
system.

Procedure
1. If you install 32-bit NMDA on the system, uninstall NMDA with the required
procedure:
l Uninstalling NMDA on UNIX or Linux systems on page 41

56 NetWorker Module for Databases and Applications 19.1 Installation Guide

 NMDA with Mixed 32-bit and 64-bit Databases and Applications

l Uninstalling NMDA on Microsoft Windows on page 52

2. Install 64-bit NMDA for the operating system. The following chapters provide
details for each operating system:
l Chapter 2, UNIX and Linux Installation
l Chapter 3, Microsoft Windows Installation

After the software installation completes, a message appears about how to

start the NMDA scheduled backup configuration wizard. The NetWorker Module
for Databases and Applications Version 19.1 Administration Guide describes the
wizard.
3. Go to the 32-bit directory under the directory that contains the NMDA
installation package for the operating system as described in Accessing the
NMDA software on page 16.
4. Manually copy the 32-bit files that are listed in the following table to the
specified location for each 32-bit database or application on the system.
5. Complete the software linking and post-installation procedures for the 32-bit
NMDA software components if required:
l Linking and unlinking NMDA in the environment on UNIX or Linux on page 32
l Linking and unlinking NMDA in the environment on Windows on page 48
l Road map to post-installation procedures on page 22

Use the program file name that is listed in the following table when performing
these steps. For example, to link the 32-bit NMDA Sybase component to the
Sybase ASE server on AIX:

cd $SYBASE/$SYBASE_ASE/lib
ln -s /usr/lib/libnsrsyb32.so libnsrsyb.so

Note

l IBM does not support 32-bit DB2 software on 64-bit UNIX or Linux.
l Oracle does not support 32-bit Oracle software on 64-bit UNIX, Linux, or
Windows.

Table 10 Additional steps to enable NMDA for a 32-bit application

On this 64- For this 32- Copy these 32-bit files from the 32-bit To this directory
bit bit directory
operating application
system
AIX Informix informix/libnsrifmx32.so /usr/lib

l nsrdasv32 /usr/bin

l nsrdaprobe32

Lotus l nsrdasv32 /usr/bin

Installing NMDA to enable 32-bit and 64-bit coexistence 57

NMDA with Mixed 32-bit and 64-bit Databases and Applications

Table 10 Additional steps to enable NMDA for a 32-bit application (continued)

On this 64- For this 32- Copy these 32-bit files from the 32-bit To this directory
bit bit directory
operating application
system

l nsrdaprobe32
l lotus/nsrdocrc32
l lotus/nsrnotesrc32

Sybase ASE sybase/libnsrsyb32.so /usr/lib

l nsrdasv32 /usr/bin

l nsrdaprobe32
l sybase/nsrsybcc32
l sybase/nsrsybrc32
l sybase/threshold.sql

HP Itanium Sybase ASE sybase/libnsrsyb32.so /usr/lib

Solaris SPARC Informix informix/libnsrifmx32.so /usr/lib

l nsrdasv32 /usr/sbin1

l nsrdaprobe32

Lotus l nsrdasv32 /usr/sbin1

l nsrdaprobe32
l lotus/nsrdocrc32
l lotus/nsrnotesrc32
l lotus/nsrlotusra
l lotus/nmlra.jar
l lotus/nmlra_res.jar

Sybase ASE sybase/libnsrsyb32.so /usr/lib

l nsrdasv32 /usr/sbin1

l nsrdaprobe32
l sybase/nsrsybcc32
l sybase/nsrsybrc32

Windows x64 DB2 l 32-bit\nsrdasv32.exe NetWorker_install_path\bin

l 32-bit\nsrdaprobe32.exe
l 32-bit\db2\libnsrdb232.dll
l 32-bit\db2\nsrdb2rlog32.exe

Informix l 32-bit\nsrdasv32.exe NetWorker_install_path\bin

l 32-bit\nsrdaprobe32.exe

58 NetWorker Module for Databases and Applications 19.1 Installation Guide

 NMDA with Mixed 32-bit and 64-bit Databases and Applications

Table 10 Additional steps to enable NMDA for a 32-bit application (continued)

On this 64- For this 32- Copy these 32-bit files from the 32-bit To this directory
bit bit directory
operating application
system

l 32-bit\informix\libxbsa32.dll

Lotus l 32-bit\nsrdasv32.exe NetWorker_install_path\bin

l 32-bit\nsrdaprobe32.exe
l 32-bit\lotus\nsrdocrc32.exe
l 32-bit\lotus\nsrnotesrc32.exe

Sybase ASE Not applicable. 32-bit or 64-bit Sybase ASE cannot coexist with another application on 64-bit
Windows.
1 Copy the 32-bit file to /usr/sbin or to the same location where 64-bit NMDA was relocated.

Uninstalling 32-bit NMDA on a 32-bit/64-bit system

Complete the required steps to uninstall NMDA on a system where the 32-bit and 64-
bit databases or applications coexist.
Procedure
1. Ensure that no backups or restores are running on the NMDA host.
2. Unlink the NMDA 32-bit components that you manually installed according to
the following instructions:
l Linking and unlinking NMDA in the environment on UNIX or Linux on page 32
l Linking and unlinking NMDA in the environment on Windows on page 48

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

4. Manually delete the files for the 32-bit database or application that you
manually copied during installation as shown in Table 10 on page 57.
5. Uninstall 64-bit NMDA according to the required instructions:
l Uninstalling NMDA on UNIX or Linux systems on page 41
l Uninstalling NMDA on Microsoft Windows on page 52

Uninstalling 32-bit NMDA on a 32-bit/64-bit system 59

NMDA with Mixed 32-bit and 64-bit Databases and Applications

60 NetWorker Module for Databases and Applications 19.1 Installation Guide

APPENDIX A
Uninstalling ISM on an Informix Server

This appendix includes the following topics:

l ISM software on an Informix server................................................................... 62

l Uninstalling ISM on UNIX or Linux......................................................................62
l Uninstalling ISM on Microsoft Windows.............................................................63

Uninstalling ISM on an Informix Server 61

Uninstalling ISM on an Informix Server

ISM software on an Informix server

Informix Storage Manager (ISM) is a storage management software that is packaged
and installed with Informix Dynamic Server (IDS).
For Informix servers only, if you installed ISM software, uninstall the software before
you install NMDA by using the OS-specific instructions in the following topics:
l Uninstalling ISM on UNIX or Linux
l Uninstalling ISM on Microsoft Windows

Note

Starting with Informix 12.10, Informix Primary Storage Manager (PSM) replaces ISM.
When you install NMDA with IDS 12.10, you do not need to uninstall PSM. Follow the
linking instructions in the correct linking section of this guide.

Uninstalling ISM on UNIX or Linux

Complete the required steps to uninstall ISM on an Informix server on a UNIX or Linux
host.
Procedure
1. Log in as the root user on the NMDA host.
2. Change to the Informix directory:

# cd $INFORMIXDIR/bin

3. Shut down the ISM daemons:

# ./ism_shutdown

Note

The ism_shutdown command does not uninstall ISM. Complete the following
steps.

4. Verify that the daemons are shut down:

# ps -ef | grep nsr

5. Move the ISM executables to a temporary directory. For example:

# mkdir ISM.TMP
# mv ism* ISM.TMP
# mv nsr* ISM.TMP
# mv mm* ISM.TMP
# mv save* ISM.TMP
# mv scanner ISM.TMP

62 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Uninstalling ISM on an Informix Server

# mv uasm ISM.TMP
# mv recover ISM.TMP
# mv ansrd ISM.TMP

6. Move the ISM catalogs to a temporary directory:

# cd $INFORMIXDIR
# mv ism ism.bak

7. Remove the symbolic link to the ISM catalogs:

# rm /nsr

8. Remove the call to ism_catalog from the $INFORMIXDIR/bin/onbar

script.
9. Remove any references to ISM in the environment variable PATH.
10. Edit the $INFORMIXDIR/etc/$ONCONFIG file, and comment out the following
line if it exists:

#BAR_BSALIB_PATH ISM_library

Also, comment out any references to the following parameters:

ISM_DATA_POOL
ISM_LOG_POOL

Uninstalling ISM on Microsoft Windows

There are two methods to uninstall the ISM software on an Informix server that is
installed on a Windows host. You can use the IDS Server Setup program or the manual
method.

Uninstalling ISM on Windows with the Setup program

The recommended method to uninstall ISM on an Informix server on Windows is to use
the IDS Server Setup program, if available.
Procedure
1. Launch the IDS Server Setup program.
2. Select Modify the Installation.
3. Clear the selection Informix Storage Manager.
4. Complete the Setup program to uninstall ISM.

Uninstalling ISM on Microsoft Windows 63

Uninstalling ISM on an Informix Server

Uninstalling ISM on Windows manually

If the IDS Server Setup program is not available, manually uninstall ISM on an Informix
server on Windows.
Procedure
1. Log in as user informix.
2. To set the Informix Database server environment variables, type the following
command:

database-servername.cmd

3. Change to the ISM directory. For example:

cd C:\ism\2.2\bin

4. Set the ISM path variable. For example:

set ISMDIR=C:\ism\2.2

5. Shut down the ISM services:

ism_shutdown -deinstall

6. Shut down ISM, and then verify that there are no services listed for ISM in
Control Panel > Administrative Tools > Services.
7. Rename the directory that contains ISM:

rename ism ism.bak

8. Remove the call to ism_catalog from the %INFORMIXDIR%\bin

\onbar.bat file.
9. Remove any references to ISM in the environment variable PATH.
Delete the %ISMDIR%\bin directory entry from the user environment variable
PATH. For example, change the following PATH setting:

PATH=C:\installdir;D:\ISM\2.20\bin;C:\msdev

The changed PATH setting is as follows:

PATH=C:\installdir;C:\msdev

64 NetWorker Module for Databases and Applications 19.1 Installation Guide

 Uninstalling ISM on an Informix Server

10. Edit the %INFORMIXDIR%\%ONCONFIG% file, and comment out the following
line, if it exists:

#BAR_BSALIB_PATH ISM_library

Also comment out any references to the following parameters:

ISM_DATA_POOL
ISM_LOG_POOL

11. Remove the ISM portmapper:

a. Stop the ISM portmapper service.
b. Type Regedit, and then delete the following entry:

HKEY_LOCAL_MACHINE\SYSTEM\CURRENTCONTROLSET\SERVICES\PORTMAP

Confirm that the Displayname is ISM Portmapper before deleting the entry.
12. Edit the registry to delete any of the following keys, if present:

NOTICE

Edit the registry with caution. Errors can corrupt the Windows system.

l Hkey_Local_Machine\Software\XBSA
l Hkey_Local_Machine\Software\Informix\ISM
l Hkey_Local_Machine\Software\Informix\Informix Storage
Manager

13. Restart the computer.

Uninstalling ISM on Windows manually 65

Uninstalling ISM on an Informix Server

66 NetWorker Module for Databases and Applications 19.1 Installation Guide