Date: 2018-05-16

OS: Windows

Etrack Incidents: 3947470

Errors/Problems Fixed:

3947470- (JIRA ID: CFT-1153) DI is interfering with NBU NDMP Backups on HNAS
 
Applies to: Data Insight Collector node.

Install/Uninstall Instructions:

Apply this hotfix to Data Insight Collector node only.

This hotfix can be applied to Data Insight version 6.1.1 only.

FILE AFFECTED BY THIS PATCH:

Windows:
INSTALL_ROOT\tomcat\webapps\ROOT\WEB-INF\classes\com\symc\matrix\commd\scheduler\HNasAuditUtil$AuditOperationBean.class
INSTALL_ROOT\tomcat\webapps\ROOT\WEB-INF\classes\com\symc\matrix\commd\scheduler\HNasAuditUtil$HnasAuditTask.class
INSTALL_ROOT\tomcat\webapps\ROOT\WEB-INF\classes\com\symc\matrix\commd\scheduler\HNasAuditUtil.class
INSTALL_ROOT\tomcat\webapps\ROOT\WEB-INF\classes\com\symc\matrix\commd\scheduler\HNasEnableAuditJob$1.class
INSTALL_ROOT\tomcat\webapps\ROOT\WEB-INF\classes\com\symc\matrix\commd\scheduler\HNasEnableAuditJob$2.class
INSTALL_ROOT\tomcat\webapps\ROOT\WEB-INF\classes\com\symc\matrix\commd\scheduler\HNasEnableAuditJob.class
INSTALL_ROOT\tomcat\webapps\ROOT\WEB-INF\classes\com\symc\matrix\util\MatrixProperties.class

By default, value of INSTALL_ROOT on Windows is "C:\Program Files\DataInsight".

Steps:

Log into Data Insight Collector node and perform the following steps:
	
	1. Stop Data Insight services:
    	From the command prompt, issue the following command:
		
	net stop DataInsightComm
	net stop DataInsightConfig
	
	2.  Unzip the patch files to a temporary folder. In this folder, locate the
	"patches" folder. This folder contains all files for help application.
	
	Example: If you unzip hotfix to C:\temp, it will create the following folder
	under C:\temp:
	C:\TEMP\
	+---README
	+---patches
		+---HNasAuditUtil$AuditOperationBean.class
		+---HNasAuditUtil$HnasAuditTask.class
		+---HNasAuditUtil.class
		+---HNasEnableAuditJob$1.class
		+---HNasEnableAuditJob$2.class
		+---HNasEnableAuditJob.class
		+---MatrixProperties.class
      
	3.  Copy the patch files to the install directory.
	For example, if you are patching Collector installed at 
	"C:\Program Files\DataInsight", copy all the files except MatrixProperties.class file under 
	"C:\temp\patches" to "C:\Program Files\DataInsight\tomcat\webapps\ROOT\WEB-INF\classes\com\symc\matrix\commd\scheduler" and copy MatrixProperties.class file under "C:\temp\patches" 		to "C:\Program Files\DataInsight\tomcat\webapps\ROOT\WEB-INF\classes\com\symc\matrix\util"replacing the original files with those from the patch.
	
	4. Start Data Insight services:
	From the command prompt, issue the following command:
	
	net start DataInsightComm
	net start DataInsightConfig

	
Additional Notes:
1. New pause window has been introduced in order to run the HNASEnableAuditJob only during specified times avoiding impacts on backups.
2. This pause window can be set by using "Set Custom Properties" under Advanced Settings options of the collector node.
3. Set the below property at collector node.
      Property name    hnas.audit.pause.schedule 
      Property value   11 07 18 09 1, 2, 3, 4, 5, 6, 7
    where 11 07 18 09 denotes that the job will be in paused state from 11:07am to 6:09 pm and 1 to 7 denotes the day where 1 stands for sunday 2 for Monday and so on.
4. Let say if want the pause schedule for Friday and Saturday from 2am to 6pm then the property value will be 02 00 18 00 6, 7 
5. Property can be set by using the command line 
     To set the property use -  configdb.exe -o -T node -k xxx -J hnas.audit.pause.schedule -j "11 07 11 09 1, 2, 3, 4, 5, 6, 7"
          where xxx denotes the node id of the collector
     To view the property use - configdb.exe -p -T objattr | findstr "hnas.audit.pause.schedule"
6. This property is applicable at node level. 
7. If a filer has 4 shares and the HNASEnableAuditJob starts at 01:50am doing the SACL enabling process for the first share(Share1) and the pause window is set from 2am to 6pm. Then the share1 will be unaffected by this pause window. But the SACL enbling process on the remaining shares will be paused and will get resume at 6pm.
8. We have audit_monitor.db present in DATA_DIR\collector\hnas_audit that keeps the status of SACL operation for all the shares.So once enable SACL is complete for some share then that share wont be taken into computation again.
 9. Now audit_monitor.db will get updated as soon as operation on one share is completed instead of waiting on all shares to complete.