ruby-nagios 0.0.2 → 0.1.0

data/.gitignore

@@ -1 +1,4 @@
 pkg
+doc
+.yardoc
+.DS_Store

data/Rakefile

@@ -1,2 +1,20 @@
 require 'bundler'
 Bundler::GemHelper.install_tasks
+
+namespace :spec do
+
+  desc "Run production configuration test"
+  task :config do
+    ENV['RSPEC_ENV'] = 'production'
+    sh %{rspec -f d --color --fail-fast spec/00_configuration_spec.rb}
+  end
+
+  namespace :test do
+
+    desc "Run configuration test in `test` environment"
+    task :config do
+      ENV['RSPEC_ENV'] = 'test'
+      sh %{rspec -f d --color spec/00_configuration_spec.rb}
+    end
+  end
+end

data/bin/check_check

@@ -23,12 +23,12 @@ class Nagios::Status::Model
 
   def initialize(path)
     @path = path
-    @status = Nagios::Status.new
+    @status = Nagios::Status.new @path
     update
   end # def initialize
 
   def update
-    @status.parsestatus(@path)
+    @status.parsestatus
   end # def update
 
   def services(service_pattern=nil, host_pattern=nil)
@@ -160,6 +160,14 @@ def main(args)
     end # if results[state]
   end # for each non-OK state
 
+  # If everything is OK, still print detailed output for confirmation
+  if total_results == 0 and results["OK"].size > 0
+      puts "OK Services:"
+      results["OK"].sort { |a,b| a["host_name"] <=> b["host_name"] }.each do |service|
+        puts "  #{service["host_name"]} => #{service["service_description"]}"
+      end
+  end
+
   exitcode = 0
 
   if settings.down_min_percent

data/bin/nagsrv

@@ -77,7 +77,7 @@ OptionParser.new do |opts|
   end
 
   opts.on("--list-services", "List services that match certain criteria") do
-    listhosts = true
+    listservices = true
   end
 
   opts.separator ""
@@ -128,9 +128,9 @@ end.parse!
 
 abort "Cannot find #{statusfile}" unless File.exist?(statusfile)
 
-nagios = Nagios::Status.new
+nagios = Nagios::Status.new statusfile
 
-nagios.parsestatus(statusfile)
+nagios.parsestatus
 
 
 # We want hosts so abuse the action field to print just the hostname
@@ -141,6 +141,10 @@ if listhosts
   forhost = "/." if forhost.size == 0
 end
 
+if listservices && action == nil
+  action = "${service}"
+end
+
 options = {:forhost => forhost, :notifyenabled => notify, :action => action, :withservice => withservice}
 services = nagios.find_services(options)
 

data/lib/nagios/config.rb

@@ -2,10 +2,11 @@ module Nagios
 
 =begin rdoc
 
-Configuration parser for Nagios. Constructor parses Nagios' main
-config file and returns an object: each configuration option's value
-assigned to an instance variable and attribute reader method is
-created.
+Parser of the main Nagios configuration file -- nagios.cfg. 
+
+Constructor parses Nagios' main config file and returns an object:
+each configuration option's value assigned to an instance variable and
+attribute reader method is created.
 
 Can be used as:
 
@@ -18,43 +19,82 @@ Can be used as:
       nagios.status_file
   => "/var/cache/nagios3/status.dat"
 
+= Configuration of the module
+
+Default search directory and file pattern (Dir.glob) is defined by
+Nagios::DEFAULT[:nagios_cfg_glob] constant. It is set in
++config/default.rb+ file. 
+
+@note If you have more than one /etc/nagios* directories then only
+first one will be used. For example, Debian can have both Nagios 2 and
+3 installed. In the latter case configuration file is
++/etc/nagios3/nagios.cfg+.
+
 
 =end  
   class Config
 
-    DEFAULT_CONFIG = "/etc/nagios*/nagios.cfg"
-
-    # Read and parse configuration file.
-    #
+    ##
+    # Initialize configuration file path. Check existence and
+    # readability of the file, raise exception if not.
+    # 
     # @param [String] config_file PATH to the configuration file. If
     #     PATH is not provided method will look for configuration file
