sermont 0.3.3

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,6 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+nbproject

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Nugroho Herucahyono
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,79 @@
+= sermont
+
+* http://github.com/xinuc/sermont
+
+== DESCRIPTION:
+
+Sermont is a command line based script to monitor your servers.
+
+== SYNOPSIS:
+
+type the command in your terminal.
+
+  sermont [options]
+
+=== Options:
+
+  --setup               : copy example config file to your home directory
+  -r,  --raw            : print the report without colors
+  -t TIME, --time TIME  : checking every TIME seconds
+  -o FILE, --output FILE: write the report to the FILE
+  -l, --last            : log only the last report
+  -d, --daemon          : running as a daemon
+  -h, --help            : print this help
+  -v, --version         : print sermont version
+
+=== Example:
+
+  sermont -r -o /var/log/sermont.log -d -t 1800
+
+== REQUIREMENTS:
+
+* term-ansicolor
+* daemons
+
+== INSTALL:
+
+install term-ansicolor & daemons gem if you haven't
+
+  sudo gem install term-ansicolor
+  sudo gem install daemons
+
+install xinuc-sermont from github.com
+
+  sudo gem install xinuc-sermont --source=http://gems.github.com
+
+Run
+
+  sermont --setup
+
+it will copy .sermont.yml to your home directory. Edit this file according to
+your servers.
+
+  ---
+  - servername: Your server name
+    ip: 127.0.0.1
+    services:
+      ftp: 21
+      http: 80
+
+Now, you can run <code>sermont</code> to monitor your servers.
+
+== Add Your Own Handler
+
+If you have any services that can't be checked by simply open the port, you can
+add you own service handler. As an example, if you want to check 'weird' service by
+your own method, you can create a file name "weird.rb" under YOUR_HOME_DIR/.sermont/
+Then, the file should be like :
+
+  # file: weird.rb
+
+  def weird(host, port)
+    # your own checking algorithm
+    # this method should return true if the service is running
+    # and false if the service is stopped.
+  end
+
+== Copyright
+
+Copyright (c) 2009 Nugroho Herucahyono. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,61 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "sermont"
+    gem.summary = "Server Monitor"
+    gem.description = "Sermont is a command line based script to monitor your servers."
+    gem.email = "xinuc@xinuc.org"
+    gem.homepage = "http://github.com/xinuc/sermont"
+    gem.authors = ["Nugroho Herucahyono"]
+    gem.add_dependency("daemons", ">= 1.0.10")
+    gem.add_dependency("term-ansicolor", ">= 1.0.3")
+    gem.executables = ["sermont"]
+    gem.default_executable = "sermont"
+    gem.rubyforge_project = "indofaker"
+  end
+
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "sermont #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:minor: 3
+:patch: 1
+:major: 0

data/bin/sermont

@@ -0,0 +1,57 @@
+#!/usr/bin/env ruby
+
+require 'rubygems'
+require 'sermont'
+require 'fileutils'
+require 'yaml'
+
+if ARGV.empty?
+  Sermont.new.run
+elsif ARGV.include?("--help") || ARGV.include?("-h")
+  help = <<-HELP
+Usage: sermont [options]
+Options:
+
+  --setup               : copy example config file to your home directory
+  -r,  --raw            : print the report without colors
+  -t TIME, --time TIME  : checking every TIME seconds
+  -o FILE, --output FILE: write the report to the FILE
+  -l, --last            : log only the last report
+  -d, --daemon          : running as a daemon
+  -h, --help            : print this help
+  -v, --version         : print sermont version
+
+Example:
+
+  sermont -r -o /var/log/sermont.log -d -t 1800
+
+Sermont by xinuc, http://github.com/xinuc/sermont
+  HELP
+  
+  puts(help)
+elsif ARGV.include?("--version") || ARGV.include?("-v")
+  config = YAML.load(File.read(File.dirname(__FILE__) + '/../' + 'VERSION.yml'))
+  version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  puts "Sermont : version #{version}"
+  puts "Sermont by xinuc, http://github.com/xinuc/sermont"
+elsif ARGV.include?("--setup")
+  FileUtils.cp(File.expand_path(File.dirname(__FILE__) + "/../lib/config/sermont.yaml"), File.expand_path("~/.sermont.yml"))
+  FileUtils.mkdir(File.expand_path("~/.sermont")) unless File.exists?(File.expand_path("~/.sermont"))
+  puts "Creating #{File.expand_path("~/.sermont")} directory."
+  puts "Copying .sermont.yml to your home directory."
+  puts "Please edit this file according to your servers."
+else
+  raw, time, out, daemon = nil
+  raw = ARGV.include?("--raw") || ARGV.include?("-r")
+  if ARGV.include?("-t")  || ARGV.include?("--time")
+    t_index = ARGV.index("-t") || ARGV.index("--time")
+    time = ARGV[t_index + 1]
+  end
+  if ARGV.include?("-o") || ARGV.include?("--output")
+    o_index = ARGV.index("-o") || ARGV.index("--output")
+    out = ARGV[o_index + 1]
+  end
+  daemon = ARGV.include?("--daemon") || ARGV.include?("-d")
+  last = ARGV.include?("--last") || ARGV.include?("-l")
+  Sermont.new.run(raw, time, out, daemon, last)
+end

