mgparser 0.1.9 → 0.1.12

data/README.markdown

@@ -3,19 +3,49 @@ MGParser
 
 MGParser (MGP) is a tool which makes analysis of Mediatrix ISDN gateways debug a much simpler task.
 
-Documentation
+Prerequisites
 =============
 
-TODO
+- Mediatrix 4400 series media gateway (3000 also should be fine) with firmware version DGW2.0 
+- Ruby 1.8.7/1.9.2
+
+Getting Started
+=============
+
+Before starting mgparser ensure that there is no firewall enabled on your Mediatrix unit or that there is a rule 
+which will accept incoming connections on it's SNMP port (default is 161 but you can provide a different one with -s PORT option).
+You can find Mediatrix firewall settings in Network-->Local Firewall menu.
+You should also check that the syslog level is set to "Warning" or above for all services, if you have factory default settings
+this should already be OK.
+
+Update your rubygems:
+<p><code>
+	sudo gem update --system
+</code></p>
+
+Install mgparser:
+<p><code>
+	sudo gem install mgparser
+</code></p>
+
+To start mgparser just type:
+<p><code>
+	sudo mgparser -i ip_of_your_Mediatrix_unit
+</code></p>
+
+If you want to analyze a log file instead of making live debug you can type:
+<p><code>
+	mgparser -l path/to/your/log/file
+</code></p>
+ 
 <pre><code>
-Usage: MGParser.rb [options]
+Usage: mgparser [options]
 
 Specific options:
     -p, --port PORT                  Port number on which receive syslog (default is 514)
-    -s, --snmpport PORT              Gateway SNMP port number (default is 161)
-    -i, --ipaddr IPADDR              Media Gateway IP
+    -s, --snmpport PORT              Media Gateway SNMP port number (default is 161)
+    -i, --ipaddr IPADDR              Media Gateway IP address
     -l, --logfile LOGFILE            Log file to analyze
-    -v, --[no-]verbose               Run verbosely
 
 Common options:
     -h, --help                       Show this message

data/bin/mgparser

