NetWorker: How To Enable AUTHC DEBUG for Troubleshooting Purposes

Summary: This KB provides an overview on how to enable debugging for NetWorker's authentication service (authc). It is not recommended to enable debugging as an initial troubleshooting step. This process is recommended when default logging does not sufficiently detail an issue encountered in authc. ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

There are two files that must be modified on the NetWorker (AUTHC) server.

(1) 

Linux: /nsr/authc/webapps/auth-server/WEB-INF/classes/log4j.properties
Windows: ..\Program Files\EMC NetWorker\nsr\authc-server\tomcat\webapps\auth-server\WEB-INF\classes\log4j.properties

(2)
Linux: /opt/nsr/authc-server/conf/authc-cli-log4j.properties
Windows: ..\Program Files\EMC NetWorker\nsr\authc-server\conf\authc-cli-log4j.properties
 
NOTE: Before changing these files, create a copy of each file.

(1) log4j.properties:

In the log4j.properties you should see:

appender.app.policies.size.size=2000KB
appender.audit.policies.size.size=2000KB
logger.audit.level = error
rootLogger.level = warn

Change to:

appender.app.policies.size.size=100MB
appender.audit.policies.size.size=100MB
logger.audit.level = debug
rootLogger.level= debug

 

(2) authc-cli-log4j.properties:

In the authc-cli-log4j.properties file you should see:

appender.syslog.policies.size.size=100KB
rootLogger.level = error
Change to: 
appender.syslog.policies.size.size=100MB
rootLogger.level= debug

 

Restart Services:

The NetWorker server services must be restarted in order for the debug changes to take affect.

Linux:

nsr_shutdown 
systemctl start networker 

Windows:

net stop nsrd
net start nsrd

 

Monitor the NetWorker server daemon.raw for messages regarding NetWorker server service (nsrd) startup:

Linux: /nsr/logs/daemon.raw
Windows: ..\Program Files\EMC NetWorker\nsr\logs\daemon.raw

NetWorker: How to use nsr_render_log to render .raw log files

 

Messages tagged with DEBUG should be seen in the authc-server-audit.log and authc-server.log. 

Linux: /nsr/authc/logs/
Windows: ..\Program Files\EMC NetWorker\nsr\authc-server\tomcat\logs\

Disabling Debug:

Replace the log4j.properties and authc-cli-log4j.properties to the original copies created before debug settings were applied. If copies were not created, set the default parameters outlined above. A NetWorker server service restart is required to reload the authentication service without debugging applied.

Additional Information

Affected Products

NetWorker

Products

NetWorker Family, NetWorker Series
Article Properties
Article Number: 000196412
Article Type: How To
Last Modified: 09 Jul 2025
Version:  9
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.