echi-converter 0.3.1 → 0.3.2

data/History.txt

@@ -104,7 +104,7 @@
 * Bug fix(es):
   * Fixed bug so that the log file properly reports when a file is processed
 
-== 0.3.1 2007-11-TBD
+== 0.3.1 2007-11-04
 
 * Major enhancement(s):
 * Minor enhancement(s):
@@ -112,4 +112,16 @@
   * Modified the return status when creating or manipulating a Windows service
   * Add the 'echi-converter status' command to check the status of a Windows service
 * Bug fix(es):
-  * Fixed bug #15293, the service now exists cleanly
+  * Fixed bug #15293, the service now exists cleanly
+
+== 0.3.2 2007-11-05
+
+* Major enhancement(s):
+* Minor enhancement(s):
+  * FR#15361 - Added the ability to create echi_agents and then insert data from agname.dat
+  * Added better error handling by giving a proper error when no project name is provided on a create command
+  * Added requirement for 'uuidtools' gem for creating unique filenames for the agname.dat files since the Avaya outputs them the same
+  * Capture and report the error when echi-converter create command fails
+  * Provided an example ASCII CSV file in examples/ascii_csv for testing
+* Bug fix(es):  
+  * Bug ##15367 - Added to documentation that when using a Windows FTP server you must specify 'UNIX directory listing format'

data/Manifest.txt

@@ -28,8 +28,10 @@ config/standard_version13.yml
 config/install_files.yml
 db/migrate/001_create_echi_records.rb
 db/migrate/002_create_echi_logs.rb
+db/migrate/003_create_echi_agents.rb
+db/migrate/004_change_log_name_size.rb
 bin/echi-converter
 examples/extended_version12/chr0003
 examples/extended_version12/chr0003.txt
 examples/schemas/oracle_echi.sql
-
+examples/ascii_csv/chr5500.123

data/Rakefile

@@ -79,8 +79,9 @@ hoe = Hoe.new(GEM_NAME, VERS) do |p|
     ['activesupport', '>=1.4.2'],
     ['daemons', '>=1.0.7'],
     ['fastercsv', '>=1.2.0'],
-    ['hoe', '>=1.2.2'],
-    ['rake', '>=0.7.3']
+    ['hoe', '>=1.3.0'],
+    ['rake', '>=0.7.3'],
+    ['uuidtools', '>=1.0.1']
   ]
   #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
 end

data/bin/echi-converter

@@ -72,7 +72,7 @@ def create_project dir_name
     end
   rescue => err
     puts err
-    puts 'Fatal...exiting...'
+    puts 'Fatal...exiting... - ' + err
     exit
   end
   puts ''
@@ -185,7 +185,11 @@ puts ''
 
 #Evaluate the selection and execute
 if ARGV[0] == 'create'
-  create_project ARGV[1]
+  if ARGV[1] != nil
+    create_project ARGV[1]
+  else
+    puts "ECHI-converter - You must enter a project name when creating a project"
+  end
 elsif ARGV[0] == 'upgrade'
   upgrade_project ARGV[1]
 elsif RUBY_PLATFORM["-mswin32"]

data/config/application.yml

@@ -7,13 +7,15 @@ echi_username:  anonymous
 echi_password:  
 echi_connect_type:  ftp #only ftp supported now, possible for ssh in the future
 echi_ftp_directory:  #/Users/ftp/anonymous #If blank/nil, the system will not do a CD at the start
-echi_ftp_retry: 3
+echi_ftp_retry: 10
 echi_ftp_delete:  Y #to not delete the files off of the FTP server set to N, Y to delete the files
 echi_schema: extended_version13.yml
 echi_format: BINARY #valid settings are ASCII or BINARY
 echi_process_log: Y #valid is Y/N to turn it on or off
+echi_update_agent_data:  N #Insert data in the 'echi_agents' table with the 'agname.dat' file, and update regularly (not available when 'pco_process' set to 'Y')
+echi_update_agent_data_freq:  24 #Number of hours to wait before updating the 'echi_agents' table
 
