AuditWizard - Analysis Tools - Run a Trace

From Layton Support
(Difference between revisions)
Jump to: navigation, search
m (Modified procedure)
m (Clarified the command)
 
(19 intermediate revisions by one user not shown)
Line 1: Line 1:
 
<p align="right">[[File:btn_back_up.png|link=User Guide for AuditWizard]] [[User Guide for AuditWizard|<u>Back to Contents</u>]]</p>
 
<p align="right">[[File:btn_back_up.png|link=User Guide for AuditWizard]] [[User Guide for AuditWizard|<u>Back to Contents</u>]]</p>
This procedure will run the Scanner in logging mode, producing a log file useful for debugging why individual computers do not produce a usable .ADF audit file.
+
This procedure will run the Scanner in logging mode, producing a log file useful for debugging why individual computers do not produce a usable .ADF audit file. It might also be used to test a specific Scanner version.
  
<ol>
+
Note that sometimes, with a beta version, AuditScanner.exe will not exit. A log will be produced, whether or not this occurs.
  <li>In Administration > Auditing > Upload Options, check ''Globally turn off auto-upload''.</li>
+
  <li>In Administration > Auditing > Scanner Configuration, change ''Re-audit Interval'' to 0 days.</li>
+
  <li>Click the ''Save Configuration'' button and the ''Deploy to Network'' button.</li>
+
  <li>Log into the test computer as a domain admin.</li>
+
  <li>Go to Start > Settings > Control Panel > Folder Options. Click the View tab. Change the following settings:</li>
+
    <ol>
+
      <li>Files and Folders > Hidden files and folders: ''Show hidden files and folders''</li>
+
      <li>Files and Folders > Hide extensions for known file types: ''uncheck''</li>
+
      <li>Click the Apply button, then OK.</li>
+
    </ol>
+
  <li>Go to Start > Run. Enter<br><br>
+
'''\\SERVERNAME\AUDITWIZARDNETSHARE\scanner\AuditScanner.exe T'''<br><br>
+
and press the Enter key. This will initiate a scan and will create a log file.</li>
+
  <li>Navigate to C:\Users\YOURUSERNAME\AppData\Local\Temp\. Look for AuditScanner.LOG. Move this to \\SERVERNAME\AUDITWIZARDNETSHARE\data\ for easy collection.</li>
+
  <li>Navigate to \\SERVERNAME\AUDITWIZARDNETSHARE\data\.</li>
+
  <li>Collect the following set of files:</li>
+
    <ol>
+
      <li>NAME.adf</li>
+
      <li>Log from step 7.</li>
+
    </ol>
+
  <li>In Administration > Auditing > Upload Options, uncheck ''Globally turn off auto-upload''.</li>
+
</ol>
+
  
Zip the files and send to [mailto:[email protected] Support] for analysis.
+
=Procedure=
 +
==Server Preparation==
 +
#In '''[[AuditWizard - Using AuditWizard - Administration - Auditing - Upload Options#Auto-Upload|Administration > Auditing > Upload Options]]''', check ''Globally turn off auto-upload''.
 +
#In '''[[AuditWizard - Using AuditWizard - Administration - Auditing - AuditScanner Configuration#Re-audit Interval|Administration > Auditing > AuditScanner Configuration]]''', change ''Re-audit Interval'' to 0 days.
 +
#Check that all the desired '''[[AuditWizard - Using AuditWizard - Administration - Auditing - AuditScanner Configuration#Audited Items|Audited Items options]]''' are enabled.
 +
#Click the ''Save Configuration'' button and the ''Deploy to Network'' button.
 +
#Conditional: If testing a different version of the Scanner than is currently in use:
 +
##Go to ''\\SERVERNAME\SHARE\scanner\''.
 +
##Create a new folder called ''Current''.
 +
##Move the existing ''AuditScanner.exe'' file into ''\\SERVERNAME\SHARE\scanner\Current\''.
 +
##Copy the testing ''AuditScanner.exe'' version into ''\\SERVERNAME\SHARE\scanner\''.
 +
 
 +
==Client Preparation==
 +
#Log into the test computer as a domain admin.
 +
#Go to ''Start > Control Panel > Folder Options''. Click the ''View'' tab. Change the following settings:
 +
##''Files and Folders > Hidden files and folders'': ''Show hidden files and folders''
 +
##''Files and Folders > Hide extensions for known file types'': ''uncheck''
 +
##Click the ''OK'' button.
 +
#::[[File:Aw trace01.png|link=]]
 +
#Open Task Manager so that you can monitor when the Scanner stops running, or end the task if it does not.
 +
 
 +
==Run Trace==
 +
#Go to ''Start > Run''. Enter, substituting ''SERVERNAME'' with your server name and ''AUDITWIZARDNETSHARE'' with your share name:
 +
#:<pre>
 +
#::\\SERVERNAME\AUDITWIZARDNETSHARE\scanner\AuditScanner.exe T</pre>
 +
#:and press the ''Enter'' key.
 +
#A dialog will appear:
 +
#:[[File:Aw trace02.png|link=]]
 +
#:Click ''OK'' to start.
 +
#When ''AuditScanner.exe'' disappears from Task Manager, it has completed and ended. If it doesn't exit after 10 minutes, right-click ''AuditScanner.exe'' and select ''End Task''.
 +
 
 +