-    #     +nagios.cfg+ in +/etc/nagios*+ directory.
-    # @note If you have more than one /etc/nagios* directories then
-    #    only first one will be used. For example, Debian can have
-    #    both Nagios 2 and 3 installed. In the latter case
-    #    configuration file is +/etc/nagios3/nagios.cfg+.
-    # @author Dmytro Kovalov, dmytro.kovalov@gmail.com
+    #     +nagios.cfg+ in directory, defined by
+    #     Nagios::DEFAULT[:nagios_cfg_glob] constant ( ususally
+    #     /etc/nagios*/nagios.cfg);
+    #
     def initialize config_file=nil
-      @config = config_file || Dir.glob(DEFAULT_CONFIG).first
-      
-      raise "No configuration file option and no files in #{DEFAULT_CONFIG} " unless @config
+
+      @config = config_file || Dir.glob( Nagios::DEFAULT[:nagios_cfg_glob] ).first
+      @path = @config
+
+      @configuration ||= {}
+      raise "No configuration file option and no files in #{ DEFAULT[:nagios_cfg_glob] } " unless @config
       raise "Configuration file #{@config} does not exist" unless File.exist? @config
       raise "Configuration file #{@config} is not readable" unless File.readable? @config
 
-      File.readlines(@config).map{ |l| l.sub(/#.*$/,'')}.delete_if { |l| l=~ /^$/}.each do |l|
-        key,val = l.strip.split('=',2)
-        raise "Incorrect configuration line #{l}" unless key && val
+    end
+
+    # Hash holding all the configuration after parsing. Additionally
+    # for every key in the configuration Hash method is created with
+    # the same name, which returns the value.
+    attr_accessor :configuration
+
+    # Path to main configuration file nagios.cfg
+
+    attr_accessor :path
+    
+    ##
+    # Read and parse main Nagios  configuration file +nagios.cfg+
+    #
+    #
+    # @author Dmytro Kovalov, dmytro.kovalov@gmail.com
+    def parse
+      idx=0
+      File.readlines(@config).map{ |l| l.sub(/\s*#.*$/,'')}.delete_if { |l| l=~ /^\s*$/}.each do |l|
+        idx += 1
+        key,val = l.chomp.strip.split(/\s*=\s*/,2)
+        raise "Incorrect configuration line ##{idx}: '#{l}'" unless key && val
 
         case key
-        when /cfg_(file|dir)/ # There could be multiple entries for cfg_dir/file
+          # There could be multiple entries for cfg_dir/file, so these
+          # are Arrays.
+        when /cfg_(file|dir)/
+          @configuration[key] ||= []
+          @configuration[key] << val
           instance_variable_set("@#{key}", (instance_variable_get("@#{key}") || []) << val )
         else
+
+          @configuration[key] = val
           instance_variable_set("@#{key}", val)
           instance_eval val =~ /^[\d\.-]+/ ? 
           "def #{key}; return #{val}; end" :
             "def #{key}; return %Q{#{val}}; end"
         end
       end
+
+      self
     end
 
     # Special case for cfg_file and cfg_dir: they are Arrays

data/lib/nagios/external_commands/list.rb

@@ -0,0 +1,186 @@
+module Nagios
+  class ExternalCommands
+    # External commands list in nagios and format to send this to
+    # Nagios. Keys of the Hash are names of commands, values are
+    # Array's of Nagios variables to be sent. Arrays are converted to
+    # ERB templates before printing, command name and all variables
+    # joined together by semicolons.
+    #
+    # Each variable must be defined as attr_accessor, these variables
+    # are used in ERB binding.
+    #
+    # List of all available nagios external commands, formats and
+    # descriptions can be obtained from
+    # http://www.nagios.org/developerinfo/externalcommands As of the
+    # time of writing this list is 157 commands for Nagios 3.x.
+    #
+    # == Example
+    #
+    #     PROCESS_SERVICE_CHECK_RESULT: %w{host_name service_description return_code plugin_output} 
+    #
+    #     converted to template on print:
+    #
+    #     [timestamp] PROCESS_SERVICE_CHECK_RESULT;<%= host_name %>;<%= service_description %>;<%= return_code %>;<%= plugin_output %>\n
+    #
+    ACTIONS = { 
+      ACKNOWLEDGE_HOST_PROBLEM: %w{host_name sticky notify persistent author comment},
+      ACKNOWLEDGE_SVC_PROBLEM: %w{host_name service_description sticky notify persistent author comment},
+      ADD_HOST_COMMENT: %w{host_name persistent author comment},
+      ADD_SVC_COMMENT: %w{host_name service_description persistent author comment},
+      CHANGE_CONTACT_HOST_NOTIFICATION_TIMEPERIOD: %w{contact_name notification_timeperiod},
+      CHANGE_CONTACT_MODATTR: %w{contact_name value},
+      CHANGE_CONTACT_MODHATTR: %w{contact_name value},
+      CHANGE_CONTACT_MODSATTR: %w{contact_name value},
+      CHANGE_CONTACT_SVC_NOTIFICATION_TIMEPERIOD: %w{contact_name notification_timeperiod},
+      CHANGE_CUSTOM_CONTACT_VAR: %w{contact_name varname varvalue},
+      CHANGE_CUSTOM_HOST_VAR: %w{host_name varname varvalue},
+      CHANGE_CUSTOM_SVC_VAR: %w{host_name service_description varname varvalue},
+      CHANGE_GLOBAL_HOST_EVENT_HANDLER: %w{event_handler_command},
+      CHANGE_GLOBAL_SVC_EVENT_HANDLER: %w{event_handler_command},
+      CHANGE_HOST_CHECK_COMMAND: %w{host_name check_command},
+      CHANGE_HOST_CHECK_TIMEPERIOD: %w{host_name check_timeperod},
+      CHANGE_HOST_CHECK_TIMEPERIOD: %w{host_name timeperiod},
+      CHANGE_HOST_EVENT_HANDLER: %w{host_name event_handler_command},
+      CHANGE_HOST_MODATTR: %w{host_name value},
+      CHANGE_MAX_HOST_CHECK_ATTEMPTS: %w{host_name check_attempts},
+      CHANGE_MAX_SVC_CHECK_ATTEMPTS: %w{host_name service_description check_attempts},
+      CHANGE_NORMAL_HOST_CHECK_INTERVAL: %w{host_name check_interval},
+      CHANGE_NORMAL_SVC_CHECK_INTERVAL: %w{host_name service_description check_interval},
+      CHANGE_RETRY_HOST_CHECK_INTERVAL: %w{host_name service_description check_interval},
+      CHANGE_RETRY_SVC_CHECK_INTERVAL: %w{host_name service_description check_interval},
+      CHANGE_SVC_CHECK_COMMAND: %w{host_name service_description check_command},
+      CHANGE_SVC_CHECK_TIMEPERIOD: %w{host_name service_description check_timeperiod},
+      CHANGE_SVC_EVENT_HANDLER: %w{host_name service_description event_handler_command},
+      CHANGE_SVC_MODATTR: %w{host_name service_description value},
+      CHANGE_SVC_NOTIFICATION_TIMEPERIOD: %w{host_name service_description notification_timeperiod},
+      DELAY_HOST_NOTIFICATION: %w{host_name notification_time},
+      DELAY_SVC_NOTIFICATION: %w{host_name service_description notification_time},
+      DEL_ALL_HOST_COMMENTS: %w{host_name},
+      DEL_ALL_SVC_COMMENTS: %w{host_name service_description},
+      DEL_HOST_COMMENT: %w{comment_id},
+      DEL_HOST_DOWNTIME: %w{downtime_id},
+      DEL_SVC_COMMENT: %w{comment_id},
+      DEL_SVC_DOWNTIME: %w{downtime_id},
+      DISABLE_ALL_NOTIFICATIONS_BEYOND_HOST: %w{host_name},
+      DISABLE_CONTACTGROUP_HOST_NOTIFICATIONS: %w{contactgroup_name},
+      DISABLE_CONTACTGROUP_SVC_NOTIFICATIONS: %w{contactgroup_name},
+      DISABLE_CONTACT_HOST_NOTIFICATIONS: %w{contact_name},
+      DISABLE_CONTACT_SVC_NOTIFICATIONS: %w{contact_name},
+      DISABLE_EVENT_HANDLERS: [],
+      DISABLE_FAILURE_PREDICTION: [],
+      DISABLE_FLAP_DETECTION: [],
+      DISABLE_HOSTGROUP_HOST_CHECKS: %w{hostgroup_name},
+      DISABLE_HOSTGROUP_HOST_NOTIFICATIONS: %w{hostgroup_name},
+      DISABLE_HOSTGROUP_PASSIVE_HOST_CHECKS: %w{hostgroup_name},
+      DISABLE_HOSTGROUP_PASSIVE_SVC_CHECKS: %w{hostgroup_name},
+      DISABLE_HOSTGROUP_SVC_CHECKS: %w{hostgroup_name},
+      DISABLE_HOSTGROUP_SVC_NOTIFICATIONS: %w{hostgroup_name},
+      DISABLE_HOST_AND_CHILD_NOTIFICATIONS: %w{host_name},
+      DISABLE_HOST_CHECK: %w{host_name},
+      DISABLE_HOST_EVENT_HANDLER: %w{host_name},
+      DISABLE_HOST_FLAP_DETECTION: %w{host_name},
+      DISABLE_HOST_FRESHNESS_CHECKS: [],
+      DISABLE_HOST_NOTIFICATIONS: %w{host_name},
+      DISABLE_HOST_SVC_CHECKS: %w{host_name},
+      DISABLE_HOST_SVC_NOTIFICATIONS: %w{host_name},
+      DISABLE_NOTIFICATIONS: [],
+      DISABLE_PASSIVE_HOST_CHECKS: %w{host_name},
+      DISABLE_PASSIVE_SVC_CHECKS: %w{host_name service_description},
+      DISABLE_PERFORMANCE_DATA: [],
+      DISABLE_SERVICEGROUP_HOST_CHECKS: %w{servicegroup_name},
+      DISABLE_SERVICEGROUP_HOST_NOTIFICATIONS: %w{servicegroup_name},
+      DISABLE_SERVICEGROUP_PASSIVE_HOST_CHECKS: %w{servicegroup_name},
+      DISABLE_SERVICEGROUP_PASSIVE_SVC_CHECKS: %w{servicegroup_name},
+      DISABLE_SERVICEGROUP_SVC_CHECKS: %w{servicegroup_name},
+      DISABLE_SERVICEGROUP_SVC_NOTIFICATIONS: %w{servicegroup_name},
+      DISABLE_SERVICE_FLAP_DETECTION: %w{host_name service_description},
+      DISABLE_SERVICE_FRESHNESS_CHECKS: [],
+      DISABLE_SVC_CHECK: %w{host_name service_description},
+      DISABLE_SVC_EVENT_HANDLER: %w{host_name service_description},
+      DISABLE_SVC_FLAP_DETECTION: %w{host_name service_description},
+      DISABLE_SVC_NOTIFICATIONS: %w{host_name service_description},
+      ENABLE_ALL_NOTIFICATIONS_BEYOND_HOST: %w{host_name},
+      ENABLE_CONTACTGROUP_HOST_NOTIFICATIONS: %w{contactgroup_name},
+      ENABLE_CONTACTGROUP_SVC_NOTIFICATIONS: %w{contactgroup_name},
+      ENABLE_CONTACT_HOST_NOTIFICATIONS: %w{contact_name},
+      ENABLE_CONTACT_SVC_NOTIFICATIONS: %w{contact_name},
+      ENABLE_EVENT_HANDLERS: [],
+      ENABLE_FAILURE_PREDICTION: [],
+      ENABLE_FLAP_DETECTION: [],
+      ENABLE_HOSTGROUP_HOST_CHECKS: %w{hostgroup_name},
+      ENABLE_HOSTGROUP_HOST_NOTIFICATIONS: %w{hostgroup_name},
+      ENABLE_HOSTGROUP_PASSIVE_HOST_CHECKS: %w{hostgroup_name},
+      ENABLE_HOSTGROUP_PASSIVE_SVC_CHECKS: %w{hostgroup_name},
+      ENABLE_HOSTGROUP_SVC_CHECKS: %w{hostgroup_name},
+      ENABLE_HOSTGROUP_SVC_NOTIFICATIONS: %w{hostgroup_name},
+      ENABLE_HOST_AND_CHILD_NOTIFICATIONS: %w{host_name},
+      ENABLE_HOST_CHECK: %w{host_name},
+      ENABLE_HOST_EVENT_HANDLER: %w{host_name},
+      ENABLE_HOST_FLAP_DETECTION: %w{host_name},
+      ENABLE_HOST_FRESHNESS_CHECKS: [],
+      ENABLE_HOST_NOTIFICATIONS: %w{host_name},
+      ENABLE_HOST_SVC_CHECKS: %w{host_name},
+      ENABLE_HOST_SVC_NOTIFICATIONS: %w{host_name},
+      ENABLE_NOTIFICATIONS: [],
+      ENABLE_PASSIVE_HOST_CHECKS: %w{host_name},
+      ENABLE_PASSIVE_SVC_CHECKS: %w{host_name service_description},
+      ENABLE_PERFORMANCE_DATA: [],
+      ENABLE_SERVICEGROUP_HOST_CHECKS: %w{servicegroup_name},
+      ENABLE_SERVICEGROUP_HOST_NOTIFICATIONS: %w{servicegroup_name},
+      ENABLE_SERVICEGROUP_PASSIVE_HOST_CHECKS: %w{servicegroup_name},
+      ENABLE_SERVICEGROUP_PASSIVE_SVC_CHECKS: %w{servicegroup_name},
+      ENABLE_SERVICEGROUP_SVC_CHECKS: %w{servicegroup_name},
+      ENABLE_SERVICEGROUP_SVC_NOTIFICATIONS: %w{servicegroup_name},
+      ENABLE_SERVICE_FRESHNESS_CHECKS: [],
+      ENABLE_SVC_CHECK: %w{host_name service_description},
+      ENABLE_SVC_EVENT_HANDLER: %w{host_name service_description},
+      ENABLE_SVC_FLAP_DETECTION: %w{host_name service_description},
+      ENABLE_SVC_NOTIFICATIONS: %w{host_name service_description},
+      PROCESS_FILE: %w{file_name delete},
+      PROCESS_HOST_CHECK_RESULT: %w{host_name status_code plugin_output},
+      PROCESS_SERVICE_CHECK_RESULT: %w{host_name service_description return_code plugin_output},
+      READ_STATE_INFORMATION: [],
+      REMOVE_HOST_ACKNOWLEDGEMENT: %w{host_name},
+      REMOVE_SVC_ACKNOWLEDGEMENT: %w{host_name service_description},
+      RESTART_PROGRAM: [],
+      SAVE_STATE_INFORMATION: [],
+      SCHEDULE_AND_PROPAGATE_HOST_DOWNTIME: %w{host_name start_time end_time fixed trigger_id duration author comment},
+      SCHEDULE_AND_PROPAGATE_TRIGGERED_HOST_DOWNTIME: %w{host_name start_time end_time fixed trigger_id duration author comment},
+      SCHEDULE_FORCED_HOST_CHECK: %w{host_name check_time},
+      SCHEDULE_FORCED_HOST_SVC_CHECKS: %w{host_name check_time},
+      SCHEDULE_FORCED_SVC_CHECK: %w{host_name service_description check_time},
+      SCHEDULE_HOSTGROUP_HOST_DOWNTIME: %w{hostgroup_name start_time end_time fixed trigger_id duration author comment},
+      SCHEDULE_HOSTGROUP_SVC_DOWNTIME: %w{hostgroup_name start_time end_time fixed trigger_id duration author comment},
+      SCHEDULE_HOST_CHECK: %w{host_name check_time},
+      SCHEDULE_HOST_DOWNTIME: %w{host_name start_time end_time fixed trigger_id duration author comment},
+      SCHEDULE_HOST_SVC_CHECKS: %w{host_name check_time},
+      SCHEDULE_HOST_SVC_DOWNTIME: %w{host_name start_time end_time fixed trigger_id duration author comment},
+      SCHEDULE_SERVICEGROUP_HOST_DOWNTIME: %w{servicegroup_name start_time end_time fixed trigger_id duration author comment},
+      SCHEDULE_SERVICEGROUP_SVC_DOWNTIME: %w{servicegroup_name start_time end_time fixed trigger_id duration author comment},
+      SCHEDULE_SVC_CHECK: %w{host_name service_description check_time},
+      SCHEDULE_SVC_DOWNTIME: %w{host_name service_desription start_time end_time fixed trigger_id duration author comment},
+      SEND_CUSTOM_HOST_NOTIFICATION: %w{host_name options author comment},
+      SEND_CUSTOM_SVC_NOTIFICATION: %w{host_name service_description options author comment},
+      SET_HOST_NOTIFICATION_NUMBER: %w{host_name notification_number},
+      SET_SVC_NOTIFICATION_NUMBER: %w{host_name service_description notification_number},
+      SHUTDOWN_PROGRAM: [],
+      START_ACCEPTING_PASSIVE_HOST_CHECKS: [],
+      START_ACCEPTING_PASSIVE_SVC_CHECKS: [],
+      START_EXECUTING_HOST_CHECKS: [],
+      START_EXECUTING_SVC_CHECKS: [],
+      START_OBSESSING_OVER_HOST: %w{host_name},
+      START_OBSESSING_OVER_HOST_CHECKS: [],
+      START_OBSESSING_OVER_SVC: %w{host_name service_description},
+      START_OBSESSING_OVER_SVC_CHECKS: [],
+      STOP_ACCEPTING_PASSIVE_HOST_CHECKS: [],
+      STOP_ACCEPTING_PASSIVE_SVC_CHECKS: [],
+      STOP_EXECUTING_HOST_CHECKS: [],
+      STOP_EXECUTING_SVC_CHECKS: [],
+      STOP_OBSESSING_OVER_HOST: %w{host_name},
+      STOP_OBSESSING_OVER_HOST_CHECKS: [],
+      STOP_OBSESSING_OVER_SVC: %w{host_name service_description},
+      STOP_OBSESSING_OVER_SVC_CHECKS: []
+    }.freeze
+  end
+end
+

data/lib/nagios/external_commands.rb

@@ -0,0 +1,142 @@
+module Nagios
+
+
+  # Class Nagios::ExternalCommands is class implementing sending
+  # commands to external commands file in Nagios.
+  #
+  # From nagios.cfg file:
+  #
+  # This is the file that Nagios checks for external command requests.
+  # It is also where the command CGI will write commands that are
+  # submitted by users, so it must be writable by the user that the
+  # web server is running as (usually 'nobody').
+  #
+  # == Usage
+  #
+  #     command = Nagios::ExternalCommands.new Nagios::Config.new.parse.command_file
+  #
+  #     command.write :action => :PROCESS_HOST_CHECK_RESULT, 
+  #       :host_name  => 'myhost', :status_code => 0, :plugin_output => "PING command OK"
+  #
+  class ExternalCommands
+
+    require 'erb'
+    require_relative 'external_commands/list'
+
+    # Constructor for the external command write class.
+    #
+    # @param [String] path Full UNIX path to external command file
+    #
+    # == Example
+    #
+    #     >> cmd = Nagios::ExternalCommands.new('/var/nagios/rw/nagios.cmd')
+    #
+    def initialize path
+      raise ArgumentError, "External command file name must be provided" unless path
+      raise RuntimeError,  "External command directory holding file #{path} is not writable by this user." unless File.writable? File.dirname path
+      
+      @path = path
+    end
+
+    attr_reader :path
+    
+    # Action to write: one of the keys listed in
+    # ::Nagios::ExternalCommands::ACTIONS hash.
+    attr_accessor :action
+    
+    # Time-stamp - usually time when write is performed, but can be
+    # overridden by params[:ts] in constructor. If given as argument
+    # for constructor it should be String of the format:
+    # Time.to_i.to_s (i.e number of seconds since epoch).
+    attr_accessor :ts
+
+    # TODO: make int dynamically later with:
+    # >> Nagios::ExternalCommands::ACTIONS.values.flatten.uniq
+    # This returns full list of Nagios variables used in external commands
+    #
+
+    # Nagios variable used in external command
+    attr_accessor :host_name, :sticky, :notify, :persistent, :author,
+    :comment, :service_description, :contact_name,
+    :notification_timeperiod, :value, :varname, :varvalue,
+    :event_handler_command, :check_command, :timeperiod,
+    :check_attempts, :check_interval, :check_timeperiod,
+    :notification_time, :comment_id, :downtime_id, :contactgroup_name,
+    :hostgroup_name, :servicegroup_name, :file_name, :delete,
+    :status_code, :plugin_output, :return_code, :start_time,
+    :end_time, :fixed, :trigger_id, :duration, :check_time,
+    :service_desription, :start_time, :options, :notification_number
+
+    # Get private binding to use with ERB bindings.
+    def get_binding
+      binding()
+    end
+
+    # Send command to Nagios. Prints formatted string to external command file (pipe).
+    #
+    # @param [Hash or Array] data Data to write to command file pipe. Must
+    #     include :action and all additional variables
+    def write data
+      case data
+      when Hash then data = [data]
+      else 
+        return { :result => false, :data => "Input data type #{data.class} is not supproted." }
+      end
+
+      result, output = true, []
+
+      data.each do |params|
+        
+        messages = []
+
+        if params.has_key? :action
+          messages << "ArgumentError: Action name #{params[:action]} is not implemented" unless ACTIONS.keys.include? params[:action]
+        else
+          messages << "ArgumentError: Action name must be provided"
+        end
+        
+        # It makes sense to continue only if checks above did not fail
+        if messages.empty?
+          #
+          # Clear all attributes first - so no old data left
+          #
+          ACTIONS.values.flatten.uniq.each do |att|
+            self.instance_variable_set "@#{att}", nil
+          end
+          #
+          # And set it to param's value
+          #
+          params.each { |k,v| self.instance_variable_set "@#{k}", v }
+          #
+          # Check that all variable that are used in the template are
+          # actually set, not nil's
+          #
+          ACTIONS[@action].each do |var|
+            messages << "ArgumentError, Parameter :#{var} is required, cannot be nil"  if self.instance_variable_get("@#{var}").nil?
+          end
+          
+          # Try to write to file only if none of the above failed
+          if messages.empty?
+            self.ts = params[:ts] || Time.now.to_i.to_s
+            
+            format = "[#{ts}] " << ([self.action.to_s] + ACTIONS[self.action].map {|x| "<%= #{x} %>" }).join(';')
+            
+            begin
+              File.open(path, 'a') do |pipe|
+                pipe.puts ERB.new(format).result(self.get_binding)
+                pipe.close
+              end
+            rescue e
+              messages << e.message
+            end
+          end
+        end
+        
+        output << { data: params, result: messages.empty? , messages: messages }
+      end # data.each
+
+      { result: result, data: output }
+    end # def write
+  end
+end
+