-#Currently only ftp supported, but may want to add UUCP/Serial later
+#Currently only ftp supported, but may want to add SSH/SFTP later
 echi_xfer_type: ftp
 
 #How frequently to fetch records off of the Avaya CMS ftp server
@@ -37,9 +39,9 @@ log_length: 10240000
 
 #Email address to send alerts to, specifically failures to connect to the DB or FTP servers
 #currently does not support an SMTP server that requires authentication
-alert_email_address: jgoecke@presenceco.com
-smtp_server: mail.presenceco.com
+alert_email_address: youremail@yourdomain.com
+smtp_server: smtp.yourdomain.com
 smtp_port: 25
 
 #Special settings for a specific application database
-pco_process: N #Set to yes or no if running with a PCO database
+pco_process: N #Set to yes (Y) or no (N) if running with a PCO database

data/config/install_files.yml

@@ -12,6 +12,7 @@ dirs_to_create:
     - name: examples
     - name: examples/extended_version12
     - name: examples/schemas
+    - name: examples/ascii_csv
     - name: lib
     - name: lib/echi-converter
 
@@ -31,8 +32,11 @@ files_to_copy:
     - name: config/standard_version13.yml
     - name: db/migrate/001_create_echi_records.rb
     - name: db/migrate/002_create_echi_logs.rb
+    - name: db/migrate/003_create_echi_agents.rb
+    - name: db/migrate/004_change_log_name_size.rb
     - name: examples/extended_version12/chr0003
     - name: examples/extended_version12/chr0003.txt
+    - name: examples/ascii_csv/chr5500.123
     - name: lib/database.rb
     - name: lib/database_presence.rb
     - name: lib/echi-converter.rb
@@ -48,3 +52,5 @@ files_to_upgrade:
     - name: lib/main.rb
     - name: lib/main_win32.rb
     - name: lib/echi-converter/version.rb
+    - name: db/migrate/003_create_echi_agents.rb
+    - name: db/migrate/004_change_log_name_size.rb

data/db/migrate/003_create_echi_agents.rb

@@ -0,0 +1,15 @@
+class CreateEchiAgents < ActiveRecord::Migration
+  def self.up
+    create_table "echi_agents", :force => true do |t|
+      t.column "group_id", :string
+      t.column "login_id", :string
+      t.column "name", :string
+    end
+    add_index "echi_agents", "login_id"
+  end
+
+  def self.down
+    remove_index "echi_agents", "login_id"
+    drop_table "echi_agents"
+  end
+end

data/db/migrate/004_change_log_name_size.rb

@@ -0,0 +1,9 @@
+class ChangeLogNameSize < ActiveRecord::Migration
+  def self.up
+    change_column "echi_logs", "filename", :string
+  end
+
+  def self.down
+    change_column "echi_logs", "filename", :string, :limit => 10
+  end
+end

data/examples/ascii_csv/chr5500.123

