| 
      1
     | 
    
      # datasets_Monitoring README
 
     | 
  
  
    | 
      2
     | 
    
      #
 
     | 
  
  
    | 
      3
     | 
    
      # Alessandro Nastasi, April 2015
 
     | 
  
  
    | 
      4
     | 
    
      #
 
     | 
  
  
    | 
      5
     | 
    
      
 
     | 
  
  
    | 
      6
     | 
    
      This is a script aimed at monitoring the status of the Sitools2 datasets
 
     | 
  
  
    | 
      7
     | 
    
      and the mapping of their fields.
 
     | 
  
  
    | 
      8
     | 
    
      
 
     | 
  
  
    | 
      9
     | 
    
      Put the script in the Sitools2 folder data/datasets(/map, for the latest versions)
 
     | 
  
  
    | 
      10
     | 
    
      where the datasets information are stored as xml files. 
 
     | 
  
  
    | 
      11
     | 
    
      Then, read and record the current status/mapping, with:
 
     | 
  
  
    | 
      12
     | 
    
      
 
     | 
  
  
    | 
      13
     | 
    
      $ datasets_Monitoring --record 
 
     | 
  
  
    | 
      14
     | 
    
      
 
     | 
  
  
    | 
      15
     | 
    
      The datasets properties are locally stored in files named as:
 
     | 
  
  
    | 
      16
     | 
    
      
 
     | 
  
  
    | 
      17
     | 
    
              <dataset_name>.lastStatus.xml
 
     | 
  
  
    | 
      18
     | 
    
      
 
     | 
  
  
    | 
      19
     | 
    
      The '--record' option should be executed manually by the administrator every time 
 
     | 
  
  
    | 
      20
     | 
    
      one or more datasets are modified (it would be good to add a reminder to the 
 
     | 
  
  
    | 
      21
     | 
    
      Sitools2 pop-up message). 
 
     | 
  
  
    | 
      22
     | 
    
      
 
     | 
  
  
    | 
      23
     | 
    
      To check the datasets mapping/status, launch the script with the '--check' option:
 
     | 
  
  
    | 
      24
     | 
    
      
 
     | 
  
  
    | 
      25
     | 
    
      $ datasets_Monitoring --check 
 
     | 
  
  
    | 
      26
     | 
    
      
 
     | 
  
  
    | 
      27
     | 
    
      This performs a consistency check between the current (int@*.xml or map/string@*.xml) 
 
     | 
  
  
    | 
      28
     | 
    
      and the last recorded status (<dataset_name>.lastStatus.xml).
 
     | 
  
  
    | 
      29
     | 
    
      If any inconsistency is found, an alert e-mail is sent.
 
     | 
  
  
    | 
      30
     | 
    
      
 
     | 
  
  
    | 
      31
     | 
    
      The '--check' option should be run daily and automatically by the system.
 
     | 
  
  
    | 
      32
     | 
    
      
 
     | 
  
  
    | 
      33
     | 
    
      @author: Alessandro NASTASI for IAS 27-04-2015
 
     | 
  
  
    | 
      34
     | 
    
      
 
     |