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. ...
Instructions
There are two files that must be modified on the NetWorker (AUTHC) server.
(1)
/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)
/opt/nsr/authc-server/conf/authc-cli-log4j.properties
Windows:
..\Program Files\EMC NetWorker\nsr\authc-server\conf\authc-cli-log4j.properties
(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
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.