Networker 9.x - NMDA Installation Guide
Networker 9.x - NMDA Installation Guide
and Applications
Version 9.0.x
Installation Guide
302-001-784
REV 07
Copyright © 2009-2017 Dell Inc. or its subsidiaries. All rights reserved.
Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.
THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND
WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED
IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.
Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.
Published in the USA.
Dell EMC
Hopkinton, Massachusetts 01748-9103
1-508-435-1000 In North America 1-866-464-7381
www.DellEMC.com
2 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
CONTENTS
Tables 5
Preface 7
EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide 3
CONTENTS
Chapter 4 NMDA with Mixed 32-bit and 64-bit Databases and Applications
49
Coexistence of 32-bit and 64-bit databases and applications..................... 50
Installing NMDA to enable 32-bit and 64-bit coexistence........................... 50
Uninstalling 32-bit NMDA on a 32-bit/64-bit system................................. 53
4 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
TABLES
1 Revision history............................................................................................................ 7
2 Style conventions......................................................................................................... 9
3 Typical hosts and software in the NMDA environment................................................ 12
4 Software directory on the DVD................................................................................... 15
5 Zipped download file and software directory for install............................................... 17
6 NetWorker startup commands on UNIX and Linux...................................................... 18
7 Command to register the wizard.................................................................................22
8 Linking and unlinking commands for Oracle library file on UNIX or Linux.................... 32
9 Linking and unlinking commands for Sybase ASE library file on AIX, Linux, Solaris..... 34
10 Additional steps to enable NMDA for a 32-bit application........................................... 51
EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide 5
TABLES
6 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Preface
As part of an effort to improve its product lines, EMC periodically releases revisions of
its software and hardware. Therefore, some functions described in this document
might not be supported by all versions of the software or hardware currently in use.
The product release notes provide the most up-to-date information on product
features.
Contact your EMC technical support professional if a product does not function
correctly or does not function as described in this document.
Note
This document was accurate at publication time. Go to EMC Online Support (https://
support.emc.com) to ensure that you are using the latest version of this document.
Purpose
This document describes how to install, update, and uninstall the EMC NetWorker
Module for Databases and Applications (NMDA) release 9.0.x.
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.
EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide 7
Preface
04 June 29, 2016 Updated the following information for the release of NMDA 9.0.1:
l Changed the NMDA version number to 9.0.x in the guide title.
l Changed 9.0 references to 9.0.x throughout the guide, as appropriate.
l Accessing NMDA from the EMC website on page 16—Updated the
Windows software package names in step 5.
l Installing NMDA on AIX systems on page 24—Updated the detail about
the lslpp command output in the first bullet in step 2.
8 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Preface
Related documentation
You can find additional EMC publications for this product release and related
NetWorker products at EMC Online Support.
The EMC NetWorker Online Software Compatibility Matrix at http://
compatibilityguide.emc.com:8080/CompGuideApp/ 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
EMC uses the following conventions for special notices:
NOTICE
Note
Typographical conventions
EMC uses the following type style conventions in this document:
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, prompts, and syntax
l Commands and options
EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide 9
Preface
Product information
For documentation, release notes, software updates, or information about EMC
products, go to EMC Online Support at https://support.emc.com.
Technical support
Go to EMC Online Support and click Service Center. Several options for contacting
EMC Technical Support appear on the site. Note that to open a service request, you
must have a valid support agreement. Contact your EMC sales representative for
details about obtaining a valid support agreement or with questions about your
account.
Online communities
Go to EMC Community Network at https://community.emc.com for peer contacts,
conversations, and content on product support and solutions. Interactively engage
online with customers, partners, and certified professionals for all EMC products.
Your comments
Your suggestions help to improve the accuracy, organization, and overall quality of the
user publications. Send your opinions of this document to
[email protected].
10 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
CHAPTER 1
Getting Started
Getting Started 11
Getting Started
Note
Before you install NMDA, install both the NetWorker base client and extended client
software packages on the database server host.
12 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Getting Started
The EMC NetWorker Installation Guide describes how to install the NetWorker server,
storage node, client, and NMC software.
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 EMC
NetWorker Snapshot Management Integration Guide provides a full list of restrictions
and details.
NMDA software
Install NMDA on a supported database server or application server.
For Oracle ASM snapshot backups and restores with EMC Replication Manager, also
install NMDA on the mount host.
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 EMC NetWorker Module for Databases and Applications Installation Guide for the
existing version, if you are updating from a previous NMDA version to NMDA 9.0.x
l EMC NetWorker Module for Databases and Applications Release 9.0.x Release Notes
l EMC NetWorker Module for Databases and Applications Release 9.0.x Administration
Guide
l EMC NetWorker Administration Guide for the supported NetWorker release
l EMC NetWorker Online Software Compatibility Matrix
14 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Getting Started
Installation media
Use one of the following installation media:
l DVD from the EMC Information Protection and Availability Product Families Media
Kit
l If you download the software, the EMC Online Support website
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 EMC website.
Installation media 15
Getting Started
a. Select DOWNLOADS.
The Downloads page appears.
16 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Getting Started
gunzip file_name.tar.gz
Note
Install NMDA on each node host in a cluster that performs backup and recovery
operations.
Procedure
1. Review the Installation checklists on page 14 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
55.
3. Ensure that you have installed the NetWorker client software on the host. The
client version must support the NMDA version to be installed.
Note
If you do not start the installation from the correct directory, the installation
might fail.
NOTICE
Do not use an upgrade option on the platform, for example, the rpm -U
command on Linux.
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
AIX /etc/rc.nsr
18 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Getting Started
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 21 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 49.
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.
Note
On HP Itanium, if you installed Sybase ASE 15.5 or later and Sybase ASE 15.0.3
on the same system, follow the instructions in NMDA with Mixed 32-bit and 64-
bit Databases and Applications on page 49. The ASE Backup Server is 64-bit
in the 15.5 and later releases and the server is 32-bit in earlier releases.
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:
l UNIX and Linux Installation on page 23
l Microsoft Windows Installation on page 39
Note
10. Perform all the required post-installation procedures. Road map to post-
installation procedures on page 21 provides details.
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 EMC 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
Complete the following steps to update NMDA with the Package Manager.
Procedure
1. Review the Installation checklists on page 14.
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 EMC NetWorker Updating from a Previous Release Guide at EMC Online
Support describes the operating systems that support the Package Manager
feature on the NMDA host.
l The NMDA client host contains a supported version of the NetWorker client
software.
l The remote NetWorker server is release 9.0 or later. The NetWorker client
on the NMDA host is release 8.1 or later.
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 EMC NetWorker Updating from a Previous Release Guide provides more
information.
20 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Getting Started
5. Perform all the required post-installation procedures on the client host. Road
map to post-installation procedures on page 21 provides details.
2. If you perform snapshot backups for Oracle ASM on the host, install and enable
the required Replication Manager agent software on the NMDA host and the
mount host.
The Replication Manager server software must exist on a separate host.
nsradmin -p nsrexecd
nsradmin.exe -p nsrexecd
Check that the command output includes the correct values for "backup
type" (database or application type that you want to protect) and "product
version" (version of 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.
Informix nsrifmxra(.exe) -i
Lotus nsrlotusra(.exe) -i
MySQL nsrmysqlra(.exe) -i
Oracle nsrorara(.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:
22 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
CHAPTER 2
UNIX and Linux Installation
2. Run either the installp CLI program or the SMIT GUI program:
l To run the CLI program, type the following command:
smitty install_latest
b. In the Entry Field, type the location of the NMDA installation software as
the complete pathname of the directory that is described in Accessing
the NMDA software on page 15.
c. Select the option SOFTWARE to install.
d. Type yes in response to the following prompts:
24 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
UNIX and Linux Installation
nsradmin -p nsrexecd
nsradmin> print type: NSR remote agent
2. To run either the CLI or GUI program, type the swinstall command:
l To run the swinstall CLI program, type the following command:
swinstall -x mount_all_filesystems=false -i -s /
dir_pathname/LGTOnmda.pkg NMDA
nsradmin -p nsrexecd
nsradmin> print type: NSR remote agent
l On Linux x64:
l On Linux x86:
3. To verify that the installation was successful, type the rpm -aq command:
26 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
UNIX and Linux Installation
The command output must include the proper lines, for example:
lgtoclnt-9.0.0.0-1
lgtoxtdclnt-9.0.0.0-1
lgtonmda-9.0.0.0-1
nsradmin -p nsrexecd
nsradmin> print type: NSR remote agent
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.
nsradmin -p nsrexecd
nsradmin> print type: NSR remote agent
Note
In a Lotus Domino or MySQL environment, you do not require the linking or unlinking
procedure to install or uninstall NMDA.
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.
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.
28 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
UNIX and Linux Installation
db2set DB2_VENDOR_INI=
3. Update the sm_versions file (Informix user password required) by typing the
following command:
This action updates the NMDA Informix library links. Without the required
values, ON-Bar commands fail and the following message appears:
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:
l If you installed the MySQL 5.5 or 5.6 library in a nondefault location:
n On 32-bit Linux, type the following command:
ln –s <install_pathname>/libmysqlclient.so.18 /usr/lib/
libmysqlclient.so
ln –s <install_pathname>/libmysqlclient.so.18 /usr/lib64/
libmysqlclient.so
30 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
UNIX and Linux Installation
ln –s /usr/lib/mysql/libmysqlclient.so.20 /usr/lib/
libmysqlclient.so
ln –s /usr/lib64/mysql/libmysqlclient.so.20 /usr/lib64/
libmysqlclient.so
ln –s <install_pathname>/libmysqlclient.so.20 /usr/lib/
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:
ls -lart /usr/lib/libmysqlclient*
l On 64-bit Linux:
ls -lart /usr/lib64/libmysqlclient*
rm /usr/lib/libmysqlclient.so
rm /usr/lib64/libmysqlclient.so
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.
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
32 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
UNIX and Linux Installation
Table 8 Linking and unlinking commands for Oracle library file on UNIX or Linux (continued)
Linking NMDA to the Sybase ASE server on AIX, Linux, and Solaris
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 AIX, Linux, Solaris
% 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 EMC
NetWorker Administration Guide provides details about the NetWorker software.
4. With Sybase 16.0 SP02, Sybase delivers a 64-bit backup server in addition to a
32-bit backup server. The backup server script points to the 64-bit backup
server by default. To enable NMDA backups on AIX and Solaris SPARC, change
the script to point to the 32-bit backup server.
For example, the default backup script is as follows:
#!/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/backupserver \
-e/space2/sybase/ASE-16_0/install/sybase160_BS.log \
-N25 \
-C20 \
-I/space2/sybase/interfaces \
-M/space2/sybase/ASE-16_0/bin/sybmultbuf \
-Ssybase160_BS \
Change two lines in the script to point to the 32-bit backup server:
34 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
UNIX and Linux Installation
Note
Regardless of the Sybase ASE version, the NMDA installation on HP Itanium places
only the libnsrsyb.so (64-bit) library file in the NMDA installation directory. To
ensure that you link the correct library, perform the required procedure for the ASE
version.
cp 32-bit/sybase/libnsrsyb32.so /usr/lib/libnsrsyb32.so
Note
3. As the Sybase ASE user, type the following commands to link the library file to
the Sybase ASE server:
cd $SYBASE/$SYBASE_ASE/lib
ln -s /usr/lib/libnsrsyb32.so libnsrsyb.so
cd $SYBASE/$SYBASE_ASE/lib
ln -s /usr/lib/libnsrsyb.so libnsrsyb.so
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 53.
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.
36 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
UNIX and Linux Installation
Note
installp -u LGTOnmda.rte
smitty remove
LGTOnmda.rte
swremove NMDA
swremove -i NMDA
rpm -e lgtonmda
Note
On Linux, uninstall NMDA before you uninstall the NetWorker client software.
Note
To uninstall NMDA on Solaris zones, first uninstall NMDA on the global zone,
and then uninstall NMDA on each required sparse root zone.
pkgrm LGTOnmda
38 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
CHAPTER 3
Microsoft Windows Installation
Note
NMDA.exe <installation_options>
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
40 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Microsoft Windows Installation
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 42.
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
Note
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.
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.
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=
42 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Microsoft Windows Installation
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.
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
This action updates the NMDA Informix library links. Without the required
values, ON-Bar commands fail and the following message appears:
Note
The 32-bit NMDA Windows package must be installed on the Notes client host.
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
44 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Microsoft Windows Installation
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.
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 53.
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.
46 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Microsoft Windows Installation
Note
48 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
CHAPTER 4
NMDA with Mixed 32-bit and 64-bit Databases
and Applications
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
50 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
NMDA with Mixed 32-bit and 64-bit Databases and Applications
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.
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
l nsrdaprobe32
l lotus/nsrdocrc32
l lotus/nsrnotesrc32
l nsrdasv32 /usr/bin
l nsrdaprobe32
l sybase/nsrsybcc32
l sybase/nsrsybrc32
l sybase/threshold.sql
l nsrdasv32 /usr/sbin1
l nsrdaprobe32
On this 64- For this 32- Copy these 32-bit files from the 32-bit To this directory
bit bit directory
operating application
system
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
l nsrmysqlrc32
libnsrmysql32.so /usr/lib
libmysqlapi32.so /usr/lib
Note
libmysqlapiwrap32.so /usr/lib
Note
l nsrdasv32 /usr/sbin1
l nsrdaprobe32
l sybase/nsrsybcc32
l sybase/nsrsybrc32
l nsrdasv32 /usr/sbin1
l nsrdaprobe32
l nsrdaprobe32
l lotus/nsrdocrc32
l lotus/nsrnotesrc32
l lotus/nsrlotusra
52 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
NMDA with Mixed 32-bit and 64-bit Databases and Applications
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 lotus/nmlra.jar
l lotus/nmlra_res.jar
l nsrdasv32 /usr/sbin1
l nsrdaprobe32
l sybase/nsrsybcc32
l sybase/nsrsybrc32
l 32-bit\nsrdaprobe32.exe
l 32-bit\db2\libnsrdb232.dll
l 32-bit\db2\nsrdb2rlog32.exe
l 32-bit\nsrdaprobe32.exe
l 32-bit\informix\libxbsa32.dll
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.
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 51.
5. Uninstall 64-bit NMDA according to the required instructions:
l Uninstalling NMDA on UNIX or Linux systems on page 36
l Uninstalling NMDA on Microsoft Windows on page 46
54 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
APPENDIX A
Uninstalling ISM on an Informix Server
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.
# cd $INFORMIXDIR/bin
# ./ism_shutdown
Note
The ism_shutdown command does not uninstall ISM. Complete the following
steps.
# mkdir ISM.TMP
# mv ism* ISM.TMP
# mv nsr* ISM.TMP
# mv mm* ISM.TMP
# mv save* ISM.TMP
# mv scanner ISM.TMP
56 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide
Uninstalling ISM on an Informix Server
# mv uasm ISM.TMP
# mv recover ISM.TMP
# mv ansrd ISM.TMP
# cd $INFORMIXDIR
# mv ism ism.bak
# rm /nsr
#BAR_BSALIB_PATH ISM_library
ISM_DATA_POOL
ISM_LOG_POOL
database-servername.cmd
cd C:\ism\2.2\bin
set ISMDIR=C:\ism\2.2
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:
PATH=C:\installdir;D:\ISM\2.20\bin;C:\msdev
PATH=C:\installdir;C:\msdev
58 EMC NetWorker Module for Databases and Applications 9.0.x 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
ISM_DATA_POOL
ISM_LOG_POOL
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
60 EMC NetWorker Module for Databases and Applications 9.0.x Installation Guide