@@ -0,0 +1,18 @@
+453862,13,0,0,36,126,2007-10-08 10:55:31,2007-10-08 10:57:50,90,0,0,0,5,16,13,15,13,-1,-1,0,0,0,3,0,0,0,0,0,0,0,0,0,0,1,1,2,4,0,1,0,0,1,0,0,0,0,0,0,0,0,0,00001023911191840931,74013,,1009,,40317,,1009,7415572532,1,,,,,,,,74013,,,,,,,,,
+453869,0,0,0,163,163,2007-10-08 10:55:22,2007-10-08 10:58:05,0,0,0,138,0,3,-1,1,2,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,4,4,0,1,0,0,0,0,0,0,0,0,0,0,0,0,00001023781191840922,74001,,1012,,,,1012,6188642689,1,,,,,,,,74001,,,,,,,,,
+453870,0,0,0,0,60,2007-10-08 10:57:09,2007-10-08 10:58:09,0,0,0,0,0,911,-1,911,-1,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,4,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,00001025341191841029,1087,,1087,,,,1087,3465496498,,,,,,,,,,,,,,,,,,
+453875,6,47,0,60,656,2007-10-08 10:46:04,2007-10-08 10:58:28,227,0,0,0,4,18,14,15,14,-1,-1,0,0,0,3,0,0,0,0,1,0,0,0,0,0,1,1,2,4,1,1,0,0,1,0,0,0,0,0,0,0,0,0,00001016761191840364,74015,,1009,,40155,,1009,7809640792,4,,,,,,,,74015,,,,,,,,,
+453876,6,2,0,37,247,2007-10-08 10:54:05,2007-10-08 10:58:28,37,0,0,0,4,63,57,7,57,-1,-1,0,0,0,3,0,0,0,0,0,0,0,0,0,1,1,1,2,4,1,1,0,0,3,0,0,0,0,0,0,0,0,0,00001022721191840845,74025,,1011,,40196,,1011,4339496401,1,,,,,,,,74025,,,,,,,,,
+453877,11,7,0,45,552,2007-10-08 10:48:26,2007-10-08 10:58:28,220,0,0,0,4,16,13,15,13,-1,-1,0,0,0,3,0,0,0,0,0,0,0,0,0,1,1,1,2,4,1,1,0,0,1,0,0,0,0,0,0,0,0,0,00001018691191840506,74013,,1606,,40310,,1606,3133385882,2,,,,,,,,74013,,,,,,,,,
+453880,0,0,0,34,743,2007-10-08 10:43:05,2007-10-08 10:58:34,0,0,0,0,0,929,-1,929,-1,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,1,0,1,1,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,00001014351191840185,,,,,,,,3404687707,,,,,,,,,,,,,,,,,,
+453887,7,9,0,58,488,2007-10-08 10:50:39,2007-10-08 10:58:47,132,0,0,0,4,18,14,15,14,-1,-1,0,0,0,3,0,0,0,0,0,0,0,0,0,1,1,1,2,4,1,1,0,0,1,0,0,0,0,0,0,0,0,0,00001020131191840639,74015,,1009,,40108,,1009,5114284569,4,,,,,,,,74015,,,,,,,,,
+453888,0,0,0,0,6,2007-10-08 10:58:53,2007-10-08 10:58:59,0,0,0,0,0,911,-1,911,-1,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,4,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,00001026591191841133,1087,,1087,,,,1087,7234961461,,,,,,,,,,,,,,,,,,
+453891,72,0,0,60,163,2007-10-08 10:55:11,2007-10-08 10:59:06,103,0,0,0,4,18,14,15,14,-1,-1,0,0,0,3,0,0,0,0,0,0,0,0,0,0,1,1,2,4,0,1,0,0,1,0,0,0,0,0,0,0,0,0,00001023611191840911,74015,,1009,,40111,,1009,7188493989,4,,,,,,,,74015,,,,,,,,,
+453893,3,0,0,44,173,2007-10-08 10:56:15,2007-10-08 10:59:11,129,0,0,0,4,16,13,15,13,-1,-1,0,0,0,3,0,0,0,0,0,0,0,0,0,0,1,1,2,4,0,1,0,0,1,0,0,0,0,0,0,0,0,0,00001024601191840975,74013,,1009,,40311,,1009,5119780434,2,,,,,,,,74013,,,,,,,,,
+453894,0,0,0,0,0,2007-10-08 10:59:12,2007-10-08 10:59:12,0,0,0,0,0,913,-1,913,-1,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,6,0,0,1,0,0,0,0,0,0,0,0,0,0,0,0,00001026751191841152,1824,,1824,,,,1824,9959938868,,,,,,,,,,,,,,,,,,
+453899,0,0,0,110,110,2007-10-08 10:57:36,2007-10-08 10:59:26,0,0,0,75,0,2,-1,1,1,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,4,4,0,1,0,0,0,0,0,0,0,0,0,0,0,0,00001025701191841056,74004,,2012,,,,2012,9114281803,1,,,,,,,,74004,,,,,,,,,
+453900,7,454,0,62,1044,2007-10-08 10:41:57,2007-10-08 10:59:28,528,0,0,0,5,8,6,7,6,-1,-1,0,0,0,3,0,0,0,0,0,0,0,0,0,0,1,1,2,4,1,1,0,0,3,0,0,0,0,0,0,0,0,0,00001013611191840117,74009,,1011,,40202,,1011,3116878459,1,,,,,,,,74009,,,,,,,,,
+453901,0,0,0,162,162,2007-10-08 10:56:48,2007-10-08 10:59:30,0,0,0,139,0,3,2,1,2,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,3,4,0,1,0,0,0,0,0,0,0,0,0,0,0,0,00001025091191841008,74001,,2013,,,,2013,3709843581,1,,,,,,,,74001,,,,,,,,,
+453904,180,2,0,61,988,2007-10-08 10:41:12,2007-10-08 10:59:32,788,0,0,0,4,18,14,15,14,-1,-1,0,0,0,3,0,0,0,0,1,0,0,0,0,0,1,1,2,4,1,1,0,0,1,0,0,0,0,0,0,0,0,0,00001013161191840072,74015,,1009,,40121,,1009,4148642911,4,,,,,,,,74015,,,,,,,,,
+453911,545,0,0,62,192,2007-10-08 10:47:37,2007-10-08 10:59:54,130,0,0,0,4,8,6,7,6,-1,-1,0,0,0,3,0,0,0,0,0,0,0,0,0,0,1,1,2,4,0,1,0,0,3,0,0,0,0,0,0,0,0,0,00001018111191840457,74009,,1011,,41023,,1011,9467885678,1,,,,,,,,74009,,,,,,,,,
+453913,0,0,0,102,102,2007-10-08 10:58:14,2007-10-08 10:59:56,0,0,0,70,0,2,1,1,1,-1,-1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1,3,4,0,1,0,0,0,0,0,0,0,0,0,0,0,0,00001026141191841094,74004,,2004,,,,2004,6186251935,4,,,,,,,,74004,,,,,,,,,