data/lib/config/sermont.yaml

@@ -0,0 +1,18 @@
+# Add your servers informations here
+# the informations consist of :
+#   - servername: the name of the server
+#   - ip: ip address of your server
+#   - services: all the services of your server, consists of the name and the port
+# see the examples below.
+--- 
+- servername: My Server
+  ip: 127.0.0.1
+  services: 
+    ftp: 21
+    http: 80
+- servername: Yet Another Server
+  ip: 127.0.0.2
+  services: 
+    ftp: 21
+    http: 80
+    ssh: 22

data/lib/handler/ftp.rb

@@ -0,0 +1,7 @@
+module Handler
+
+  def ftp(host, port)
+    open_port(host, port)
+  end
+
+end

data/lib/handler/http.rb

@@ -0,0 +1,7 @@
+module Handler
+
+  def http(host, port)
+    open_port(host, port)
+  end
+
+end

data/lib/handler/mysql.rb

@@ -0,0 +1,7 @@
+module Handler
+
+  def mysql(host, port)
+    open_port(host, port)
+  end
+
+end

data/lib/handler/open_port.rb

@@ -0,0 +1,13 @@
+require 'socket'
+
+module Handler
+
+  def open_port(host, port)
+    s = TCPSocket.open(host, port)
+    s.close
+    true
+  rescue Exception
+    false
+  end
+  
+end

data/lib/handler/ping.rb

@@ -0,0 +1,9 @@
+require 'ping'
+
+module Handler
+
+  def ping(host)
+    Ping::pingecho(host, 5)
+  end
+  
+end

data/lib/sermont.rb

