astroboa-cli 0.3.0

data/lib/astroboa-cli/command/service.rb

@@ -0,0 +1,224 @@
+# encoding: UTF-8
+
+require 'astroboa-cli/command/base'
+require 'rbconfig'
+
+# setup astroboa as a system service (daemon) that automatically starts on boot
+class AstroboaCLI::Command::Service < AstroboaCLI::Command::Base
+
+  LAUNCHD_CONFIG = '/Library/LaunchDaemons/com.betaconcept.astroboa.plist'
+  
+  # service:setup
+  #
+  # Setups astroboa as a system service (daemon). 
+  # It requires that you have already installed astroboa using 'astroboa-cli server:install'.
+  # Astroboa service will automatically start on system boot. 
+  #
+  # To start and stop astroboa when it is installed as a system service use 'astroboa-cli service:start' and 'astroboa-cli service:stop'
+  #
+  # IMPORTANT NOTICE:
+  # When astroboa runs as a service the internallly installed JRUBY version and GEMS are used instead of the JRUBY used to run astroboa-cli.
+  # When astroboa is started through 'server:start' command, the same JRUBY version and GEMS used by astroboa-cli will be used.
+  # This behaviour shields the production server from the ruby setup that the astroboa-cli user might have and even allows to test newer ruby versions and gems
+  # during development (run astroboa with server:start) and use more stable ones during production (setup astroboa as a service and run it through service:start).
+  #
+  # In MAC OS X astroboa is setup as a system launchd daemon.
+  # Therefore, you must be authorized to use 'sudo' in order to use the 'service:setup' command.
+  # If you want to disable astroboa service from automatically running on each boot then change the 'RunAtLoad' key to 'false' in '/Library/LaunchDaemons/com.betaconcept.astroboa.plist'
+  #
+  # In linux astroboa is setup as an upstart service (requires ubuntu or debian or a linux distro that supports upstart)
+  #
+  def setup
+    error "Astroboa is running. Please first stop astoboa using 'astroboa-cli server:stop' and run the command again" if astroboa_running?
+    install_launchd_service if mac_os_x?
+    install_upstart_service if linux?
+    display "We do not yet support installing astroboa as a service in windows" if windows?
+  end
+  
+  # service:unset
+  #
+  # unsets astroboa from being a system service (daemon). 
+  #
+  # In MAC OS X it will unload astroboa from launchd and then remove astroboa from the list of system daemons (those that are loaded everytime the system boots).
+  #
+  # In LINUX it will unconfigure astroboa as an upstart service
+  #
+  def unset
+    error "Astroboa is running. Please first stop astoboa using 'astroboa-cli service:stop' and run the command again" if astroboa_running?
+    unset_launchd_service if mac_os_x?
+    unset_upstart_service if linux?
+    display "We do not yet support installing astroboa as a service in windows" if windows?
+  end
+  
+  
+  # service:start
+  #
+  # Starts astroboa service
+  #
+  # To install astroboa as a system service you should run 'astroboa-cli service:setup'
+  #
+  # In MAC OS X you may also start the service by running: 'launchctl start com.betaconcept.astroboa'
+  #
+  # In Linux you may also start the service by running: 'service astroboa start'
+  #
+  def start
+    error "Astroboa is already running" if astroboa_running?
+    start_launchd_service if mac_os_x?
+  end
+  
+  # service:stop
+  #
+  # Stops astroboa service
+  #
+  # To setup astroboa as a system service you should run 'astroboa-cli service:setup'
+  # 
+  # In MAC OS X you may also stop the service by running: 'launchctl unload /Library/LaunchDaemons/com.betaconcept.astroboa.plist'
+  # DO NOT use 'launchctl stop com.betaconcept.astroboa' because launchd will keep restarting the service.
+  # If you use 'launchctl unload /Library/LaunchDaemons/com.betaconcept.astroboa.plist' to stop the service then you may restart it by using 
+  # astroboa-cli service:start or run 'launchctl load /Library/LaunchDaemons/com.betaconcept.astroboa.plist' and then 'launchctl start com.betaconcept.astroboa'
+  # In any case we recommend to use the commands provided by astroboa-cli that do all the necessary checks and remove the launchd complexity! 
+  # 
+  # In Linux you may also stop the service by running: 'service astroboa stop'
+  #
+  def stop
+    error "Astroboa is not running" unless astroboa_running?
+    stop_launchd_service if mac_os_x?
+  end
+  
+  # service:check
+  #
+  # checks if astroboa is setup as a system service and whether astroboa service is running
+  #
+  def check
+    check_launchd_service if mac_os_x?
+    display "We do not yet support checking the status of astroboa service in linux and windows" if windows? || linux?
+  end
+
+private
+
+  def install_launchd_service
+    server_configuration = get_server_configuration
+    astroboa_dir = server_configuration['install_dir']
+    temp_launchd_config = File.join(astroboa_dir, 'com.betaconcept.astroboa.plist')
+    log_file = File.join(astroboa_dir, 'torquebox', 'jboss', 'standalone', 'log', 'server.log')
+    
+    unless launchd_service_configured?
+      uid = File.stat(astroboa_dir).uid
+      astroboa_user = Etc.getpwuid(uid).name
+      launchd_config_template = File.join(astroboa_dir, 'astroboa-setup-templates', 'AstroboaDaemon.plist.template')
+      context = {:astroboa_dir => astroboa_dir, :java_home => ENV['JAVA_HOME'], :jruby_home => File.join(server_configuration['install_dir'], 'torquebox', 'jruby'), :astroboa_user => astroboa_user}
+      render_template_to_file(launchd_config_template, context, temp_launchd_config)
+      error "Failed to copy launchd config file to #{LAUNCHD_CONFIG}" unless process_os_command "sudo cp #{temp_launchd_config} #{LAUNCHD_CONFIG}"
+      error "Failed to remove temporary launchd config file #{temp_launchd_config}" unless process_os_command "rm #{temp_launchd_config}"
+      display "Generating launchd config file '#{LAUNCHD_CONFIG}': OK"
+    end
+    
+    unless launchd_service_loaded?
+      load_launchd_service
+      return
+    end
+    
+    display "Astroboa service is already configured as a service. Use 'astroboa-cli service:check' to check the service status, use 'astroboa-cli service:start' and 'astroboa-cli service:stop' to start and stop astroboa service"
+    # FileUtils.mkdir_p log_dir, :mode => 0755 unless File.exists? log_dir
+  end
+  
+  def load_launchd_service
+    error "Failed to load astroboa service to launchd" unless process_os_command "launchctl load #{LAUNCHD_CONFIG}"
+    display "Load astroboa service to launchd: OK"
+    display "Checking proper service load..."
+    error "Failed to load astroboa as a service" unless launchd_service_loaded?
+    display "astroboa service properly loaded: OK"
+    display "astroboa service is now starting...You can check the log file with 'tail -f #{log_file}'"
+    display "If you want to STOP THE SERVICE use 'astroboa-cli service:stop'. To START THE SERVICE again use 'astroboa-cli service:start'. "
+    display "ATTENTION!!! astroboa service will automatically start every time your MAC starts."
+    display "If you want to disable astroboa service from automatically running on each boot then change the 'RunAtLoad' key to false in '/Library/LaunchAgents/com.betaconcept.astroboa.plist'"
+  end
+  
+  def launchd_service_configured?
+    
+    unless File.exist?(LAUNCHD_CONFIG)
+      display "#{LAUNCHD_CONFIG} not installed"
+      return false
+    end
+    
+    display "launchd config script '#{LAUNCHD_CONFIG}': OK"
+    return true
+  end
+  
+  
+  def launchd_service_loaded?
+    unless system 'launchctl list | grep astroboa'
+      display "Astroboa is not listed as a service in launchctl"
+      return false
+    end
+    
+    display "launchctl lists astroboa as a service: OK"
+    return true
+  end
+  
+  
+  def check_launchd_service
+    display launchd_service_configured? ? "Astroboa is configured as a system service" : 
+      "Astroboa is not configured as a service. Run 'astroboa-cli service:setup' to configure Astroboa as MAC OS X service"
+    
+    display astroboa_running? ? 'Astroboa is running' : 'Astroboa is not running'
+  end
+  
+  
+  def start_launchd_service
+    unless launchd_service_configured?
+      output_with_bang "Astroboa is not yet setup as a system service. To setup up astroboa as a service use 'astroboa-cli service:setup'"
+      output_with_bang "If you just want to start astoboa without setting it up as a service use 'astroboa-cli server:start'"
+      exit
+    end
+    
+    unless launchd_service_loaded?
+      display "astroboa service is not loaded lets loaded first"
+      load_launchd_service load_launchd_service
+      
+      # we return since service automatically starts when loaded
+      return
+    end 
+    
+    error "Failed to start astroboa service" unless process_os_command "launchctl start com.betaconcept.astroboa"
+    display "Astroboa service has been started"
+  end
+  
+  
+  def stop_launchd_service
+    # To stop the service through launchd we need to use 'launchctl unload'
+    # we cannot use 'launchctl stop' because this will cause the service to be restarted again (this is due to keepalive settings in plist file)
+    # if we use 'launchctl unload' we need to reload the plist file each time we want to start astroboa again.
+    # To avoid all this we may stop astroboa directly through jboss-cli. This causes jboss to exit with status 0 and thus launchd does not restart it (see keepalive settings in plist file)
+    # So service:stop becomes equivalent to server:stop in MAC OS X.
+    # So even if astroboa is not a service we will stop it with service:stop but we do a check and inform the user to prefer server:stop if astroboa is not setup as a service
+    
+    unless launchd_service_configured?
+      output_with_bang "We will try to stop astroboa but you should use this command to stop astroboa only if it is setup as a system service."
+      output_with_bang "Astroboa is not yet setup as a system service. To setup up astroboa as a service use 'astroboa-cli service:setup'"
+      output_with_bang "To stop astoboa when it is not setup as a service prefer to use 'astroboa-cli server:stop'"
+    end
+    
+    AstroboaCLI::Command::Server.new().stop
+    
+  end
+  
+  def unset_launchd_service
+    display "Checking that astroboa is setup as a system service..."
+    error "Astroboa is not set as a system service" unless launchd_service_configured?
+    
+    display "Checking that astroboa service is loaded..."
+    if launchd_service_loaded?
+      display "Trying to unload..."
+      error "Failed to unload astroboa service from launchd" unless process_os_command("launchctl unload #{LAUNCHD_CONFIG}") && ! launchd_service_loaded?
+      display "Astroboa service has been unloaded from launchd"
+    end
+    
+    display 'Trying to remove from system services...'
+    error "Failed to remove launchd config file '#{LAUNCHD_CONFIG}'. Check that you have sudo permission and run the command again or manually remove the plist file." unless process_os_command "sudo rm #{LAUNCHD_CONFIG}"
+    display "Astroboa has been removed from system services"
+  end
+    
+  
+end
+