@@ -87,7 +87,9 @@ $causes = {"1" => "Unallocated (unassigned) number",
 if $options.list[:logfile]
   if FileTest::exist?($options.list[:logfile])
     data = IO.readlines($options.list[:logfile])
-    call = Call.new(data)
+    @is_file = true
+    call = Call.new
+    call.analyze(data,@is_file)
   else
     puts "File not found"
   end
@@ -100,15 +102,27 @@ else
     end
 
     def receive_data(data)
-      @call.analyze(data)
+      @is_file = false
+      @call.analyze(data,@is_file)
     end
   end
 
   #We initialize eventmachine
+  begin
   EventMachine::run do
     host = UDPSocket.open {|s| s.connect($options.list[:ipaddr],30000); s.addr.last }
 	  port = $options.list[:port]
 	  snmpgw = SnmpGw.new($options.list[:port],$options.list[:ipaddr],$options.list[:snmp])
+	  begin
 	  EventMachine::open_datagram_socket host, port, SyslogServer
+	  rescue RuntimeError, Interrupt
+      puts "Closing..."
+      abort ""
+    end
+  end
+  rescue Interrupt
+    puts "Interrupted"
+  rescue RunetimeError
+    puts "Are you root?"
   end
 end

data/lib/call.rb

@@ -1,98 +1,123 @@
 class Call
 attr_accessor :data
 
-def analyze(data)
+  def analyze(data,is_file)
  
-  @callprogr_counter = 0
-  @matched = 0
-  
-  data.each do |line|
+    @callprogr_counter = 0
+    @matched = 0
+    
+    if is_file == true
+      data.each do |line|
+        parse(line)
+      end
+    else
+      parse(data)
+    end
 
-    if line =~ /Unicast RECV Setup/
-      @inbound = true
+  end
 
-    elsif line =~ /CallRouter \[.*\] Src=/
-      @caller = line.scan(/e164=(\d{1,})/).first          
-        
-    elsif line =~ /CallRouter \[.*\] Dst\d\/2/
-      @called = line.scan(/e164=(\d{1,})/).first
+  def parse(line)
+      if line =~ /Unicast RECV Setup/
+        @inbound = true
 
-          
-    elsif line =~ /UseNextDestination - Call \d{1,}-\d{1,}/
-      id = line.scan(/UseNextDestination - Call \d{1,}-(\d{1,})/).first
-      if @matched < 1
-        if @inbound == true
-          @matched += 1
+      elsif line =~ /CallRouter \[.*\] Src=/
+        @caller = line.scan(/e164=(\d{1,})/).flatten!.first       
+
+      elsif line =~ /CallRouter \[.*\] Dst\d\/2/
+        @called = line.scan(/e164=(\d{1,})/).flatten!.first
+
+
+      elsif line =~ /UseNextDestination - Call \d{1,}-\d{1,}/
+        id = line.scan(/UseNextDestination - Call \d{1,}-(\d{1,})/).flatten!.first
+        if @matched < 1
+          if @inbound == true
+            @matched += 1
+          else
+            puts  "Call ID: #{id} - Caller: #{@caller}"
+            puts  "Call ID: #{id} - Called: #{@called}"
+          end
         else
           puts  "Call ID: #{id} - Caller: #{@caller}"
           puts  "Call ID: #{id} - Called: #{@called}"
+          @matched = 0
         end
-      else
-        puts  "Call ID: #{id} - Caller: #{@caller}"
-        puts  "Call ID: #{id} - Called: #{@called}"
-        @matched = 0
-      end
-        
-    elsif line =~ /CallManager \[.*\] C\d{1,} - Send CallSetupA/
-      id = line.scan(/C(\d{1,}) -/).first
-      if @inbound == true
-        puts "Call ID: #{id} - <== ISDN setup received"
-      else
-        puts "Call ID: #{id} - ==> ISDN setup sent"
-      end
-      @inbound = false
-        
-    elsif line =~ /"Proceeding Indication" .* for state CallSetup./
-      @progress_indication = true
-        
-    elsif line =~ /CallManager \[.*\] C\d{1,} - CallProgressA\(2\)/
-      @callprogr_counter += 1
-      id = line.scan(/C(\d{1,}) -/).first
-        
-        if @progress_indication == true
-          #puts "Call ID: #{id} - <== \"Proceeding indication\" received from operator" 
-          @progress_indication = false
+
+      elsif line =~ /CallManager \[.*\] C\d{1,} - Send CallSetupA/
+        id = line.scan(/C(\d{1,}) -/).flatten!.first
+        if @inbound == true
+          puts "Call ID: #{id} - <== ISDN setup received"
         else
-          if @callprogr_counter >= 3
-            puts "Call ID: #{id} - <== The call will be probably answered by operator\'s voicemail or is being forwarded"
-            @callprogr_counter = 0
+          puts "Call ID: #{id} - ==> ISDN setup sent"
+        end
+        @inbound = false
+
+      elsif line =~ /"Proceeding Indication" .* for state CallSetup./
+        @progress_indication = true
+
+      elsif line =~ /CallManager \[.*\] C\d{1,} - CallProgressA\(2\)/
+        @callprogr_counter += 1
+        id = line.scan(/C(\d{1,}) -/).flatten!.first
+
+          if @progress_indication == true
+            #puts "Call ID: #{id} - <== \"Proceeding indication\" received from operator" 
+            @progress_indication = false
           else
-            puts "Call ID: #{id} - <== \"Call Progress\" received from operator"
-          end
-        end 
-    
-    elsif line =~ /CallManager \[.*\] C\d{1,} - CallProgressA\(3\)/
-      id = line.scan(/C(\d{1,}) -/).first
-      puts "Call ID: #{id} - ==> \"Call Progress\" sent to the operator"
-        
-        
-    elsif line =~ /CallManager \[.*\] C\d{1,} - CallProgressA\(1\)/
-      id = line.scan(/C(\d{1,}) -/).first
-      puts "Call ID: #{id} - <== Destination number is ringing" 
-        
-        
-    elsif line =~ /CallManager \[.*\] C\d{1,} - CallConnectA/
-      id = line.scan(/C(\d{1,}) -/).first
-      puts "Call ID: #{id} - Call has been answered!" 
+            if @callprogr_counter >= 3
+              puts "Call ID: #{id} - <== The call will be probably answered by operator\'s voicemail or is being forwarded"
+              @callprogr_counter = 0
+            else
+              puts "Call ID: #{id} - <== \"Call Progress\" received from operator"
+            end
+          end 
+
+      elsif line =~ /CallManager \[.*\] C\d{1,} - CallProgressA\(3\)/
+        id = line.scan(/C(\d{1,}) -/).flatten!.first
+        puts "Call ID: #{id} - ==> \"Call Progress\" sent to the operator"
+
+
+      elsif line =~ /CallManager \[.*\] C\d{1,} - CallProgressA\(1\)/
+        id = line.scan(/C(\d{1,}) -/).flatten!.first
+        puts "Call ID: #{id} - <== Destination number is ringing" 
+
+
+      elsif line =~ /CallManager \[.*\] C\d{1,} - CallConnectA/
+        id = line.scan(/C(\d{1,}) -/).flatten!.first
+        puts "Call ID: #{id} - Call has been answered!" 
 
 
-    elsif line =~ /CallManager \[.*\] C\d{1,} - CallMessageA\(2\)/
-      id = line.scan(/C(\d{1,}) -/).first
-      @isdn_inbound_disconnect = true
+      elsif line =~ /CallManager \[.*\] C\d{1,} - CallMessageA\(2\)/
+        id = line.scan(/C(\d{1,}) -/).flatten!.first
+        @isdn_inbound_disconnect = true
 
+      elsif line =~ /CallManager.* Call is not allowed/
+        @resource_unavailable = true
+        @resource_unavailable_id = line.scan(/CallManager \[.*\] C\d{1,}-(\d{1,})/).flatten!.first
         
-    elsif line =~ /CallManager \[.*\] C\d{1,} - Send CallReleaseA\(\d{1,}\)/
-      id = line.scan(/C(\d{1,}) -/).first
-      cause = line.scan(/Send CallReleaseA\((\d{1,})/).first
+      elsif line =~ /CallTable.* ReleaseCall - Interface isdn.*try to release.* \d{1,}/
+        @abnormal_hangup = true
+        @abnormal_hangup_id = line.scan(/CallTable.* ReleaseCall - Interface isdn.*try to release.* (\d{1,})/).flatten!.first
 
-        if @isdn_inbound_disconnect == true
-          puts "Call ID: #{id} - <== Operator requested hangup with cause: \"#{$causes[cause.first]}\""
-          @isdn_inbound_disconnect = false
+
+      elsif line =~ /CallManager \[.*\] C\d{1,} - Send CallReleaseA\(\d{1,}\)/
+        if @resource_unavailable == true
+          id = @resource_unavailable_id
+          @resource_unavailable = false
+        elsif @abnormal_hangup == true
+          id = @abnormal_hangup_id
+          @abnormal_hangup = false
         else
-          puts "Call ID: #{id} - ==> Gateway sent hangup with cause: \"#{$causes[cause.first]}\""
+          id = line.scan(/C(\d{1,}) -/).flatten!.first
         end
-        
-    end
-end
-end
+        cause = line.scan(/Send CallReleaseA\((\d{1,})/).flatten!.first
+
+          if @isdn_inbound_disconnect == true
+            puts "Call ID: #{id} - <== Operator requested hangup with cause: \"#{$causes[cause]}\""
+            @isdn_inbound_disconnect = false
+          else
+            puts "Call ID: #{id} - ==> Gateway sent hangup with cause: \"#{$causes[cause]}\""
+          end
+
+      end
+  end
+
 end

data/lib/snmp_gw.rb

@@ -23,6 +23,8 @@ def initialize(port, ipaddr, snmp)
   rescue SNMP::RequestTimeout
     puts "Host is not responding (a firewall can be active or there is no SNMP network service listening on port: #{snmp})"
     abort ""
+  rescue Interrupt
+    puts "Closing gracefully"
   end
 
 end

data/lib/version.rb

@@ -2,7 +2,7 @@ module Mgparser
 module VERSION
     MAJOR = 0 unless defined? MAJOR
     MINOR = 1 unless defined? MINOR
-    TINY  = 9 unless defined? TINY
+    TINY  = 12 unless defined? TINY
     
     STRING = [MAJOR, MINOR, TINY].join('.') unless defined? STRING
   end

data/mgparser.gemspec

@@ -12,7 +12,6 @@ Gem::Specification.new do |s|
   s.description = "MGParser (MGP) is a tool which makes analysis of Mediatrix ISDN gateways debug a much simpler task"
   s.email = "dawid.pogorzelski@mybushido.com"
   s.executables = ["mgparser"]
-
   s.files = %w{
     README.markdown
     bin/mgparser

metadata

@@ -1,75 +1,57 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: mgparser
-version: !ruby/object:Gem::Version 
-  hash: 9
+version: !ruby/object:Gem::Version
+  version: 0.1.12
   prerelease: 
-  segments: 
-  - 0
-  - 1
-  - 9
-  version: 0.1.9
 platform: ruby
-authors: 
+authors:
 - Dawid Pogorzelski
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-04-22 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2011-04-26 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: bundler
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &2157613240 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 1
-        - 0
-        - 10
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 1.0.10
   type: :runtime
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: eventmachine
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *2157613240
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: &2157612860 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: snmp
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: *2157612860
+- !ruby/object:Gem::Dependency
+  name: snmp
+  requirement: &2157612400 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirements: *id003
-description: MGParser (MGP) is a tool which makes analysis of Mediatrix ISDN gateways debug a much simpler task
+  prerelease: false
+  version_requirements: *2157612400
+description: MGParser (MGP) is a tool which makes analysis of Mediatrix ISDN gateways
+  debug a much simpler task
 email: dawid.pogorzelski@mybushido.com
-executables: 
+executables:
 - mgparser
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
+files:
 - README.markdown
 - bin/mgparser
 - mgparser.gemspec
@@ -81,36 +63,26 @@ files:
 - Gemfile
 homepage: https://github.com/dawid999/MGParser
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
 rubygems_version: 1.7.2
 signing_key: 
 specification_version: 3
 summary: Mediatrix ISDN gateways debug utility
 test_files: []
-