@@ -0,0 +1,156 @@
+require "rubygems"
+require "yaml"
+require "fileutils"
+begin
+  require "term/ansicolor"
+rescue LoadError
+end
+
+begin
+  require "daemons"
+rescue LoadError
+end
+
+Dir[File.dirname(__FILE__) + '/handler/*.rb'].each{|h| require h}
+
+class Sermont
+  
+  include Handler
+  begin
+    include Daemonize
+  rescue NameError
+  end
+  begin
+    include Term::ANSIColor
+  rescue NameError
+  end
+
+  W = 80
+
+  req_dir = File.expand_path("~/.sermont")
+  Dir[req_dir + '/*.rb'].each{|h| require h} if File.exists? req_dir
+
+  def initialize
+    @raw = !(defined?(Term::ANSIColor) && self.is_a?(Term::ANSIColor))
+    @can_daemon = defined?(Daemonize) && self.is_a?(Daemonize)
+  end
+
+  def load_setup
+    config_file = File.expand_path("~/.sermont.yml")
+    unless File.exists?(config_file) && @servers = YAML.load(IO.read(config_file))
+      puts "Config file .sermont.yml doesn't exists or invalid."
+      puts "Run  'sermont --setup' to create example config file in your home directory"
+      exit
+    end
+  end
+
+  def run(raw = nil, time = nil, output = nil, daemon = nil, last = nil)
+    load_setup
+    @raw = @raw || raw
+    unless time
+      output ? add_to_output(report, output, last) : print(report)
+    else
+      if daemon && @can_daemon && output
+        pwd = Dir.pwd
+        daemonize
+        Dir.chdir pwd
+      end
+      loop do
+        output ? add_to_output(report, output, last) : print(report)
+        begin
+          sleep time.to_i
+        rescue Exception
+          exit
+        end
+      end
+    end
+  end
+
+  def add_to_output(out, file, last)
+    File.open(file, last ? "wb" : "ab") do |f|
+      f << out
+    end
+  end
+
+  def report
+    report = notification(Time.now.to_s)
+    @servers.each do |server|
+      servername = server["servername"]
+      ip = server["ip"]
+      report << handle_host(servername, ip)
+      services = server["services"]
+      services.each do |k, v|
+        report << handle_service(k, ip, v)
+      end
+    end
+    report
+  end
+
+  def notification(notif)
+    if @raw
+      notif + whitespace(notif) + "\n"
+    else
+      on_black + dark + notif + whitespace(notif) + clear + "\n"
+    end
+  end
+
+  def whitespace(str)
+    spaces = W - str.size
+    w = ""
+    spaces.times {w << " "}
+    w
+  end
+
+  def dotspace(str, f_indent, b_indent)
+    spaces = W - 4 - str.size - f_indent - b_indent
+    w = ""
+    spaces.times {w << "."}
+    w
+  end
+
+  def host_str(hostname)
+    if @raw
+      "#{hostname} is " + dotspace(hostname, 0, 10)
+    else
+      on_yellow + black + bold + "#{hostname} is " + dotspace(hostname, 0, 10) + clear
+    end
+  end
+
+  def host_status(alive)
+    if alive
+      @raw ? "Alive     \n" : bold + on_green + white + "Alive     " + clear + "\n"
+    else
+      @raw ? "In Trouble\n" : bold + on_red + white + "In Trouble" + clear + "\n"
+    end
+  end
+
+  def handle_host(servername, ip)
+    host_str(servername) + host_status(self.ping(ip))
+  end
+
+  def service_str(service)
+    if @raw
+      "     #{service} is " + dotspace(service, 5, 10)
+    else
+      on_blue + yellow + bold + "     #{service} is " + dotspace(service, 5, 10) + clear
+    end
+  end
+
+  def service_status(running)
+    if running
+      @raw ? "Running   \n" : bold + on_green + white + "Running   " + clear + "\n"
+    else
+      @raw ? "Stopped   \n" : bold + on_red + white + "Stopped   " + clear + "\n"
+    end
+  end
+
+  def handle_service(handler, ip, port)
+    running = begin
+      self.send(handler, ip, port)
+    rescue NoMethodError
+      self.open_port(ip, port)
+    end
+    service_str(handler) + service_status(running)
+  end
+  
+end

data/sermont.gemspec