data/lib/astroboa-cli/command/version.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+require "astroboa-cli/command/base"
+require "astroboa-cli/version"
+
+module AstroboaCLI::Command
+  
+  # display version
+  #
+  class Version < Base
+    
+    # version
+    #
+    # show astroboa client version
+    #
+    def default
+      display AstroboaCLI::VERSION
+    end
+  end # class Version 
+  
+end # module AstroboaCLI::Command

data/lib/astroboa-cli/command.rb

@@ -0,0 +1,158 @@
+# encoding: utf-8
+
+# This file contains modifications of work covered by the following copyright and  
+# permission notice:
+#
+# The MIT License (MIT)
+# 
+# Copyright © Heroku 2008 - 2012
+# 
+# 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.
+
+require "optparse"
+require "astroboa-cli/util"
+
+module AstroboaCLI
+  module Command
+    
+    class CommandFailed  < RuntimeError; end
+    
+    extend AstroboaCLI::Util
+    
+    def self.load
+      Dir[File.join(File.dirname(__FILE__), "command", "*.rb")].each do |file|
+        require file
+      end
+      
+      @@log_file = '/tmp/astroboa-cli-log.txt'
+      f = File.new(@@log_file, 'w+', 0644)
+      @@log = Logger.new(f)
+      @@log.level = Logger::INFO
+    end
+    
+    def self.log
+      @@log
+    end
+    
+    def self.log_file
+      @@log_file
+    end
+    
+    def self.namespaces
+      @@namespaces ||= {}
+    end
+    
+    def self.commands
+      @@commands ||= {}
+    end
+    
+    def self.current_command
+      @current_command
+    end
+
+    def self.current_args
+      @current_args
+    end
+
+    def self.current_options
+      @current_options
+    end
+    
+    def self.global_options
+      @global_options ||= []
+    end
+
+    def self.global_option(name, *args)
+      global_options << { :name => name, :args => args }
+    end
+
+    global_option :help,    "--help", "-h"
+    
+    def self.register_command(command)
+      commands[command[:command]] = command
+    end
+    
+    def self.register_namespace(namespace)
+      namespaces[namespace[:name]] = namespace
+    end
+    
+    def self.map_command_to_method(cmd, args=[])
+      command = commands[cmd]
+
+      unless command
+        if %w( -v --version ).include?(cmd)
+          display AstroboaCLI::VERSION
+          exit
+        end
+
+        output_with_bang("`#{cmd}` is not an astroboa command.")
+
+        output_with_bang("run `astroboa-cli help` to see available commands.")
+        exit 1
+      end
+
+      @current_command = cmd
+
+      opts = {}
+      invalid_options = []
+
+      parser = OptionParser.new do |parser|
+        global_options.each do |global_option|
+          parser.on(*global_option[:args]) do |value|
+            opts[global_option[:name]] = value
+          end
+        end
+        command[:options].each do |name, option|
+          parser.on("-#{option[:short]}", "--#{option[:long]}", option[:desc]) do |value|
+            opts[name.gsub("-", "_").to_sym] = value
+          end
+        end
+      end
+
+      begin
+        parser.order!(args) do |nonopt|
+          invalid_options << nonopt
+        end
+      rescue OptionParser::InvalidOption => ex
+        invalid_options << ex.args.first
+        retry
+      end
+
+      raise OptionParser::ParseError if opts[:help]
+
+      args.concat(invalid_options)
+
+      @current_args = args
+      @current_options = opts
+
+      [ command[:klass].new(args.dup, opts.dup), command[:method] ]
+    end
+
+    
+    def self.run(command, arguments=[])
+      object, method = map_command_to_method(command, arguments.dup)
+      object.send(method)
+    rescue => e
+      error "An error has occured \n#{e.inspect}\n#{e.backtrace}"
+    end
+    
+  end # module Command
+end # module AstroboaCLI
+    

