Troubleshooting

Bundlelogs utility options

The following table lists the options available for the bundlelogs utility.

Table 45 Bundlelogs utility usage

Option Description
-h Display the bundlelogs utility help.

-d -d <number>, specify the number of days of Mongo database data

to dump (default is 1 day)

-x Exclude the Mongo database dump.

Running the bundlelogs utility

You can use the bundlelogs utility command to gather diagnostic information from
Backup & Recovery Manager server for troubleshooting.
Use the following command to run the bundlelogs utility:
$ ucas@localhost:~ $ ./bundlelogs -h -d2 -x

The following is an example of the bundlelogs utility output:

$ which bundlelogs
/opt/emc/ucas/tools/bundlelogs
ucas@idhcp247:~ $ bundlelogs
Starting log collection....
preparing temp area to gather logs from BRM....
sending signal to dump thread states....
copying UCAS logs...
copying apache logs...
copying tomcat logs...
copying mongo logs
gathering kernel info, memory, process lists, uptimes, & mounted
filesystems...
dumping mongo database...
dumping mongo from 20:57 08/29/12
connected to: 127.0.0.1
Generating Log Bundle for 08-30-12-20.57 Completed.
====================
Logfile bundle in /opt/emc/ucas/mongo-data/
bundlelogs-09-05-12-18.06.tgz
Please upload this logbundle to your EMC counterpart working this
issue.

NetWorker adaptor options

The NetWorker adaptor options are provided to adjust the performance and debugging
capabilities of the NetWorker adaptor on Windows and UNIX.

Editing adaptor options on Windows

Procedure
1. Shut down the NetWorker ActiveMQ Adaptor service.
2. Edit the configuration file:

162 EMC Backup & Recovery Manager 1.3 User Guide

 Troubleshooting

C:\Program Files (x86)\NetWorker Adaptor

Service-1.0\nsrmq.cfg

3. Save the file.

4. Restart the adaptor service.

Editing adaptor options on Linux

Procedure
1. From a command terminal, shut down the adaptor process:
/etc/init.d/nsrmqd stop -> stop

2. Edit the configuration file:

/etc/init.d/nsrmq.cfg

3. Save the file.

4. Restart the adaptor process:
/etc/init.d/nsrmqd start -> start

NetWorker adaptor command line options

The following table lists the options, their description, and use for the NetWorker adaptor
from the Linux command line only:
/etc/init.d/nsrmqd <option>.

Table 46 NetWorker adaptor options

Option Option long Default /Description Use

-n no daemon no daemon Run in the foreground Used to run the application and
on UNIX when control it from a shell (that is,
launched from a be able to kill it with a Ctrl-C)
terminal

-m -mq-host= localhost ActiveMQ or Used to tell the adapter which

RabbitMQ server machine the Backup & Recovery
name or IP address to Manager server is running
which to connect

-p --mq-port= 61610 ActiveMQ or Used when the Backup &

RabbitMQ SSL Recovery Manager server is
connection port either using non-default ports or
connecting without SSL

-s --server= localhost NetWorker server Used to run the adapter against

name or IP address to a NetWorker server on a remote
which to connect machine

-t --target= Backup & Destination queue for Used to change the queue that
Recovery JSON messages the adapter sends its messages
Manager Main to (generally not needed)
Queue

Editing adaptor options on Linux 163

Troubleshooting

Table 46 NetWorker adaptor options (continued)

Option Option long Default /Description Use

-u --uid= Run as the The userID to run as Useful when starting the
user process as root but having it run
launching the as a more restricted user
process

-g --gid= Use the The group ID to run as Useful when starting the
groups of the process as root but having it run
user in a more restrictive group
launching the
process

--chroot= Use the Chroot to a specified Used to help secure things as

current root directory before the directory is considered the
directory running root and the process does not
read or write anything above
that level

--connect- 60 Message bus Used to define how long to wait

interval= reconnect interval in between attempts to connect to
seconds the message bus/Backup &
Recovery Manager server

--events- 30 Events polling interval Used to change how often user

interval= in seconds configuration changes are sent
to the Backup & Recovery
Manager server in case either
the server has been overloaded
(set to a larger interval) or more
timely updates are desired (set
a smaller interval)

--logfile= nsrmq.log Write log messages to Used primarily for directing log
the specified file (set output to the shell when
to '-' to write to the running in the foreground
console)

--nwid= Use the name Override the ID to Used primarily as a

of the which the NetWorker development tool for simulating
NetWorker server is registered multiple NetWorker servers from
server host a single one
machine