==File Collation==
 +
#Navigate to ''C:\Users\YOURUSERNAME\AppData\Local\Temp\''. Move ''AuditScanner.LOG'' to ''\\SERVERNAME\AUDITWIZARDNETSHARE\data\'' for easy collection.
 +
#Navigate to ''\\SERVERNAME\AUDITWIZARDNETSHARE\data\''.
 +
#Collect the following set of files:
 +
##ASSETNAME.ADF (if created)
 +
##AuditScanner.LOG from ''Run Trace'', step 2.
 +
 
 +
==Reset Server Configuration==
 +
#In ''Administration > Auditing > Upload Options'', uncheck ''Globally turn off auto-upload''.
 +
#Conditional: If testing a different version of the Scanner than is currently in use:
 +
##Go to ''\\SERVERNAME\SHARE\scanner\''.
 +
##Create a new folder called ''Testing''.
 +
##Move the existing ''AuditScanner.exe'' file into ''\\SERVERNAME\SHARE\scanner\Testing\''.
 +
##Move the ''AuditScanner.exe'' file from ''\\SERVERNAME\SHARE\scanner\Current\'' into ''\\SERVERNAME\SHARE\scanner\''.
 +
 
 +
=Sending Files to Support=
 +
Zip the files and send to '''[mailto:[email protected] Support]''' for analysis. In rare instances where the log files are over 2Mb once zipped, please send the .zip file to Support via our '''[http://laytontech.leapfile.net upload service]'''.
 
<p align="right">[[File:btn_back_up.png|link=User Guide for AuditWizard]] [[User Guide for AuditWizard|<u>Back to Contents</u>]]</p>
 
<p align="right">[[File:btn_back_up.png|link=User Guide for AuditWizard]] [[User Guide for AuditWizard|<u>Back to Contents</u>]]</p>

Latest revision as of 04:13, 15 June 2022

Btn back up.png Back to Contents

This procedure will run the Scanner in logging mode, producing a log file useful for debugging why individual computers do not produce a usable .ADF audit file. It might also be used to test a specific Scanner version.

Note that sometimes, with a beta version, AuditScanner.exe will not exit. A log will be produced, whether or not this occurs.

Contents

[edit] Procedure

[edit] Server Preparation

  1. In Administration > Auditing > Upload Options, check Globally turn off auto-upload.
  2. In Administration > Auditing > AuditScanner Configuration, change Re-audit Interval to 0 days.
  3. Check that all the desired Audited Items options are enabled.
  4. Click the Save Configuration button and the Deploy to Network button.
  5. Conditional: If testing a different version of the Scanner than is currently in use:
    1. Go to \\SERVERNAME\SHARE\scanner\.
    2. Create a new folder called Current.
    3. Move the existing AuditScanner.exe file into \\SERVERNAME\SHARE\scanner\Current\.
    4. Copy the testing AuditScanner.exe version into \\SERVERNAME\SHARE\scanner\.

[edit] Client Preparation

  1. Log into the test computer as a domain admin.
  2. Go to Start > Control Panel > Folder Options. Click the View tab. Change the following settings:
    1. Files and Folders > Hidden files and folders: Show hidden files and folders
    2. Files and Folders > Hide extensions for known file types: uncheck
    3. Click the OK button.
    Aw trace01.png
  3. Open Task Manager so that you can monitor when the Scanner stops running, or end the task if it does not.

[edit] Run Trace

  1. Go to Start > Run. Enter, substituting SERVERNAME with your server name and AUDITWIZARDNETSHARE with your share name:
    \\SERVERNAME\AUDITWIZARDNETSHARE\scanner\AuditScanner.exe T
    and press the Enter key.
  2. A dialog will appear:
    Aw trace02.png
    Click OK to start.
  3. When AuditScanner.exe disappears from Task Manager, it has completed and ended. If it doesn't exit after 10 minutes, right-click AuditScanner.exe and select End Task.

[edit] File Collation

  1. Navigate to C:\Users\YOURUSERNAME\AppData\Local\Temp\. Move AuditScanner.LOG to \\SERVERNAME\AUDITWIZARDNETSHARE\data\ for easy collection.
  2. Navigate to \\SERVERNAME\AUDITWIZARDNETSHARE\data\.
  3. Collect the following set of files:
    1. ASSETNAME.ADF (if created)
    2. AuditScanner.LOG from Run Trace, step 2.

[edit] Reset Server Configuration

  1. In Administration > Auditing > Upload Options, uncheck Globally turn off auto-upload.
  2. Conditional: If testing a different version of the Scanner than is currently in use:
    1. Go to \\SERVERNAME\SHARE\scanner\.
    2. Create a new folder called Testing.
    3. Move the existing AuditScanner.exe file into \\SERVERNAME\SHARE\scanner\Testing\.
    4. Move the AuditScanner.exe file from \\SERVERNAME\SHARE\scanner\Current\ into \\SERVERNAME\SHARE\scanner\.

[edit] Sending Files to Support

Zip the files and send to Support for analysis. In rare instances where the log files are over 2Mb once zipped, please send the .zip file to Support via our upload service.

Btn back up.png Back to Contents

Personal tools
Namespaces

Variants
Actions
Main Page
Online User Guides
General Support
Release Notes
Toolbox