@@ -0,0 +1,64 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{sermont}
+  s.version = "0.3.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Nugroho Herucahyono"]
+  s.date = %q{2009-06-10}
+  s.default_executable = %q{sermont}
+  s.description = %q{Sermont is a command line based script to monitor your servers.}
+  s.email = %q{xinuc@xinuc.org}
+  s.executables = ["sermont"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION.yml",
+     "bin/sermont",
+     "lib/config/sermont.yaml",
+     "lib/handler/ftp.rb",
+     "lib/handler/http.rb",
+     "lib/handler/mysql.rb",
+     "lib/handler/open_port.rb",
+     "lib/handler/ping.rb",
+     "lib/sermont.rb",
+     "sermont.gemspec",
+     "spec/sermont.yaml",
+     "spec/sermont_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/xinuc/sermont}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{indofaker}
+  s.rubygems_version = %q{1.3.4}
+  s.summary = %q{Server Monitor}
+  s.test_files = [
+    "spec/sermont_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<daemons>, [">= 1.0.10"])
+      s.add_runtime_dependency(%q<term-ansicolor>, [">= 1.0.3"])
+    else
+      s.add_dependency(%q<daemons>, [">= 1.0.10"])
+      s.add_dependency(%q<term-ansicolor>, [">= 1.0.3"])
+    end
+  else
+    s.add_dependency(%q<daemons>, [">= 1.0.10"])
+    s.add_dependency(%q<term-ansicolor>, [">= 1.0.3"])
+  end
+end

data/spec/sermont.yaml

@@ -0,0 +1,18 @@
+# Add your servers informations here
+# the informations consist of :
+#   - servername: the name of the server
+#   - ip: ip address of your server
+#   - services: all the services of your server, consists of the name and the port
+# see the examples below.
+--- 
+- servername: My Server
+  ip: 127.0.0.1
+  services: 
+    ftp: 21
+    http: 80
+- servername: Yet Another Server
+  ip: 127.0.0.2
+  services: 
+    ftp: 21
+    http: 80
+    ssh: 22

data/spec/sermont_spec.rb

@@ -0,0 +1,70 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Sermont do
+  include Term::ANSIColor
+  
+  before(:each) do
+    @sermont = Sermont.new
+  end
+
+  it "should include some modules" do
+    Sermont.should include(Handler)
+    Sermont.should include(Daemonize)
+    Sermont.should include(Term::ANSIColor)
+  end
+
+  it "should set raw to true if can include ansicolor" do
+    @sermont.instance_variable_get("@raw").should == false
+    @sermont.instance_variable_get("@can_daemon").should == true
+  end
+
+  it "should load servers correctly" do
+    File.stubs(:expand_path).with("~/.sermont.yml").returns(File.dirname(__FILE__) + "/sermont.yaml")
+    @sermont.load_setup
+    servers = @sermont.instance_variable_get("@servers")
+    servers.should_not be_nil
+    servers.should ==  [{"servername"=>"My Server", "ip"=>"127.0.0.1", "services"=>{"ftp"=>21, "http"=>80}}, {"servername"=>"Yet Another Server", "ip"=>"127.0.0.2", "services"=>{"ftp"=>21, "ssh"=>22, "http"=>80}}]
+  end
+
+  it "should exit if config not found" do
+    File.stubs(:exists?).with(File.expand_path("~/.sermont.yml")).returns false
+    @sermont.stubs(:exit).returns("EXIT")
+    @sermont.load_setup.should == "EXIT"
+  end
+
+  it "should has notification of 81 chars in raw" do
+    @sermont.instance_variable_set("@raw", true)
+    @sermont.notification("some notif").size.should == 81
+  end
+  
+  it "should has host str of 70 chars in raw" do
+    @sermont.instance_variable_set("@raw", true)
+    @sermont.host_str("some host").size.should == 70
+  end
+  
+  it "should has service str of 70 chars in raw" do
+    @sermont.instance_variable_set("@raw", true)
+    @sermont.service_str("some service").size.should == 70
+  end
+  
+  it "should has status of 11 chars in raw" do
+    @sermont.instance_variable_set("@raw", true)
+    @sermont.service_status(true).size.should == 11
+    @sermont.service_status(false).size.should == 11
+    @sermont.host_status(true).size.should == 11
+    @sermont.host_status(false).size.should == 11
+  end
+
+  it "should has handle host of 81 chars in raw" do
+    @sermont.instance_variable_set("@raw", true)
+    @sermont.handle_host("this localhost", "127.0.0.1").size.should == 81
+    @sermont.handle_host("some weird host", "167.0.0.1").size.should == 81
+  end
+  
+  it "should has handle service of 81 chars in raw" do
+    @sermont.instance_variable_set("@raw", true)
+    @sermont.handle_service("http", "127.0.0.1", 80).size.should == 81
+    @sermont.handle_service("ldap", "127.0.0.1", 2000).size.should == 81
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift File.dirname(__FILE__) + '/../lib'
+require 'rubygems'
+require 'spec'
+require 'mocha'
+require 'sermont'
+
+Spec::Runner.configure do |config|
+  config.mock_with :mocha
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification 
+name: sermont
+version: !ruby/object:Gem::Version 
+  version: 0.3.3
+platform: ruby
+authors: 
+- Nugroho Herucahyono
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-06-10 00:00:00 +07:00
+default_executable: sermont
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: daemons
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.10
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: term-ansicolor
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.3
+    version: 
+description: Sermont is a command line based script to monitor your servers.
+email: xinuc@xinuc.org
+executables: 
+- sermont
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- bin/sermont
+- lib/config/sermont.yaml
+- lib/handler/ftp.rb
+- lib/handler/http.rb
+- lib/handler/mysql.rb
+- lib/handler/open_port.rb
+- lib/handler/ping.rb
+- lib/sermont.rb
+- sermont.gemspec
+- spec/sermont.yaml
+- spec/sermont_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/xinuc/sermont
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: indofaker
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Server Monitor
+test_files: 
+- spec/sermont_spec.rb
+- spec/spec_helper.rb