--pidfile= nsrmq.pid Name of the pid file Required when running multiple
adapters from the same
directory so they do not
overwrite each others pid files

--prefix= nsrmq Use the specified Useful for organizations having

prefix when a company specific logging
syslogging format

--reconnect- 60 NetWorker server Defines how long to wait

interval= reconnect interval in between attempts to reconnect
seconds to the NetWorker server when
the connection is lost

164 EMC Backup & Recovery Manager 1.3 User Guide

 Troubleshooting

Table 46 NetWorker adaptor options (continued)

Option Option long Default /Description Use

--register- 3600 NetWorker server Used to change how often the
interval= registration interval in adapter sends the “baseline”
seconds registration messages including
all the group results (running or
not) and configuration
parameters

--result- 60 Group results polling Used to change how often

interval= interval in seconds results are sent for running
groups in case the querying is
overloading the NetWorker
server

--rundir= Run in the Change to the Used for alternative way to start
current specified directory multiple adapters in the same
directory before running directory but not have them
overwrite each others pid and
log files

--status- 10 Status polling interval Used to change how often the

interval= in seconds dynamic attributes are queried
from the NetWorker server and
sent as activities messages if
either the NetWorker server it
has been overloaded (set to a
larger interval) or more timely
updates are desired (set a
smaller interval)

--timeout= 600 NetWorker query Used to define how long to wait

timeout interval in for the NetWorker server to
seconds respond before considering it
unavailable and attempting to
reconnect

--umask= 077 The (octal) file The default file creation mask is
creation mask to used to only enable access to
apply (non-world the user for which the process
readable) is running (for example, root),
this option is useful for allowing
others to view the files such as
the log file. --umask=022 is
used to enable log files as world
readable

--debug Do not run in Run the reactor in the

the debugger Python debugger

--euid Use the Run as the effective Similar to uid, enables the
current user user id rather than the process to be started by root
ID real user id but with lesser privileges.
Retains the ability to regain
privileges as needed

NetWorker adaptor command line options 165

Troubleshooting

Table 46 NetWorker adaptor options (continued)

Option Option long Default /Description Use

--syslog Log to a file Log to syslog, not a Useful for organizations
file desiring a central logging
location

--no-ssl Connect using Do NOT connect to the

SSL ActiveMQ server using
SSL (requires
overriding the default
port)

--verbose Standard Run in verbose mode

logging level to provide information
on the NetWorker
adaptor

--trace Do not dump Dump stack traces to

stack traces the log when errors
occur to provide
information on the
NetWorker adaptor

--version Run as normal Print the version

information to provide
information on the
NetWorker adaptor
and exit

--help Run as normal Display the help text

and exit

Avamar adaptor control script

The following Avamar control scripts enable you to complete Avamar tasks:
l For Avamar 7.0 and earlier:

adaptorctl.pl options

l For Avamar 7.1 and later:

msgbrokerctl.pl options

The following table lists the available options for the Avamar control script:

Table 47 Avamar adaptor control script

Avamar adaptor control Description

script options
--brmhost = <addresses> For Avamar 7.0 and earlier, use only with --setup. Provide a
comma separated list of one or more addresses, optionally with
a colon and port number that is specified for each address.

166 EMC Backup & Recovery Manager 1.3 User Guide

 Troubleshooting

Table 47 Avamar adaptor control script (continued)

Avamar adaptor control Description

script options
--help Opens the help file for these options.

--jmsaddr=<addresses> For Avamar 7.1 and later, use only with --setup. Provide a
comma separated list of one or more addresses, optionally with
a colon and port number that is specified for each address.

--setup Setup ActiveMQ and the Avamar adaptor.

--start Start the Avamar adaptor.

--status Display the status of the Avamar adaptor.

--stop Stop the Avamar adaptor.

Backup & Recovery Manager error messages

For Backup & Recovery Manager activities that do not successfully complete:
l A numeric error code is listed.
l Backup & Recovery Manager errors are listed as BRM in the Type column.
l The ability to sort and hide the messages is available.
Double-click the error code to view a detailed explanation. The following table lists
the error codes and their descriptions.

Table 48 Backup & Recovery Manager error codes

Numeric error code Error code description

1 Connection to server <system name> has failed for the last <##>
minutes.

2 Connection to server <system name> has returned to normal.

3 /opt/mongo-data has <##.#>% space remaining.

4 <##> records older than <date/time> were deleted. Current DB

storage is <##.#> MB

5 User authentication to Data Domain system <system name> has

failed.

6 Connection to Data Domain system <system name> has failed.

Backup & Recovery Manager error messages 167