data/lib/database.rb

@@ -3,3 +3,7 @@ end
 
 class EchiLog < ActiveRecord::Base
 end
+
+#The EchiAgent database table may not always be present
+class EchiAgent < ActiveRecord::Base
+end

data/lib/echi-converter.rb

@@ -4,6 +4,7 @@ require 'faster_csv'
 require 'net/ftp'
 require 'net/smtp'
 require 'fileutils'
+require 'uuidtools'
 
 class Logger
   #Change the logging format to include a timestamp
@@ -13,7 +14,6 @@ class Logger
 end
 
 module EchiConverter
-  
   def connect_database
     databaseconfig = $workingdir + '/../config/database.yml'
     dblogfile = $workingdir + '/../log/database.log'
@@ -259,9 +259,16 @@ module EchiConverter
          ftp_session.chdir($config["echi_ftp_directory"])
        end
        files = ftp_session.list('chr*')
+       
+       #Also fetch the agname.dat file if it is configured to be processed
+       if $config["echi_update_agent_data"] == "Y"
+         files = files + ftp_session.list("agname.dat")
+       end
+       
        file_cnt = 0
        files.each do | file |
          file_data = file.split(' ')
+         
          local_filename = $workingdir + '/../files/to_process/' + file_data[8]
          ftp_session.getbinaryfile(file_data[8], local_filename)
          if $config["echi_ftp_delete"] == 'Y'
@@ -280,63 +287,130 @@ module EchiConverter
    end
    return 
   end
-end
 
-def process_ascii filename
-  echi_file = $workingdir + "/../files/to_process/" + filename
+  def process_ascii filename
+    echi_file = $workingdir + "/../files/to_process/" + filename
   