data/lib/astroboa-cli/util.rb

@@ -0,0 +1,594 @@
+# encoding: utf-8
+
+require 'yaml'
+require 'zip/zip'
+require 'nokogiri'
+
+module AstroboaCLI
+  module Util
+    
+    # This code is from Sprinkle that in turn got it from Chef !!
+    class TemplateError < RuntimeError
+      attr_reader :original_exception, :context
+      SOURCE_CONTEXT_WINDOW = 2 unless defined? SOURCE_CONTEXT_WINDOW
+
+      def initialize(original_exception, template, context)
+        @original_exception, @template, @context = original_exception, template, context
+      end
+
+      def message
+        @original_exception.message
+      end
+
+      def line_number
+        @line_number ||= $1.to_i if original_exception.backtrace.find {|line| line =~ /\(erubis\):(\d+)/ }
+      end
+
+      def source_location
+        "on line ##{line_number}"
+      end
+
+      def source_listing
+        return nil if line_number.nil?
+
+        @source_listing ||= begin
+          line_index = line_number - 1
+          beginning_line = line_index <= SOURCE_CONTEXT_WINDOW ? 0 : line_index - SOURCE_CONTEXT_WINDOW
+          source_size = SOURCE_CONTEXT_WINDOW * 2 + 1
+          lines = @template.split(/\n/)
+          contextual_lines = lines[beginning_line, source_size]
+          output = []
+          contextual_lines.each_with_index do |line, index|
+            line_number = (index+beginning_line+1).to_s.rjust(3)
+            output << "#{line_number}: #{line}"
+          end
+          output.join("\n")
+        end
+      end
+
+      def to_s
+        "\n\n#{self.class} (#{message}) #{source_location}:\n\n" +
+          "#{source_listing}\n\n  #{original_exception.backtrace.join("\n  ")}\n\n"
+      end
+    end
+  
+    
+    def display(msg="", new_line=true, add_to_log=true)
+      if new_line
+        puts(msg)
+      else
+        print(msg)
+        STDOUT.flush
+      end
+      log.info msg if add_to_log
+    end
+    
+    
+    def error(msg, add_to_log=true)
+      STDERR.puts(format_with_bang(msg))
+      log.error msg if add_to_log   
+      exit 1
+    end
+    
+    
+    def fail(message)
+      raise AstroboaCLI::Command::CommandFailed, message
+    end
+    
+    
+    def format_with_bang(message)
+      return '' if message.to_s.strip == ""
+      " !    " + message.split("\n").join("\n !    ")
+    end
+    
+    
+    def output_with_bang(message="", new_line=true)
+      return if message.to_s.strip == ""
+      display(format_with_bang(message), new_line)
+    end
+    
+    
+    def ask
+      STDIN.gets.strip
+    end
+
+
+    def shell(cmd)
+      FileUtils.cd(Dir.pwd) {|d| return `#{cmd}`}
+    end
+
+
+    def longest(items)
+      items.map { |i| i.to_s.length }.sort.last
+    end
+    
+    
+    def has_executable(path)
+      # If the path includes a forward slash, we're checking
+      # an absolute path. Otherwise, we're checking a global executable
+      if path.include?('/')
+        commands = "test -x #{path}"
+      else
+        command = "[ -n \"`echo \\`which #{path}\\``\" ]"
+      end
+      process_os_command command
+    end
+
+
+    # Same as has_executable but with checking for e certain version number.
+    # If version number contains dots it, they should be escaped, e.g. "1\\.6"
+    # Last option is the parameter to append for getting the version (which
+    # defaults to "-v").
+    def has_executable_with_version(path, version, get_version = '-v')
+      if path.include?('/')
+        command = "[ -x #{path} -a -n \"`#{path} #{get_version} 2>&1 | egrep -e \\\"#{version}\\\"`\" ]"
+      else
+        command = "[ -n \"`echo \\`which #{path}\\``\" -a -n \"`\\`which #{path}\\` #{get_version} 2>&1 | egrep -e \\\"#{version}\\\"`\" ]"
+      end
+      process_os_command command
+    end
+
+
+    # Same as has_executable but checking output of a certain command
+    # with grep.
+    def has_version_in_grep(cmd, version)
+       process_os_command "[ -n \"`#{cmd} 2> /dev/null | egrep -e \\\"#{version}\\\"`\" ]"
+    end
+    
+    
+    def process_os_command(command)
+      system command
+      return false if $?.to_i != 0
+      return true
+    end
+    
+    
+    def extract_archive_command(archive_name)
+      case archive_name
+      when /(tar.gz)|(tgz)$/
+        'tar xzf'
+      when /(tar.bz2)|(tb2)$/
+        'tar xjf'
+      when /tar$/
+        'tar xf'
+      when /zip$/
+        'unzip -o -q'
+      else
+        fail "Unknown binary archive format: #{archive_name}"
+      end
+    end
+    
+    
+    def unzip_file (file, destination)
+      Zip::ZipFile.open(file) { |zip_file|
+       zip_file.each { |f|
+         next unless f.file?
+         f_path=File.join(destination, f.name)
+         FileUtils.mkdir_p(File.dirname(f_path))
+         zip_file.extract(f, f_path) unless File.exist?(f_path)
+       }
+      }
+    end
+    
+    
+    def render_template_to_file(template_path, context, file_path)
+      require 'erubis'
+
+      begin
+        template = File.read template_path
+        eruby = Erubis::Eruby.new(template)
+        File.open file_path, "w" do |f|
+          f << eruby.evaluate(context)
+        end
+      rescue Object => e
+        raise TemplateError.new(e, template, context)
+      end
+
+    end
+    
+    
+    # Delete file lines between two regular expressions, /foo/ and /bar/, including the lines
+    # that match the regular expressions, e.g. delete file lines between two comments, including the comments
+    # from_regex and to_regex should be specified without leading and trailing slashes i.e. "string_to_match" and not "/string_to_match/"
+    def delete_file_content_between_regex(filename, from_regex, to_regex)
+      from_regex_obj = %r{#{from_regex}}
+      to_regex_obj = %r{#{to_regex}}
+      found_boundary = false
+      file_lines = File.readlines(filename)
+      File.open(filename, "w") do |f|
+        file_lines.each do |line|
+          found_boundary = true if line =~ from_regex_obj
+          f.puts line unless found_boundary
+          found_boundary = false if line =~ to_regex_obj
+        end
+      end
+    end
+    
+    
+    def delete_file_lines(filename, lines_to_delete)
+      file_lines = File.readlines(filename)
+      lines_to_delete.each do |index|
+        file_lines.delete_at(index)
+      end 
+      File.open(filename, "w") do |f| 
+        f.write lines_to_delete.join
+      end
+    end
+    
+    
+    def windows?
+      RbConfig::CONFIG['host_os'] =~ /mswin/i
+    end
+
+
+    def mac_os_x?
+      RbConfig::CONFIG['host_os'] =~ /darwin/i
+    end
+    
+    
+    def linux?
+      RbConfig::CONFIG['host_os'] =~ /linux/i
+    end
+    
+    
+    def running_with_sudo?
+      Process.uid == 0
+    end
+    
+    
+    def check_if_running_with_sudo
+      display "You need sudo privileges to run this command. Checking..."
+      error <<-MSG.gsub(/^ {6}/, '') unless running_with_sudo?
+      You are not running with sudo privileges. Please run astroboa-cli with sudo
+      If you installed ruby with rbenv you need to install 'rbenv-sudo' plugin and then run 'rbenv sudo astroboa-cli <COMMAND>'
+      For 'rbenv-sudo' installation check ruby installation instructions at https://github.com/betaconcept/astroboa-cli
+      MSG
+  
+      display "Running with sudo privileges: OK"
+    end
+    
+    
+    def dir_writable?(dir)
+      until FileTest.directory?(dir)
+        dir = File.dirname(dir)
+      end
+      File.writable? dir
+    end
+    
+    
+    def gem_available?(name)
+       Gem::Specification.find_by_name(name)
+    rescue Gem::LoadError
+       false
+    rescue
+       Gem.available?(name)
+    end
+    
+    
+    def astroboa_running?
+      server_config = get_server_configuration
+      jboss_dir = File.join(server_config['install_dir'], 'torquebox', 'jboss')
+      system %(ps -ef | grep "org.jboss.as.standalone -Djboss.home.dir=#{jboss_dir}" | grep -vq grep)
+    end
+    
+        
+    def get_server_conf_file
+      return File.expand_path(File.join("~", ".astroboa-conf.yml")) if mac_os_x?
+      return File.join(File::SEPARATOR, 'etc', 'astroboa', 'astroboa-conf.yml')
+    end
+
+
+    def save_server_configuration(server_configuration)
+      File.open(get_server_conf_file, "w") do |f|
+        f.write(YAML.dump(server_configuration))
+      end
+    end
+
+
+    def get_server_configuration
+      server_conf_file = get_server_conf_file
+      return YAML.load(File.read(server_conf_file)) if File.exists? server_conf_file
+      error "Server configuration file: '#{server_conf_file}' does not exist"
+    end
+    
+    
+    def repository_in_server_config?(server_config, repo_name)
+      return server_config.has_key?('repositories') && server_config['repositories'].has_key?(repo_name)
+    end
+    
+    
+    def repository_in_repos_config?(repos_dir, repository_name)
+      astroboa_repos_config = File.join(repos_dir, "repositories-conf.xml")
+
+      repo_conf = nil
+
+      if File.exists? astroboa_repos_config
+        File.open(astroboa_repos_config, 'r') do |f|
+          repo_conf = Nokogiri::XML(f) do |config|
+            config.noblanks
+          end
+        end
+        
+        repo_nodes = repo_conf.xpath(%(//repository[@id="#{repository_name}"]))
+        return true if !repo_nodes.empty?
+      end
+
+      return false
+    end
+    
+    
+    # check that repo is consistently configured, 
+    # i.e Its directory exists AND it is specified in server configuration AND its repo config file exists
+    def repository?(server_configuration, repository_name)
+      repos_dir = server_configuration['repos_dir']
+      astroboa_dir = server_configuration['install_dir']
+      repo_dir = File.join(repos_dir, repository_name)
+      
+      return true if File.exists?(repo_dir) && repository_in_repos_config?(repos_dir, repository_name) && repository_in_server_config?(server_configuration, repository_name)
+      
+      return false;
+    end
+    
+    
+    def runs_with_jruby?
+      (defined? RUBY_ENGINE && RUBY_ENGINE == 'jruby') || RUBY_PLATFORM == "java"
+    end
+    
+    
+    def jruby_version_ok?
+      return false unless defined? JRUBY_VERSION
+
+      jruby_version_numbers = JRUBY_VERSION.split(".")
+
+      return false unless jruby_version_numbers[0].to_i == 1 && 
+        ((jruby_version_numbers[1].to_i == 6 && jruby_version_numbers[2].to_i >= 7) || jruby_version_numbers[1].to_i == 7)
+      return true
+    end
+    
+    
+    def ruby_version_ok?
+      return false unless defined? RUBY_VERSION
+
+      ruby_version_numbers = RUBY_VERSION.split(".")
+
+      return false unless ruby_version_numbers[0].to_i == 1 && ruby_version_numbers[1].to_i >= 9
+      return true
+    end
+    
+    
+    def ruby_ok?
+      ruby_installation_instructions_message =<<-RUBY_INSTALL_MESSAGE
+      You can easily install ruby with 'rbenv' or 'rvm' utility programs.
+
+      ----------------------------------
+      We recommend to install ruby using the 'rbenv' and 'ruby-build' utility commands.
+      On Mac OS X  to install 'rbenv' and 'ruby-build' using the Homebrew (http://mxcl.github.com/homebrew/) package manager do:
+        $ brew update
+        $ brew install rbenv
+        $ brew install ruby-build
+
+      To install ruby version 1.9.3-p194 do:
+        $ rbenv install 1.9.3-p194
+
+      To set the global version of Ruby to be used in all your shells do:
+        $ rbenv global 1.9.3-p194
+
+      To set ruby 1.9.3-p194 as a local per-project ruby version by writing the version name to an .rbenv-version file in the current directory do:
+
+        $ rbenv local 1.9.3-p194
+
+      To set ruby 1.9.3-p194 as the version to be used only in the current shell (sets the RBENV_VERSION environment variable in your shell) do:
+
+        $ rbenv shell 1.9.3-p194
+
+      ------------------------------- 
+      If you prefer to use 'rvm' as your ruby management utility use the following command to install it for a single user:
+
+      user$ curl -L get.rvm.io | bash -s stable 
+
+      For multi-user installation and detailed rvm installation instructions check: https://rvm.io/rvm/install/    
+
+      After 'rvm' has been installed run the following commands to install ruby 1.9.3-p194:
+      rvm install 1.9.3-p194
+      rvm use 1.9.3-p194
+      RUBY_INSTALL_MESSAGE
+
+      ruby_wrong_version_message =<<-RUBY_VERSION_MESSAGE
+      It seems that you are not running ruby 1.9.x.
+      Your current Ruby Version is: #{RUBY_VERSION} 
+      Astroboa CLI requires your ruby version to be 1.9.x (e.g. 1.9.2 or 1.9.3).
+
+      #{ruby_installation_instructions_message}
+      RUBY_VERSION_MESSAGE
+
+      error ruby_wrong_version_message unless ruby_version_ok?
+      #display "Checking if your ruby version is 1.9.x: OK"
+    end
+    
+    
+    def jruby_ok?
+      install_jruby_with_rvm_message =<<-RVM_INSTALL_MESSAGE
+      We recommend to install jruby using the "RVM" utility command
+      To install "rvm" for a single user (i.e. the user that will run astroboa-cli) login as the user and run the following command:
+
+      user$ curl -L get.rvm.io | bash -s stable 
+
+      For multi-user installation and detailed rvm installation instructions check: https://rvm.io/rvm/install/    
+
+      After RVM has been installed run the following commands to install jruby:
+      rvm install jruby-1.6.7
+      rvm use jruby-1.6.7
+      RVM_INSTALL_MESSAGE
+
+      jruby_not_running_message =<<-JRUBY_MESSAGE
+      It seems that you are not running jruby.
+      Astroboa requires jruby version 1.6.7 or above. 
+      Please install jruby version 1.6.7 or above and run the astroboa-cli command again
+
+      #{install_jruby_with_rvm_message}
+      JRUBY_MESSAGE
+
+      jruby_wrong_version_message =<<-JRUBY_VERSION_MESSAGE
+      It seems that you are not running the required jruby version
+      Your jruby version is: #{JRUBY_VERSION}
+      Astroboa requires jruby version 1.6.7 or above. 
+      Please install jruby version 1.6.7 or above and run the astroboa-cli command again
+
+      #{install_jruby_with_rvm_message}
+      JRUBY_VERSION_MESSAGE
+
+      ruby_wrong_version_message =<<-RUBY_VERSION_MESSAGE
+      It seems that you are not running jruby in 1.9 mode.
+      Your current Ruby Version is: #{RUBY_VERSION} 
+      Astroboa requires your jruby to run in 1.9 mode. 
+      To make jruby run in 1.9 mode add the following to your .bash_profile
+      export JRUBY_OPTS=--1.9 
+
+      You need to logout and login or run "source ~/.bash_profile" in order to activate this setting
+      RUBY_VERSION_MESSAGE
+
+      error jruby_not_running_message unless runs_with_jruby?
+      error jruby_wrong_version_message unless jruby_version_ok?
+      error ruby_wrong_version_message unless ruby_version_ok?
+      display "Checking if you are running jruby version 1.6.7 or above in 1.9 mode: OK"
+    end
+    
+    
+    def get_postgresql_config(server_configuration)
+      database_admin = server_configuration['database_admin']
+      database_admin_password = server_configuration['database_admin_password']
+      database_server = server_configuration['database_server']
+      return database_admin, database_admin_password, database_server
+    end
+    
+    
+    def create_postgresql_db(server_configuration, database_name)
+      database_admin, database_admin_password, database_server = get_postgresql_config(server_configuration)
+      begin
+        conn = PG.connect(
+          :host     => database_server, 
+          :port     => '5432', 
+          :dbname   => 'postgres', 
+          :user     => database_admin, 
+          :password => database_admin_password)
+
+        # check if db exists
+        res = conn.exec("SELECT COUNT(*) FROM pg_database WHERE datname=$1",[database_name])
+        unless res.entries[0]['count'] == 0
+          display "Database #{database_name} exists. You may run the command with --db_name repo_db_name to specify a different database name" 
+          raise
+        end
+
+        res = conn.exec("CREATE DATABASE $1 ENCODING 'UNICODE'", [database_name])
+        if res.result_status == PG::Result::PGRES_COMMAND_OK
+          display %(Create Postges database "#{database_name}" : OK)
+        else
+          display "Failed to create postgres database #{database_name}. The error is #{res.error_message}"
+          raise 
+        end
+      rescue PG::Error => e
+        display %(An error has occured during the creation of postgres database "#{database_name}")
+        display "The error is: #{res.error_message}" 
+        display %(The error trace is \n #{e.backtrace.join("\n")})
+        raise
+      else
+        display %(An error has occured during the creation of postgres database "#{database_name}")
+        display %(The error trace is \n #{e.backtrace.join("\n")})
+      ensure
+        conn.finish if conn && !conn.finished?
+      end
+    end
+
+
+    def drop_postgresql_db(server_configuration, database_name)
+      database_admin, database_admin_password, database_server = get_postgresql_config(server_configuration)
+      begin
+        conn = PG.connect(
+          :host     => database_server, 
+          :port     => '5432', 
+          :dbname   => 'postgres', 
+          :user     => database_admin, 
+          :password => database_admin_password)
+
+        # check if db exists
+        res = conn.exec("SELECT COUNT(*) FROM pg_database WHERE datname=$1",[database_name])
+        unless res.entries[0]['count'] == 0 
+          display "Cannot remove database #{database_name} because it does not exist"
+          raise
+        end
+
+        res = conn.exec("DROP DATABASE $1", [database_name])
+        if res.result_status == PG::Result::PGRES_COMMAND_OK
+          display %(Delete Postges database "#{database_name}" : OK)
+        else
+          display "Failed to delete postgres database #{database_name}. The error is #{res.error_message}"
+          raise 
+        end
+
+      rescue PG::Error => e
+        display %(An error has occured during the deletion of postgres database "#{database_name}")
+        display "The error is: #{res.error_message}" 
+        display %(The error trace is \n #{e.backtrace.join("\n")})
+        raise
+      else
+        display %(An error has occured during the deletion of postgres database "#{database_name}")
+        display %(The error trace is \n #{e.backtrace.join("\n")})
+      ensure
+        conn.finish if conn && !conn.finished?
+      end
+    end
+
+
+    # Not used because only works in jruby, TO BE REMOVED
+    def create_postgresql_db_with_jdbc(server_configuration, database_name, repo_dir)
+      database_admin, database_admin_password, database_server = get_postgresql_config(server_configuration)
+      begin
+        ActiveRecord::Base.establish_connection(
+          :adapter    => 'jdbcpostgresql',
+          :database   => "postgres", 
+          :username   => database_admin,
+          :password   => database_admin_password,
+          :host       => database_server, 
+          :port       => 5432)
+        ActiveRecord::Base.connection.create_database database_name, :encoding => 'unicode'
+        ActiveRecord::Base.connection.disconnect!
+        ActiveRecord::Base.remove_connection
+
+        display %(Create Postges database "#{database_name}" : OK)
+      rescue ActiveRecord::StatementInvalid => e
+        if e.message =~ /database "#{database_name}" already exists/
+          display "Database #{database_name} exists. You may run the command with --db_name repo_db_name to specify a different database name"
+        else
+          display %(An error has occured during the creation of postgres database "#{database_name}")
+          display %(The error trace is \n #{e.backtrace.join("\n")})
+        end
+
+        raise
+      end
+    end
+
+
+    # Not used because only works in jruby, TO BE REMOVED
+    def drop_postgresql_db_with_jdbc(server_configuration, database_name)
+      database_admin, database_admin_password, database_server = get_postgresql_config(server_configuration)
+      begin
+        ActiveRecord::Base.establish_connection(
+          :adapter    => 'jdbcpostgresql',
+          :database   => "postgres", 
+          :username   => database_admin,
+          :password   => database_admin_password,
+          :host       => database_server, 
+          :port       => 5432)
+        ActiveRecord::Base.connection.drop_database database_name
+        ActiveRecord::Base.connection.disconnect!
+        ActiveRecord::Base.remove_connection
+
+        display %(Delete Postges database "#{database_name}" : OK)
+      rescue ActiveRecord::StatementInvalid => e
+        display %(An error has occured during the deletion of postgres database "#{database_name}")
+        display %(The error trace is \n #{e.backtrace.join("\n")})
+        raise
+      end
+    end
+  end
+end