NetWorker: Log Files and Locations
Summary: How to collect NetWorker logs, NetWorker support requires for problem analysis.
Instructions
NetWorker sends messages to two types of logs. Plain text log files that are saved with the .log extension and unrendered log files that are saved with the .raw extension. The .log files and the messages that appear in NMC use the locale setting of the service that generates the log message. To view the contents of .log files, use any text editor. Before you can view .raw files in a text editor, render the .raw file into the locale of the local machine. You can manually render the raw log files or configure NetWorker to render the log files at runtime.
Log Rendering And Analysis:
- NetWorker: How to use nsr_render_log
- NetWorker: How to automatically render daemon.raw to daemon.log in real time
- How to set the NetWorker log rollover or truncation time
Support Bundles and Log Collection:
Logs:
NetWorker Server Log Files:
| Component | Location on NetWorker Server | Description |
| daemon.raw |
|
The unrendered daemons (services) log file - This file contains messages about NetWorker service operations. Use the nsr_render_log program to view the contents of the log file. |
| rap.log |
|
This log details changes to the NetWorker server's resource database including which NetWorker user account made the change. |
| nsrim.raw |
|
The nsrim binary performs aging of control data and consistency check of the media database. This log details when a save set is marked as eligible for deletion as per its retention settings. Use the nsr_render_log program to view the contents of the log file. |
| Client fix |
|
Contains status information that is related to the use of the nsr_client_fix command. Use the nsr_render_log program to view the contents of the log file. |
NetWorker Server generated syslog messages and daemon.notice |
|
Contains general NetWorker error messages. |
Disaster recovery command-line wizard, nsrdr program |
|
Contains detailed information about the internal operations that are performed by the nsrdr program - NetWorker overwrites this file each time that you run the nsrdr program. |
| Index log |
|
Contains warnings about the size of the client file index and low disk space on the file system that contains the index files. By default, the Index size notification on the NetWorker Server sends information to the log file. |
| Hyper-V FLR |
|
Contains status information about the Hyper-V FLR interface. |
| Snapshot Management |
|
Contains messages that are related to snapshot management operations - For example, snapshot creation, mounting, deletion, and rollover operations. Use the nsr_render_log program to view the contents of the log file. |
| Media management |
|
By default, device notifications on the NetWorker Server send device-related messages to the media.log file on the NetWorker Server and each Storage Node. |
| Recovery Wizard |
|
Contains information that can assist you in troubleshooting recovery failures - NetWorker creates a log file on the NetWorker Server for each recover job. |
| Package Manager log |
|
Contains information that is related to the Package Manager and the nsrpush command. Use the nsr_render_log program to view the contents of the log file. |
| Security Audit Logs |
|
Contains security audit-related messages. Use the nsr_render_log program to view the contents of the log file. |
| Policy and Workflow Logs |
|
The policy/workflow logs are retained as per the jobsdb retention window (default 72 hours). Use the nsr_render_log program to view the contents of the log files. |
| REST API Logs: |
|
Logs information about all Representational State Transfer Application Programming Interface (REST API) calls performed on the NetWorker server.
NOTE: REST API debugging can be enabled, following: NetWorker: How to Enable REST API Debugging
|
RabbitMQ Logs:
RabbitMQ is the Message Bus server which handles communication between the NetWorker server and NetWorker Management Console (NMC) or NetWorker Web User Interface (NWUI)
| Component | Location |
| Crash log |
Linux: /opt/nsr/rabbitmq-server*/var/log/rabbitmq/log/crash.log |
| RabbitMQ Service Log | Linux: /opt/nsr/rabbitmq-server*/var/log/rabbitmq/rabbit@localhost.log Windows: C:\Program Files\EMC NetWorker\nsr\tmp\RabbitMQ\log\rabbit@HOSTNAME.log |
| Upgrade Logs. |
Linux: /opt/nsr/rabbitmq-server*/var/log/rabbitmq/rabbit@localhost_upgrade.log |
| Crash stack trace logs |
Linux: /nsr/tmp/rabbitmq/cores/erl_crash.dump |
Authentication Service (authc) Logs:
| Component | File name and default location | Description |
| Installation Log |
|
Contains information about the installation of the NetWorker Authentication Service. |
authc_mgmt andauthc_config |
$HOME/authc-cli.log
Where $HOME is the home folder for the logged in user. For example, when the root user runs the command, the file location is /root/authc-cli.log.
|
Contains a list of error messages that appeared when a user ran the authc_mgmt and authc_config tools. |
| Authentication server log |
|
Contains security audit messages for the NetWorker Authentication Service. Debugging is often required to enable logging in this file. |
| Audit log |
|
Contains security audit messages for the NetWorker Authentication Service. |
| Tomcat Access logger |
|
Contains access information for the embedded Apache httpd web server. |
| Apache Catalina log |
|
Contain messages for the Apache Tomcat core component. |
NetWorker Management Console (NMC) Server log files:
| Component | File name and default location | Description |
| NMC server log files |
|
Contains information that is related to NMC server operations and management. Use the nsr_render_log program to view the contents of the log file. |
| NMC server database conversion |
|
Contains the results of the NMC server database conversion that is performed during an upgrade operation. |
| NMC web server |
|
Contains messages for the embedded Apache httpd web server on the NMC server. |
| NMC server database log files |
|
Contains messages for the embedded PostgreSQL database server on the NMC server. |
NetWorker Web User Interface (NWUI) Server log files:
| Component | File name and default location | Description |
| nwui.raw |
|
Logs information about the NWUI server service. Use the nsr_render_log program to view the contents of the log file. |
| nwui.log |
|
Logs information about operations performed within the NWUI. |
| Install or Upgrade logs. |
|
Logs information about the installation or upgradation of the NWUI server. |
| monitoring-app.log |
|
Logs information about the RabbitMQ message bus communication between the NetWorker server and NWUI server. |
| rabbitMQ.log |
|
Logs information about the RabbitMQ message bus communication between the NetWorker server and NWUI server. |
NetWorker Client Log Files:
| Component | File name and default location | Description |
| NetWorker Client daemons |
|
Main NetWorker log file Use the nsr_render_log program to view the contents of the log file. |
| User log | C:\Program Files\EMC NetWorker\logs\networkr.raw | For Windows, contains a record of every file that was part of an attempted manual backup or recovery operation that is started by NetWorker User program. Subsequent manual backup or recover operations overwrite the file. Use the nsr_render_log program to view the contents of the log file. |
| Windows Bare Metal Recovery (BMR) | The following files in the X:\Program Files\EMC NetWorker\nsr\logs\ directory: ossr_director.raw |
Contains the recovery workflow of the DISASTER_RECOVERY:\ and any errors that are related to recovering the save set files or Windows ASR writer errors. Use the nsr_render_log program to view the contents of the log file. |
| ... | recover.log | Logs the output generated by the NetWorker recover.exe program and error messages that are related to critical volume data recovery. |
| ... | winPE_wizard.log | Logs workflow information that is related to the NetWorker BMR wizard user interface. |
| ... | winpe_nw_support.raw | Contains output from the winpe_nw_support.dll library. The output provides information about communications between the NetWorker BMR wizard and the NetWorker Server. Use the nsr_render_log program to view the contents of the log file. |
| ... | winpe_os_support.log | Contains output information that is related to Microsoft native API calls. |
| CloudBoost - NetWorker Client | The following log files in the /nsr/logs/cloudboost directory: MagFS.log.ERROR.date-timestamp.pid.txt MagFS.log.FATAL.date-timestamp.pid.txt MagFS.log.INFO.date-timestamp.pid.tx |
These files appear on a client direct-enabled NetWorker Client and contain information about data stored on a CloudBoost device. The severity of the message determines which log file that error message is written to. The maximum size of the log files is 100 MB. Before a client direct backup, the save process checks the size of the file. When the maximum size is reached, save starts an automatic trimming mechanism, which renames and compresses the log file. The maximum number of versions for a file is 10. When renamed log files reach the maximum version value, NetWorker removes the oldest log as a new version is created.
NOTE: The Troubleshooting manual backups section of the NetWorker Administration Guide describes how to use the CB_LOG_DIR_LOCATION environment variable to change the default log file location.
|
| CloudBoost - CloudBoost Appliance | The following log files in the /nsr/logs/cloudboost directory: MagFS.log.ERROR.date-timestamp.pid.txt MagFS.log.FATAL.date-timestamp.pid.txt MagFS.log.INFO.date-timestamp.pid.txt |
These files appear on the CloudBoost appliance and contain information about operations that are performed on a CloudBoost device. The severity of the message determines which log file that error message is written to. The maximum size of the log files is 100 MB. When the maximum size is reached, the nsrmmd process starts an automatic trimming mechanism, which renames and compresses the log file. The maximum number of versions for a file is 10. When renamed log files reach the maximum version value, NetWorker removes the oldest log as a new version is created. |
VMware/vProxy Logs:
| Log file | Default log location | Description |
| <job-uuid>.log |
|
vProxy management job log file is created during the redeployment of the associated vProxy. |
| vproxy_upgrade_sessio n__<jobuuid> |
|
Associated nsrvisd log file is created during redeployment of the vProxy. |
| nsrvisd-daemon.log |
|
Associated nsrvisd detailed log file is created. |
| ProxySessions- .log |
|
Associated ProxySessions log file is created during redeployment of the vProxy. |
nsrvisd logs |
|
Associated inventory sessions log file is created. |
| VM backup logs |
|
The VM backup session logs are retained as per the jobsdb retention window (default 72 hours).
NOTE: The VM session logs can also be found on the vProxy appliance under /opt/emc/vproxy/runtime/logs/recycle/vbackupd/DATE.
|
NetWorker VMware Protection (NVP)-vProxy: How to Enable Debug Logging.
NetWorker Virtual Edition (NVE) Specific Logs:
In addition to the standard NetWorker logs detailed above, the NVE has some additional logs regarding its deployment and upgrade processes.
The NVE's avinstaller process provides a web interface to access the NVE deployment and upgrade user interface. The avinstaller service has the following logs:
- /space/avamar/var/avi/server_log/avinstaller.log
- /space/avamar/var/avi/server_log/aviserver.log
- /space/avamar/var/avi/server_log/avitask.log.0
While the NVE is performing an upgrade or rollup, the following logs can be used to identify the progress of the upgrade or any errors:
- /data01/avamar/repo/temp/*/tmp/workflow.log
- /data01/avamar/repo/temp/*/tmp/err.log
All historic NVE upgrade logs can be found under:
- /usr/local/avamar/var/avi/server_data/package_data/PACKAGE_NAME
NveOsRollup also logs information under /tmp/sec_install_os_errata_sles.pl.log; however, this log is removed after the system reboots.