-  if $config["echi_process_log"] == "Y"
-    #Log the file
-    echi_log = EchiLog.new
-    echi_log.filename = filename
-    #echi_log.filenumber = filenumber
-    #echi_log.version = fileversion
-  end
+    if $config["echi_process_log"] == "Y"
+      #Log the file
+      echi_log = EchiLog.new
+      echi_log.filename = filename
+      #echi_log.filenumber = filenumber
+      #echi_log.version = fileversion
+    end
   
-  #Perform a transaction for each file, including the log table
-  #in order to commit as one atomic action upon success
-  EchiRecord.transaction do
-    @record_cnt = 0
-    FasterCSV.foreach(echi_file) do |row|
-      if row != nil
-        @log.debug '<====================START RECORD ' + @record_cnt.to_s + ' ====================>'
-        echi_record = EchiRecord.new
-        cnt = 0
-        @echi_schema["fields"].each do | field |
-          if field["type"] == "bool" || field["type"] == "bool_int"
-            case row[cnt]
-            when "0"
-              echi_record[field["name"]] = "N"
-            when "1"
-              echi_record[field["name"]] = "Y"
-            end
-            @log.debug field["name"] + ' == ' + row[cnt]
-          else
-            echi_record[field["name"]] = row[cnt]
-            if row[cnt] != nil
+    #Perform a transaction for each file, including the log table
+    #in order to commit as one atomic action upon success
+    EchiRecord.transaction do
+      @record_cnt = 0
+      FasterCSV.foreach(echi_file) do |row|
+        if row != nil
+          @log.debug '<====================START RECORD ' + @record_cnt.to_s + ' ====================>'
+          echi_record = EchiRecord.new
+          cnt = 0
+          @echi_schema["fields"].each do | field |
+            if field["type"] == "bool" || field["type"] == "bool_int"
+              case row[cnt]
+              when "0"
+                echi_record[field["name"]] = "N"
+              when "1"
+                echi_record[field["name"]] = "Y"
+              end
               @log.debug field["name"] + ' == ' + row[cnt]
+            else
+              echi_record[field["name"]] = row[cnt]
+              if row[cnt] != nil
+                @log.debug field["name"] + ' == ' + row[cnt]
+              end
             end
+            cnt += 1
           end
-          cnt += 1
+          echi_record.save
+          @log.debug '<====================STOP RECORD ' + @record_cnt.to_s + ' ====================>'
+          @record_cnt += 1
         end
-        echi_record.save
-        @log.debug '<====================STOP RECORD ' + @record_cnt.to_s + ' ====================>'
-        @record_cnt += 1
       end
     end
-  end
   
-  #Move the file to the processed directory
-  FileUtils.mv(echi_file, @processeddirectory)
+    #Move the file to the processed directory
+    FileUtils.mv(echi_file, @processeddirectory)
   
-  if $config["echi_process_log"] == "Y"
-    #Finish logging the details on the file
-    echi_log.records = @record_cnt
-    echi_log.processed_at = Time.now
-    echi_log.save
+    if $config["echi_process_log"] == "Y"
+      #Finish logging the details on the file
+      echi_log.records = @record_cnt
+      echi_log.processed_at = Time.now
+      echi_log.save
+    end
+  
+    return @record_cnt
+  end
+
+  def insert_agent_data field
+ 
+    begin
+      echi_agent = EchiAgent.new
+      echi_agent.group_id = field[0]
+      echi_agent.login_id = field[1]
+      echi_agent.name = field[2]
+      echi_agent.save
+    rescue => err
+      @log.info "Unable to insert agent record - " + err
+    end
+ 
   end
   
