NetWorker Module For Databases and Applications 19.1 Command Reference Guide PDF
NetWorker Module For Databases and Applications 19.1 Command Reference Guide PDF
and Applications
Version 19.1
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 Command Reference Guide
Preface
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 use the command line programs in the NetWorker
Module for Databases and Applications (NMDA) release 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.
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
You can use the following resources to find more information about this product,
obtain support, and provide feedback.
NetWorker Module for Databases and Applications 19.1 Command Reference Guide 3
Preface
4 NetWorker Module for Databases and Applications 19.1 Command Reference Guide
Maintenance Commands nsrdaadmin ( 1m )
NAME nsrdaadmin – NetWorker Module for Databases and Applications (NMDA) scheduled
backup administrative program
DESCRIPTION The nsrdaadmin -P command is used to set the encrypted password that is required
for DB2, MySQL, Orchestrated Application Protection, SAP IQ, and Sybase backups.
The NetWorker Module for Databases and Applications Administration Guide pro-
vides more details on use of the nsrdaadmin command.
OPTIONS -P Sets the encrypted password in the specified NMDA configuration file. The iq
option specifies to set the encrypted password for the SAP IQ utility_db data-
base, which is used in a SAP IQ restore.
– z configuration_file_path
Specifies the full pathname of the NMDA configuration file.
NMDA 19.1 5
Maintenance Commands nsrdaprobe ( 1m )
cmd_options:
LOG_THRESHOLD= threshold_number
NSR_DEBUG_LEVEL= debug_level
DESCRIPTION The nsrdaprobe program is used to automatically start an NMDA backup when a
specified number or size of logs has been generated since the previous probe-based
backup. The nsrdaprobe command should not be manually invoked, but should be
executed as part of a probe-based savegrp.
When the nsrdaprobe command is first invoked, it returns success and triggers a
probe-based savegrp backup. Once the backup has successfully completed, the transac-
tion log state is recorded in the State field of the corresponding NetWorker Probe
resource on the NetWorker server.
When the nsrdaprobe command is subsequently invoked, a comparison determines the
delta (difference) between the current number or size of the transaction logs and the
value recorded in the State field. If the delta is greater than or equal to the
threshold_number value, the backup proceeds.
Use of the nsrdaprobe program requires NetWorker server version 7.5 or later.
OPTIONS – c client_name
Specifies the NetWorker client name.
– g group_name
Specifies the NetWorker group name.
-o cmd_options
Specifies the command options set in the NetWorker Probe resource.
– s server_name
Specifies the NetWorker server name.
-t state Specifies the State attribute value for the NetWorker Probe resource.
EXAMPLES The following example shows a nsrdaprobe command for a DB2 probe-based backup,
including the arguments passed by the probe-based savegrp:
NMDA 19.1 6
Maintenance Commands nsrdarc ( 1m )
SYNOPSIS nsrdarc
DESCRIPTION The nsrdarc command is used to invoke a recovery when configuring the recovery
resource with the NMDA recovery wizard.
The nsrdarc program is an internal program and run by the daemon nsrexecd(1m).
The nsrdarc program cannot be used for a recovery on the command line.
Instead, the corresponding database recovery command must be used.
The NetWorker Module for Databases and Applications Administration Guide pro-
vides more details on how to perform a recovery on the command line.
NMDA 19.1 7
Maintenance Commands nsrdasv ( 1m )
DESCRIPTION The nsrdasv executable program is used to invoke scheduled backups for DB2, Infor-
mix, Lotus Domino/Notes, MySQL, Oracle, SAP IQ, and Sybase systems. The nsrdasv
command must be set in the Backup Command field of the corresponding NetWorker
Client resource.
The nsrdasv executable program is also used to invoke manual backups of Lotus
Domino/Notes, MySQL, SAP IQ, and Sybase systems. The nsrdasv program cannot be
used for manual backups of DB2, Informix, and Oracle systems. Instead, the
corresponding database backup command must be used to start a DB2, Informix, or
Oracle manual backup.
All the required parameters must to be set in a configuration file, specified by the – z
configuration_file_path option or through the NMDA configuration wizard.
The NetWorker Module for Databases and Applications Administration Guide pro-
vides more details.
OPTIONS – z configuration_file_path
Specifies the full pathname of the NMDA configuration file. Optional parame-
ter used for scheduled backups configured without the NMDA configuration
wizard, and manual backups of Lotus Domino/Notes and Sybase systems.
save_options
Specifies other command line options accepted by the nsrdasv program and
passed by the savegrp program. See savegrp(1m) for more details.
NMDA 19.1 8
Maintenance Commands nsrdb2cat ( 1m )
NAME nsrdb2cat – NMDA command for synchronizing the DB2 history for DB2 advanced
copy service backups with NetWorker indexes
DESCRIPTION The nsrdb2cat command synchronizes the DB2 history for NMDA DB2 advanced copy
service backups with the NetWorker indexes during pruning operations. The com-
mand removes snapshot backup entries from the DB2 history as NetWorker prunes
entries for expired snapshots from its index.
The nsrdb2cat command is configured by the following parameters in the NMDA DB2
resource file /nsr/apps/res/nmdb2.res:
DB2PATH
NSR_DB2CAT_MODE
enabled
Advanced copy service backups will be performed and catalog syn-
chronization will be performed.
disabled
Advanced copy service backups will be performed and catalog syn-
chronization will not be performed.
NSR_REMOVE_ON_FAILURE
TRUE
NetWorker index entries will be removed even if the synchronization
of backup records is unsuccessful.
NSR_DEBUG_LEVEL
Designates the debug level of the operations log file. The default level is 0.
NSR_DB2CAT_SKIP_HISTORY_PRUNE
NMDA 19.1 9
Maintenance Commands nsrdb2cat ( 1m )
TRUE
The DB2 history pruning operation will be skipped during a snapshot
deletion or expiration when the snapshot is enabled for catalog syn-
chronization.
FILES /nsr/apps/logs/nsrdb2cat.log
NMDA 19.1 10
Maintenance Commands nsrdb2ra ( 1m )
SYNOPSIS nsrdb2ra [ – i ] [ – u ]
DESCRIPTION The nsrdb2ra program is part of the NMDA DB2 scheduled backup configuration
wizard. The primary function of the nsrdb2ra command is to perform operations on
behalf of the wizard on the local or remote NMDA DB2 host. Those operations
include, but are not limited to, the database queries to the DB2 server.
(1) The NetWorker Management Console (NMC) during the creation or modification of
a scheduled backup configuration.
The nsrdb2ra command should not be run on the command line except for the case
described in the NMDA installation guide.
NMDA 19.1 11
Maintenance Commands nsrdb2rlog ( 1m )
SYNOPSIS nsrdb2rlog
[ – s server ] [ – c client ] [ – a database ] [ – d destination dir ] [ – C chain id ] [ – S
starting log ] [ – E ending log ] [ – N node number ] [ – F ] [ – I DB2 instance ] [ – z
configuration_file ]
DESCRIPTION nsrdb2rlog is a utility used to exercise EMC operations without the presence of a data-
base. Any computer with this utility can retrieve logs from a remote server and
recover them to a file instead of tape.
This utility allows the user to explicitly enter the log numbers they want to retrieve. It
gives the freedom to pick any existing logs available on the server. nsrinfo can be used
to find which logs reside on a server.
The above example recovers the logs numbered 10 to 53 with the chain ID 0 from the
database named sample on the server named serverA.
OPTIONS – a database
Specifies the name of the database which the logs belong to.
– C chain id
Specifies the chain ID of the logs to be used.
NMDA 19.1 12
Maintenance Commands nsrdb2rlog ( 1m )
Example: If the first log listed from nsrinfo is \C0000000_S0000004.LOG, then 4
is used as the first log value in order to retrieve all logs from 4 to the ending
log value.
– s server
Specifies the NetWorker server that backed up the database logs.
– c client
Specifies the NetWorker client on which the database logs were backed up.
–F Forces an overwrite if the recovery file already exists.
– I DB2 instance
Specifies the DB2 instance name of the backup that NMDA will use to retrieve
the logs. By default, NMDA retrieves the logs from the last backup regardless
of the instance name.
Example: If two DB2 instances use the same log name, nsrinfo might show
backups of the two logs with the same name
\C0000000_S0000100.LOG, objectinfo=DB2_1:1
\C0000000_S0000100.LOG, objectinfo=DB2_2:1
If you want to retrieve the log from the instance DB2_1, then run this com-
mand:
NMDA 19.1 13
Maintenance Commands nsrdocrc ( 1m )
NAME nsrdocrc – NMDA command for recovery of deleted Lotus Domino/Notes documents
DESCRIPTION The nsrdocrc program provides an effective method of restoring documents deleted
from a Domino/Notes database since a specified backup of the database.
The nsrdocrc program works by first recovering the specified version of the database
to a temporary directory and applying transaction logs if necessary, and then copying
the deleted documents from this database to the existing database. Once the deleted
documents are copied, the database recovered to the temporary directory is deleted.
– z configuration_file_path
Specifies the full pathname of the configuration file to use during the recovery.
The file contains parameters describing what database to restore and where.
For more information on the configuration file, refer to the NetWorker Module
for Databases and Applications Administration Guide.
NMDA 19.1 14
Maintenance Commands nsrifmxra ( 1m )
SYNOPSIS nsrifmxra [ – i ] [ – u ]
DESCRIPTION The nsrifmxra program is part of the NMDA Informix scheduled backup configuration
wizard. The primary function of the nsrifmxra command is to perform operations on
behalf of the wizard on the local or remote NMDA Informix host. Those operations
include, but are not limited to, the database queries to the Informix server.
(1) The NetWorker Management Console (NMC) during the creation or modification of
a scheduled backup configuration.
The nsrifmxra command should not be run on the command line except for the case
described in the NMDA installation guide.
NMDA 19.1 15
Maintenance Commands nsriqrc ( 1m )
DESCRIPTION The nsriqrc command restores the SAP IQ database backups from the NetWorker
server. The nsriqrc command should be run by the same operating system user that
launched the SAP IQ server. This user owns the backups, and should restore them.
Other users might be unable to see the save sets that the SAP IQ server created.
Use the nsriqrc -z configuration_file_path command after setting the required parameters
in the NMDA configuration file that is used for the SAP IQ restore.
You must set all the required parameters for the restore in the configuration file as
described in the NMDA Administration Guide.
OPTIONS – z configuration_file_path
Specifies the complete pathname of the configuration file that is used for the
SAP IQ restore.
NMDA 19.1 16
Maintenance Commands nsrlotusra ( 1m )
SYNOPSIS nsrlotusra [ – i ] [ – u ]
DESCRIPTION The nsrlotusra program is part of the NMDA Lotus Domino/Notes scheduled backup
configuration wizard. The primary function of the nsrlotusra command is to perform
operations on behalf of the wizard on the local or remote NMDA Domino/Notes host.
Those operations include, but are not limited to, the database queries to the
Domino/Notes server.
(1) The NetWorker Management Console (NMC) during the creation or modification of
a scheduled backup configuration.
The nsrlotusra command should not be run on the command line except for the case
described in the NMDA installation guide.
NMDA 19.1 17
Maintenance Commands nsrlotus_remrecov ( 1m )
SYNOPSIS nsrlotus_remrecov(.bat)
DESCRIPTION The nsrlotus_remrecov(.bat) script enables NMDA to perform a directed recovery from
the NetWorker User for Lotus program.
When the administrative client is different than the destination client, edit the
nsrlotus_remrecov(.bat) script on the destination client.
The NetWorker Module for Databases and Applications Administration Guide pro-
vides more details on use of the nsrlotus_remrecov(.bat) script.
NMDA 19.1 18
Maintenance Commands nsrmysqlra ( 1m )
SYNOPSIS nsrmysqlra [ – i ] [ – u ]
DESCRIPTION The nsrmysqlra program is part of the NMDA MySQL scheduled backup
configuration wizard. The primary function of the nsrmysqlra command is to perform
operations on behalf of the wizard on the local or remote NMDA MySQL host. Those
operations include, but are not limited to, database queries to the MySQL server.
(1) The NetWorker Management Console (NMC) during the creation or modification of
a scheduled backup configuration.
The nsrmysqlra command should not be run on the command line except for the case
described in the NMDA installation guide.
NMDA 19.1 19
Maintenance Commands nsrmysqlrc ( 1m )
DESCRIPTION The nsrmysqlrc program is used to restore MySQL data that was backed up to a Net-
Worker server with the nsrdasv program. The information contained in the NetWorker
client and media indexes is used for restoring data from the NetWorker backups.
The NetWorker Module for Databases and Applications recovery command for
MySQL databases allows a user to perform current-time recovery, point-in-time
recovery, binary logs restore, and a few other operations. For details on all the sup-
ported operations, refer to the NetWorker Module for Databases and Applications
Administration Guide.
All the required parameters must be set in a configuration file, specified by the – z
configuration_file_path option.
OPTIONS – z configuration_file_path
Specifies the full pathname of the configuration file to use during the recovery.
The file contains parameters describing what to recover and how. For more
information on the configuration file, refer to the NetWorker Module for Data-
bases and Applications Administration Guide.
NMDA 19.1 20
Maintenance Commands nsrnotesrc ( 1m )
DESCRIPTION The nsrnotesrc program is used to restore Lotus data (including data stored in a DB2
database) that was backed up to a NetWorker server with the nsrdasv program. The
information contained in the NetWorker client and media indexes is used for restoring
data from the NetWorker backups.
The NetWorker Module for Databases and Applications recovery command for Notes
databases allows a user to identify the scope of restore and restore to different clients
and directories when needed. For details on regular recovery and disaster recovery,
refer to the NetWorker Module for Databases and Applications Administration Guide.
– z configuration_file_path
Specifies the full pathname of the configuration file to use during the recovery.
The file contains parameters describing what to recover and how. It can be
used for regular recovery and disaster recovery. For more information on the
configuration file, refer to the NetWorker Module for Databases and Applica-
tions Administration Guide.
NMDA 19.1 21
Maintenance Commands nsroappbackup ( 1m )
DESCRIPTION The nsroappbackup executable program is used to invoke scheduled backups and
manual backups for Orchestrated Application Protection. The nsroappbackup com-
mand must be specified in the Backup Command field of the corresponding Net-
Worker Client resource or run through the command line.
All the required parameters must to be set in a configuration file, specified by the – z
configuration_file_path option in the nsroappbackup command.
The NetWorker Module for Databases and Applications Administration Guide pro-
vides more details.
OPTIONS – l backup_level
Specifies the backup level for the backup. The supported levels are: full, incr ,
and txnlog. If not specified, the full backup will be performed.
– o application_specific_options
The application specific options are used to work with the options that are
required by the protected application.
PostgreSQL:
The PostgreSQL WAL segment file archiving requires the following two
options:
pg_f_opt=“%f”
pg_p_opt=“%p”
For example:
– o pg_f_opt=“%f” – o pg_p_opt=“%p”
– z configuration_file_path
Specifies the pathname of the NMDA configuration file that is used for Orches-
trated Application Protection. Mandatory command option that is used for
both scheduled backups, configured with the corresponding NetWorker Client
resource, and manual backups.
NMDA 19.1 22
Maintenance Commands nsroapprecover ( 1m )
DESCRIPTION The nsroapprecover executable program is used to invoke recovery for Orchestrated
Application Protection. The nsroapprecover command must be run through the com-
mand line. The nsroapprecover command receives the data from the NetWorker server
and stores the data in the specified local directory. Additional steps are required to
complete the data recovery, as described in the database or application vendor docu-
mentation.
All the required parameters must to be set in a configuration file, specified by the – z
configuration_file_path option in the nsroapprecover command.
The NetWorker Module for Databases and Applications Administration Guide pro-
vides more details.
OPTIONS –l Specifies to list only the file names in the save set.
– o application_specific_options
The application specific options are used to work with the options that are
required by the protected application.
PostgreSQL:
The PostgreSQL archived WAL segment file recovery requires the following
two options:
pg_f_opt=“%f”
pg_p_opt=“%p”
For example:
– o pg_f_opt=“%f” – o pg_p_opt=“%p”
– z configuration_file_path
Specifies the full pathname of the NMDA configuration file that is used for
Orchestrated Application Protection. Mandatory command option that is used
for recovery.
NMDA 19.1 23
Maintenance Commands nsroraadmin ( 1m )
DESCRIPTION nsroraadmin creates, updates and deletes resources from the resource file.
The nsroraadmin creates and updates the resource file which is located at
/nsr/res/nwora.res on the host where NMDA is installed. An resource file is automati-
cally created during the NMDA installation process when NMDA is not installed to
the default location. The resource file created during installation only contains the
resources required for a regular (nonproxy) NMDA backup. The NMDA resource file
must be updated or created before performing proxy copy backups.
When nsroraadmin accesses the resource file for the first time, the resources required
for proxy copy backups are automatically added to the resource file. The added
resources are initialized with default values. If the file does not exist it is created and
the resources are initialized with default values.
There are two types of resources. The first type is the parameter resource. A parame-
ter resource is a single line that follows the NAME=VALUE format, where NAME is
the name of the parameter, and VALUE is what the parameter is set to.
The second type of resource is the SID resource. An SID resource contains all the
information nsroraclecat(1m) requires to synchronize an RMAN repository. An SID
resource contains several parameters which are described in the nsroraclecat(1m) man
page. Each parameter is represented by a keyword on the nsroraadmin command
line:
sid: NSR_ORACLE_SID
home: NSR_ORACLE_HOME
NMDA 19.1 24
Maintenance Commands nsroraadmin ( 1m )
connect: NSR_ORACLE_CONNECT_FILE
tns: NSR_ORACLE_TNS_ADMIN
lib: NSR_ORACLE_LIB_PATH
EXAMPLES The following lists the entire contents of the resource file:
nsroraadmin -r list
The following lists the SID parameter resource for the ORACLE_SID ’orcl815’:
NMDA 19.1 25
Maintenance Commands nsroraadmin ( 1m )
The following adds the parameter resource NSR_ORACLECAT_MODE:
NMDA 19.1 26
Maintenance Commands nsroraclecat ( 1m )
NAME nsroraclecat – NMDA command for synchronizing the Oracle RMAN repository with
NetWorker indexes
SYNOPSIS nsroraclecat
DESCRIPTION NMDA Oracle proxy copy backups are periodically pruned from the NetWorker
indexes when the snapshots they are stored on expire. The nsroraclecat binary keeps
RMAN repositories and the NetWorker indexes synchronized during the pruning
operations by removing the backup piece entries of the snapshot backup from the
RMAN repository. nsroraclecat is started automatically by nsrsnapck(1m) during
pruning. The RMAN repository entries are removed by forking an RMAN session.
The nsroraclecat binary should never be run manually.
The configuration of nsroraclecat is stored in the NMDA Oracle resource file which is
administered by nsroraadmin(1m). The following resources specify the nsroraclecat
configuration:
NSR_ORACLEAT_MODE
The default setting of NSR_ORACLECAT_MODE is ’undetermined’. When
NSR_ORACLECAT_MODE is set to ’undetermined’ NMDA will not perform
proxy copy backups. To use proxy copy backups the NMDA administrator
must set NSR_ORACLECAT_MODE to ’enabled’ or ’disabled’. If
NSR_ORACLECAT_MODE is set to ’disabled’ catalog synchronization will not
be performed.
NSR_REMOVE_ON_FAILURE
When NSR_REMOVE_ON_FAILURE is set to ’FALSE’ nsrsnapck(1m) will not
remove the NetWorker index entries for backup pieces that were not success-
fully synchronized.
NSR_ORACLECAT_LOG_FILE
Designates the location of the nsroraclecat operations log file. All operational
messages are written to this file. If NSR_ORACLECAT_LOG_FILE is not set
the operations messages go to the default log file
/nsr/applogs/nsroraclecat.log.
NSR_ORACLECAT_DEBUG_FILE
Designates the location of the nsroraclecat debug log file. All debugging mes-
sages are written to this file. If NSR_ORACLECAT_DEBUG_FILE is not set no
debug logging is done.
An SID resource must be configured for each Oracle database that has an RMAN repo-
sitory that will be synchronized. An SID resource has the following parameters:
NSR_ORACLE_CONNECT_FILE
Specifies the location of the file that contains the connection strings for the
RMAN repository.
NSR_ORACLE_HOME
The ORACLE_HOME of the Oracle Server installation. It is used to locate the
copy of RMAN that is used to prune the RMAN repository entries.
NMDA 19.1 27
Maintenance Commands nsroraclecat ( 1m )
NSR_ORACLE_LIB_PATH
Some Oracle Server installations require the system shared library path to be
set when using NMDA. The name of the environment variable used to set the
shared library path varies from system to system (It is LD_LIBRARY_PATH on
Solaris and HP-UX 64-bit, SHLIB_PATH on HP-UX 32 bit, LIBPATH on AIX,
etc). NSR_ORACLE_LIB_PATH must be set to the value of the shared library
path environment variable. If Oracle Server installation does not require the
shared library path NSR_ORACLE_LIB_PATH does not have to be set.
NSR_ORACLE_SID
The ORACLE_SID of the Oracle database instance that performed the proxy
copy backup. NMDA caches the ORACLE_SID in the NetWorker online
indexes when NMDA Oracle proxy copy backups are performed. The cached
copy of the ORACLE_SID is then used by nsroraclecat as a key to locate the
required SID resource during catalog synchronizations.
NSR_ORACLE_TNS_ADMIN
The location of the Oracle Net configuration files required by the Oracle Sever
installation whose RMAN will perform the catalog synchronization. If the
Oracle Net configuration files are in the default location
NSR_ORACLE_TNS_ADMIN does not have to be set.
NMDA 19.1 28
Maintenance Commands nsroradrpostcmd ( 1m )
SYNOPSIS nsroradrpostcmd(.bat)
DESCRIPTION The nsroradrpostcmd(.bat) script can be customized to back up specific files at the end
of a scheduled Oracle backup, in preparation for disaster recovery.
NMDA 19.1 29
Maintenance Commands nsrorainfo ( 1m )
DESCRIPTION The nsrorainfo command with the volume_query_options option lists the NetWorker
volumes required to restore the backup pieces specified on the command line or in a
file. The volumes listed are the ones the NetWorker server intends to use at the time
the nsrorainfo command is run. If volumes are removed from NetWorker devices or if
volumes are deleted after the nsrorainfo command was run, the NetWorker server
might use different volumes for the restore than the volume specified with the
nsrorainfo command. The nsrorainfo command will list clones of volumes if the origi-
nal volumes are not available.
The nsrorainfo command with the disk_backup_query_options option provides informa-
tion about a backup of Oracle disk backups. This information includes a list of
datafiles, archived redo logs and other files included in the backup. Regularly run the
nsrorainfo command with the disk_backup_query_options option and send the output to
the DBA who performed the original Oracle disk backups, to determine if there are
any missing files from the Oracle disk backups.
OPTIONS – s server
Specifies the NetWorker server to query.
– c client
Specifies the NetWorker client that contains the backups.
– f file Specifies a file that contains a list of backup pieces to query.
–L Specifies to prints the details of database, archived redo log and other files
included in the given backup of Oracle disk backups.
– D database_name
Specifies the name of the database to query.
– t time Specifies the "before" time (in nsr_getdate(3) format). If you use this option,
NMDA retrieves information about the most recent backup of Oracle disk
backups, with a savetime earlier than or the same as the given time value. If
you do not provide this option, NMDA retrieves information about the latest
backup of Oracle disk backups.
EXAMPLES The following command displays information about the latest backup of Oracle disk
backups from the client mars for the database orcl1101 on the NetWorker server
jupiter:
nsrorainfo -s jupiter -c mars -L -D orcl1101
The following command displays the volumes for the backup piece bckupc_1 for the
client mars on the NetWorker server jupiter:
NMDA 19.1 30
Maintenance Commands nsrorainfo ( 1m )
nsrorainfo -s jupiter -c mars bckupc_1
The following command displays the volumes for the backup pieces bckupc_1,
bckupc_2 and bckupc_3 for the client mars on the NetWorker server jupiter:
nsrorainfo -s jupiter -c mars bckupc_1 bckupc_2 bckupc_3
The following command displays the volumes for the backup pieces listed in file
bckupc.txt for the client mars on the NetWorker server jupiter:
nsrorainfo -s jupiter -c mars -f bckupc.txt
The following command displays the volumes for the backup pieces listed in file
bckupc.txt and for the backup piece bckupc_1 for the client mars on the NetWorker
server jupiter:
nsrorainfo -s jupiter -c mars -f bckupc.txt bckupc_1
NMDA 19.1 31
Maintenance Commands nsrorara ( 1m )
SYNOPSIS nsrorara [ – i ] [ – u ]
DESCRIPTION The nsrorara program is part of the NMDA Oracle scheduled backup configuration
wizard and the NMDA Oracle recovery configuration wizard. The primary function of
the nsrorara command is to perform operations on behalf of the wizard on the local or
remote NMDA Oracle host. Those operations include, but are not limited to, the data-
base queries to the Oracle server.
(1) The NetWorker Management Console (NMC) during the creation or modification of
a scheduled backup configuration.
The nsrorara command should not be run on the command line except for the case
described in the NMDA installation guide.
NMDA 19.1 32
Maintenance Commands nsrsbtmysql ( 1m )
NAME nsrsbtmysql – NMDA program for performing any corresponding NetWorker opera-
tions of MySQL
SYNOPSIS nsrsbtmysql
DESCRIPTION The nsrsbtmysql program is used with the main NMDA MySQL library libnsrmysql.so
to perform any corresponding NetWorker operations.
NMDA 19.1 33
Maintenance Commands nsrsybcc ( 1m )
DESCRIPTION The nsrsybcc program performs consistency checking of the Sybase ASE Server data-
bases by running ASE Server dbcc consistency checks on the databases.
The databases to be checked are specified by the
SYBASE:/ASE_server_name[/database_name] value. The database_name is optional; if it is
omitted, all the databases on the ASE Server are checked except the tempdb database.
The username and password provide the information necessary to log in to the ASE
Server to be backed up. The username must have sufficient permissions to run the dbcc
command on the databases to be checked.
If no checking options are supplied, the default option is -o ckstor when the dbcc data-
base has been set up. If the dbcc database does not exist, the default option is a combi-
nation of the -o ckdbnoidx, -o ckal, and -o ckcat options.
The -o ckstor option is preferable to the other options because it provides higher con-
currency. The -o ckal option may occasionally cause errors 2540 or 2546 to occur when
no real error conditions exist. Running the ASE Server in single user mode prevents
these conditions from being incorrectly reported. The ASE Server Troubleshooting and
Error Messages Guide provides more information on interpreting these and other con-
sistency check errors.
The results of the consistency check are written to stdout. There may be a large
number of informational messages. The informational messages may be suppressed by
using the – q flag.
NMDA 19.1 34
Maintenance Commands nsrsybcc ( 1m )
system tables in the database for consistency.
– o ckstor
Performs a dbcc checkstorage check on the given databases. This performs a
faster consistency check than the other options, and has greater concurrency
capabilities than the – o ckal option.
– U username
Specifies the ASE Server user that will check the databases.
– P password
Specifies the password for the ASE Server user that will perform the con-
sistency checks.
DIAGNOSTICS
Exit Codes 0 Normal exit. The consistency check completed without errors.
1 Abnormal exit. There may be consistency errors in the checked databases.
Messages The following is a partial listing of common error messages. Refer to the Administra-
tion Guide for a more complete listing of error messages and how to resolve them.
The context allocation routine failed...
Cannot access file /sybase/config/objectid.dat
This message indicates that the $SYBASE environment variable was not set.
This environment variable needs to be set so that the nsrsybcc program can
find the Sybase localization files required at runtime. The $SYBASE environ-
ment variable should be set to the directory where Sybase was installed (where
the interfaces file is located.) This error may also appear if the Sybase Open
Client software is not installed. Sybase Open Client must be installed for the
nsrsybcc program to run.
Error from server: Msg number, Level number, State number
Error text
This message indicates that there was an error message returned from Sybase.
Refer to the Sybase Troubleshooting and Errors Guide for an explanation of
the error and its resolution.
NMDA 19.1 35
Maintenance Commands nsrsybra ( 1m )
SYNOPSIS nsrsybra [ – i ] [ – u ]
DESCRIPTION The nsrsybra program is part of the NMDA Sybase scheduled backup configuration
wizard. The primary function of the nsrsybra command is to perform operations on
behalf of the wizard on the local or remote NMDA Sybase host. Those operations
include, but are not limited to, the database queries to the Sybase server.
(1) The NetWorker Management Console (NMC) during the creation or modification of
a scheduled backup configuration.
The nsrsybra command should not be run on the command line except for the case
described in the NMDA installation guide.
NMDA 19.1 36
Maintenance Commands nsrsybrc ( 1m )
DESCRIPTION The nsrsybrc command restores Sybase ASE Server database backups from the Net-
Worker server. The progress of a restore with nsrsybrc can be monitored with the
Java-based NetWorker Management Console, or with the curses(3X)-based
nsrwatch(1m) program for other terminal types.
The databases to be restored are specified by the
SYBASE:/ASE_server_name[/database_name] value. The database_name is optional; if it is
omitted, all the databases on the Sybase ASE Server are restored except the master
database.
The nsrsybrc command should be issued from the same operating system user ID that
launched the Sybase Backup Server. This user ID owns the backups, and should be
used to restore them. Other operating system user IDs might be unable to see the save
sets that the Sybase Backup Server created.
Note: The master database must be restored before the other system and user data-
bases.
The order for restoring a complete Sybase ASE Server system is to first restore the
master database and then restore the remaining databases. To restore the master data-
base, you must restart the Sybase ASE Server in master recovery mode, with the – m
option of the startserver command. You must first issue the nsrsybrc command to
restore the master database. For example:
nsrsybrc -U sa -P password SYBASE:/ASE_server_name/master
Once this command successfully restores the master database, the Sybase ASE Server
automatically shuts itself down. You must restart the Sybase ASE Server and restore
the remaining databases with the nsrsybrc command. For example:
nsrsybrc -U sa -P password SYBASE:/ASE_server_name
This command restores the remaining system databases and the user databases.
Exercise extreme caution when restoring the master database. If you restore the mas-
ter database to a new database, remember that it has pathnames to the device files. If
you restore the master database to another Sybase ASE Server on the same machine,
the new Sybase ASE Server attempts to use the same device files as the old Sybase
ASE Server.
The username and password options provide the information required to log in to the
Sybase ASE Server to be restored. The username must have sufficient permissions to
perform database loads on the databases to be restored.
You can use the nsrsybrc -z configuration_file_path command and set the required
parameters in the NMDA configuration file, instead of specifying the corresponding
command line options with the nsrsybrc command. If you use the – z option, you
must set all the required parameters for the recovery in the configuration file as
described in the NMDA Administration Guide.
NMDA 19.1 37
Maintenance Commands nsrsybrc ( 1m )
OPTIONS –C Specifies to use only full and incremental backups during the database
recovery, and to ignore cumulative backups.
–h Specifies to display the command usage information.
–k Specifies to perform a database consistency check on each database once it is
restored. The results of the database consistency check are written to stdout.
By default, a database consistency check is not performed. If the -k option is
supplied, then the consistency check is performed with the default options
described in the man page for nsrsybcc(1m).
–p Specifies that the database should not be brought online after the recovery is
completed.
–q Specifies the quiet mode, in which the nsrsybrc command displays only sum-
mary information and error messages.
–v Specifies the verbose mode, in which the nsrsybrc command reports in great
detail what it is doing as it proceeds.
–x Specifies to restore only the backup performed at the exact save time specified
by – t option. This option is ignored if – t option does not contain a valid
point-in-time.
–? Specifies to display the command usage information.
– U username
Specifies the name of the Sybase ASE Server user that performs the backups.
– P password
Specifies the password for the Sybase ASE Server user that performs the back-
ups.
– c client_name
Specifies the client name for starting the restore session. This option is useful
on clients with multiple network interfaces and multiple hostnames, when
multiple index databases are used for the same physical client.
Note: This option does not specify the network interface to use. The network
interface is specified in the server network interface attribute of the Net-
Worker Client resource (see nsr_client(5)).
– d SYBASE:/ASE_server_name[/database_name]
Specifies a new destination for the database. If this option is not used, the
database is restored to its original Sybase ASE Server and database name. If
this option is used, the database is restored to the new destination. This
option can be used to restore a database to a new Sybase ASE Server and data-
base name, or to a new database name in the same Sybase ASE Server. If a
new destination is supplied, only one database_name or ASE_server_name
value can be specified on the command line for the restore. The destination
databases must already exist; the nsrsybrc command does not create the data-
bases automatically. To enable the fastest loading, create new databases for
the restore by using the for load option.
– e AES_pass_phrase
Specifies an additional pass phrase to use for recovery of files that were backed
up with AES encryption. By default, the recovery attempts to use the current
datazone encryption key and the key generated from the default pass phrase.
The – e option causes the nsrsybrc command to generate an encryption key
from the supplied pass phrase and use it if the default and datazone pass
phrase keys do not work. The – e option can be specified multiple times.
– l {load_sql create_sql}
NMDA 19.1 38
Maintenance Commands nsrsybrc ( 1m )
Specifies the listonly option for displaying the structure information from the
backup, without loading the databases. The Sybase documentation provides
more details about listonly options.
– L directory_pathname
Specifies a shorter alternative temporary full pathname to use in the device
name if the device name exceeds the Sybase maximum, for example, 127 bytes.
– m {up_to_min up_to_min_noskip logtail_bk}
Specifies to perform operations for up-to-the-minute recovery of the database.
The keyword used with the – m option specifies the type of operations to per-
form:
up_to_min
The transaction log is backed up and the database is recovered, in that
order. The database recovery is not performed if the transaction log
backup fails.
up_to_min_noskip
The transaction log is backed up and the database is recovered, in that
order. The database recovery is performed even if the transaction log
backup fails.
logtail_bk
Only the transaction log is backed up.
– r backup_password
Specifies the unencrypted password that was used in the password-protected
backup to be restored.
– s server_name
Specifies the hostname of the machine to use as the NetWorker server.
– t date Specifies the date and time to restore to. By default, the data is restored to the
current date and time. Specifies the time to use as the "until_time" that the
database is restored to. If – x option is used, only the backup which was per-
formed at the exact point-in-time will be recovered.
– V {header full verifyonly}
Specifies the restore verification level. If no value is specified, then no
verification is carried out. The Sybase documentation provides more details
about the verification options.
– w recover_pool
Specifies the pool from which the recovery volume will be selected. This
parameter is optional. If a pool is not specified, then the NetWorker server
will select the pool used to recover the data.
– z configuration_file_path
Specifies the complete pathname of the configuration file to use for Sybase
restores with nsrsybrc.
NMDA 19.1 39
Maintenance Commands threshold.sql ( 1m )
SYNOPSIS threshold.sql
DESCRIPTION NMDA supports the Sybase threshold procedure through the threshold.sql file.
When the threshold is reached, the threshold procedure either backs up the transaction
log or performs a full database backup and truncates the transaction log.
The NetWorker Module for Databases and Applications Administration Guide pro-
vides more details on use of the threshold.sql file.
NMDA 19.1 40