-  return @record_cnt
-end
+  #Method to insert data into 'echi_agents' based on agname.dat
+  def process_agent_data
+    agent_file = $workingdir + "/../files/to_process/agname.dat"
+        
+      if File.exists?(agent_file)
+        EchiAgent.transaction do
+          @record_cnt = 0
+          File.open(agent_file).each do |row|
+            if row != nil
+              field = row.rstrip.split('|')
+              @log.debug '<====================START AGENT RECORD ' + @record_cnt.to_s + ' ====================>'
+              agent = EchiAgent.find(:first, :conditions => [ "login_id = ? AND group_id = ?", field[1], field[0]])
+              if agent != nil
+                if agent.name != field[2]
+                  agent.name = field[2]
+                  agent.update
+                  @record_cnt += 1
+                  @log.debug "Updated record - " + field.inspect
+                else
+                  @log.debug "No update required for - " + field.inspect
+                end
+              else
+                insert_agent_data field
+                @record_cnt += 1
+                @log.debug "Inserted new record - " + field.inspect
+              end
+            end
+            @log.debug '<====================STOP AGENT RECORD ' + @record_cnt.to_s + ' ====================>'
+          end
+        end
+        @agent_file_processed = Time.now
+        #Move the file to the processed directory
+        begin
+          agname_new_filename = "agname_" + UUID.timestamp_create.to_s + ".dat"
+          target_file = @processeddirectory + "/" + agname_new_filename
+          FileUtils.mv(agent_file, target_file)
+        rescue => err
+          @log.info "Issue with agname_*.dat filename - " + err
+        end
+        if $config["echi_process_log"] == "Y"
+          #Log the file
+          echi_log = EchiLog.new
+          echi_log.filename = agname_new_filename
+          #echi_log.filenumber = filenumber
+          #echi_log.version = fileversion
+          #Finish logging the details on the file
+          echi_log.records = @record_cnt
+          echi_log.processed_at = Time.now
+          echi_log.save
+        end
+      end
+    end
 
-require $workingdir + '/echi-converter/version.rb'
+  require $workingdir + '/echi-converter/version.rb'
+end

data/lib/echi-converter/version.rb

@@ -2,7 +2,7 @@ module EchiConverter #:nodoc:
   module VERSION #:nodoc:
     MAJOR = 0
     MINOR = 3
-    TINY  = 1
+    TINY  = 2
 
     STRING = [MAJOR, MINOR, TINY].join('.')
   end

data/lib/main.rb

@@ -30,6 +30,7 @@ if $config["export_type"] == 'database' || $config["export_type"] == 'both'
   connect_database
 end
 
+$init_date = Time.now
 @log.info "Running..."
 
 #Our Main loop
@@ -54,6 +55,10 @@ loop do
     end
   end
 
+  if $config["echi_update_agent_data"] == "Y" && $config["pco_process"] == "N"
+    process_agent_data
+  end
+  
   sleep $config["fetch_interval"]
 
   #Make sure we did not lose our database connection while we slept

data/lib/main_win32.rb

@@ -41,6 +41,7 @@ class EchiDaemon < Daemon
     #Open the logfile with appropriate output level
     initiate_logger
     @log.info "ECHI-Converter service initializing"
+    $init_date = Time.now
     
     #If configured for database insertion, connect to the database
     if $config["export_type"] == 'database' || $config["export_type"] == 'both'
@@ -71,7 +72,11 @@ class EchiDaemon < Daemon
             @log.info "Processed file #{file} with #{record_cnt.to_s} records"
           end
         end
-
+        
+        if $config["echi_update_agent_data"] == "Y" && $config["pco_process"] == "N"
+          process_agent_data
+        end
+        
         sleep $config["fetch_interval"]
 
         #Make sure we did not lose our database connection while we slept

data/website/index.html

@@ -33,7 +33,7 @@
     <h1>ECHI Converter</h1>
     <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/echi-converter"; return false'>
       <p>Get Version</p>
-      <a href="http://rubyforge.org/projects/echi-converter" class="numbers">0.3.1</a>
+      <a href="http://rubyforge.org/projects/echi-converter" class="numbers">0.3.2</a>
     </div>
     <h1>&#x2192; &#8216;echi-converter&#8217;</h1>
 
@@ -63,6 +63,7 @@
 		<li>Convert from the defined Binary format to <span class="caps">ASCII</span></li>
 		<li>Insert the records into the defined database table using database transactions, via ActiveRecord, on a per file basis to support recovery on failure</li>
 		<li>Change schema structure via <span class="caps">YML</span> configuration file to accommodate various releases of the <span class="caps">ECHI</span> format</li>
+		<li>Supports inserting agent names from agname.dat</li>
 		<li>Runs as a daemon (via fork) on *NIX and a service on Windows</li>
 	</ol>
 
@@ -72,6 +73,7 @@
 	<ol>
 	<li>echi_records &#8211; stores all <span class="caps">ECHI</span> data        </li>
 		<li>echi_logs &#8211; stores a log entry for each file processed</li>
+		<li>echi_agents &#8211; stores the data from the agname.dat file</li>
 	</ol></li>
 	</ol>
 
@@ -86,8 +88,9 @@
 		<li><a href="http://activesupport.rubyforge.org/">ActiveSupport v1.4.2+</a></li>
 		<li><a href="http://daemons.rubyforge.org/">Daemons v1.0.7+</a></li>
 		<li><a href="http://fastercsv.rubyforge.org/">FasterCSV v1.2.0+</a></li>
-		<li><a href="http://rake.rubyforge.org/">Rake v0.7.3+</a>
-    # <a href="http://win32utils.rubyforge.org/">Win32-service v.0.5.0+</a> (Manual install for Windows only)</li>
+		<li><a href="http://rake.rubyforge.org/">Rake v0.7.3+</a></li>
+		<li><a href="http://sporkmonger.com/projects/uuidtools/">UUIDTools v1.0.1+</a></li>
+		<li><a href="http://win32utils.rubyforge.org/">Win32-service v.0.5.0+</a> (Manual install for Windows only)</li>
 		<li><a href="http://rubyforge.org/projects/seattlerb/">Hoe v1.2.2+</a></li>
 	</ol>
 
@@ -136,6 +139,9 @@
 	</ol>
 
 
+	<p>Note:  When using a Windows <span class="caps">FTP</span> server, you must configure the <span class="caps">FTP</span> server to provide a <span class="caps">UNIX</span> directory listing format</p>
+
+
 	<h2>Usage</h2>
 
 
@@ -161,7 +167,7 @@
 
 
 	<ol>
-	<li>echi-converter install myproject &#8211; install the service (must specify complete path such as c:\path\to\my\project &#8211; if the directory name or path has any spaces, please enclose the &#8216;myproject&#8217; in double quotes )</li>
+	<li>echi-converter install myproject &#8211; install the service (must specify complete path such as c:\path\to\my\project &#8211; if the directory name or path has any spaces, please enclose the &#8220;myproject&#8221; in double quotes )</li>
 		<li>echi-converter start &#8211; start the service</li>
 		<li>echi-converter stop &#8211; stop the service</li>
 		<li>echi-converter pause &#8211; pause the service</li>
@@ -172,6 +178,14 @@
 	</ol>
 
 
+	<ol>
+	<li>If you would like to run the script interactively, you may also execute this command: 
+	<ol>
+	<li>ruby &#8220;c:\myproject\lib\main_win32.rb&#8221;</li>
+	</ol></li>
+	</ol>
+
+
 	<h2>Demonstration of usage</h2>
 
 
@@ -217,7 +231,7 @@
 
 	<p>Comments are welcome. Send an email to <a href="mailto:jason@goecke.net">jason [at] goecke.net</a>.</p>
     <p class="coda">
-      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 4th November 2007<br>
+      <a href="mailto:drnicwilliams@gmail.com">Dr Nic</a>, 5th November 2007<br>
       Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
     </p>
 </div>

data/website/index.txt

@@ -22,11 +22,13 @@ The utility provides the following capabilities:
 	# Convert from the defined Binary format to ASCII
 	# Insert the records into the defined database table using database transactions, via ActiveRecord, on a per file basis to support recovery on failure
 	# Change schema structure via YML configuration file to accommodate various releases of the ECHI format
+	# Supports inserting agent names from agname.dat
 	# Runs as a daemon (via fork) on *NIX and a service on Windows
 
 # Table names:
 ## echi_records - stores all ECHI data        
 ## echi_logs - stores a log entry for each file processed
+## echi_agents - stores the data from the agname.dat file 
 
 
 h2. Requirements
@@ -38,7 +40,8 @@ h2. Requirements
 	# "Daemons v1.0.7+":http://daemons.rubyforge.org/
 	# "FasterCSV v1.2.0+":http://fastercsv.rubyforge.org/
 	# "Rake v0.7.3+":http://rake.rubyforge.org/
-        # "Win32-service v.0.5.0+":http://win32utils.rubyforge.org/ (Manual install for Windows only)
+	# "UUIDTools v1.0.1+":http://sporkmonger.com/projects/uuidtools/
+	# "Win32-service v.0.5.0+":http://win32utils.rubyforge.org/ (Manual install for Windows only)
 	# "Hoe v1.2.2+":http://rubyforge.org/projects/seattlerb/
 
 
@@ -50,7 +53,6 @@ or
 
 <pre syntax="ruby">gem install echi-converter</pre>
 
-
 h2. Setup
 
 First, create the directory with all of the project files where you will run this application from:
@@ -70,6 +72,7 @@ Once this is complete, then simply run these commands from the project directory
 	# rake migrate (creates the tables required for the system)
 	# echi-converter (starts the server daemon, refer to its usage)
 
+Note:  When using a Windows FTP server, you must configure the FTP server to provide a UNIX directory listing format
 
 h2. Usage
 
@@ -86,7 +89,7 @@ For *NIX:
 
 For Windows:
 
-# echi-converter install myproject - install the service (must specify complete path such as c:\path\to\my\project - if the directory name or path has any spaces, please enclose the 'myproject' in double quotes )
+# echi-converter install myproject - install the service (must specify complete path such as c:\path\to\my\project - if the directory name or path has any spaces, please enclose the "myproject" in double quotes )
 # echi-converter start - start the service
 # echi-converter stop - stop the service
 # echi-converter pause - pause the service
@@ -95,6 +98,9 @@ For Windows:
 # echi-converter uninstall - uninstall the service
 # echi-converter delete - delete the service"
 
+# If you would like to run the script interactively, you may also execute this command: 
+## ruby "c:\myproject\lib\main_win32.rb"
+
 h2. Demonstration of usage
 
 Start the daemon/service:

metadata

@@ -3,8 +3,8 @@ rubygems_version: 0.9.4
 specification_version: 1
 name: echi-converter
 version: !ruby/object:Gem::Version 
-  version: 0.3.1
-date: 2007-11-04 00:00:00 -07:00
+  version: 0.3.2
+date: 2007-11-05 00:00:00 -08:00
 summary: ECHI Conversion Utility - Provides a utility to fetch Avaya CMS / ECHI binary files, convert them and insert into a database table via ActiveRecord
 require_paths: 
 - lib
@@ -58,10 +58,13 @@ files:
 - config/install_files.yml
 - db/migrate/001_create_echi_records.rb
 - db/migrate/002_create_echi_logs.rb
+- db/migrate/003_create_echi_agents.rb
+- db/migrate/004_change_log_name_size.rb
 - bin/echi-converter
 - examples/extended_version12/chr0003
 - examples/extended_version12/chr0003.txt
 - examples/schemas/oracle_echi.sql
+- examples/ascii_csv/chr5500.123
 test_files: 
 - test/test_echi-converter.rb
 - test/test_helper.rb
@@ -127,3 +130,12 @@ dependencies:
       - !ruby/object:Gem::Version 
         version: 0.7.3
     version: 
+- !ruby/object:Gem::Dependency 
+  name: uuidtools
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.1
+    version: