csd 0.1.18 → 0.2.0

data/.gitignore

@@ -24,3 +24,4 @@ pkg
 
 ## PROJECT::SPECIFIC
 drop
+edge

data/Rakefile

@@ -25,7 +25,7 @@ Jeweler::Tasks.new do |gemspec|
   gemspec.email       = "mtoday11@gmail.com"
   gemspec.homepage    = "http://github.com/csd/csd"
   gemspec.authors     = ["Technology Transfer Alliance Team"]
-  gemspec.executables = ['ai']
+  gemspec.executables = ['ai', 'ttai']
   gemspec.post_install_message = %q{
 ============================================================
 

data/VERSION

@@ -1 +1 @@
-0.1.18
+0.2.0

data/bin/ai

@@ -16,11 +16,32 @@ begin
 rescue CSD::Error::CSDError => e
   # Here we catch CSD internal errors and exit with the propriate status code
   # We output the error message only for status codes 50 and higher, because they are rather severe
-  CSD.ui.error e.message unless e.status_code <= 49
+  if e.status_code >= 50
+    CSD.ui.error e.message
+    if e.status_code < 200
+      puts
+      puts "  \e[31mPlease report bugs at:\e[0m \e[36mhttp://github.com/csd/csd/issues\e[0m"
+      puts
+    end
+  end
   exit e.status_code
 rescue Interrupt
   # Lastly, close the AI gracefully on abnormal termination
   CSD.ui.separator
   CSD.ui.info "Quitting the AI...".red
   exit 1
+rescue ScriptError => e
+  puts "\e[31m\e[5mINTERNAL SCRIPT ERROR: \e[0m\e[31m#{e}\e[0m"
+  puts
+  puts e.backtrace.join("\n")
+  puts
+  puts "  \e[31m\e[1mPlease report errors at:\e[0m \e[36mhttp://github.com/csd/csd/issues\e[0m"
+  puts
+rescue StandardError => e
+  puts "\e[31m\e[5mINTERNAL ERROR: \e[0m\e[31m#{e}\e[0m"
+  puts
+  puts e.backtrace.join("\n")
+  puts
+  puts "  \e[31m\e[1mPlease report errors at:\e[0m \e[36mhttp://github.com/csd/csd/issues\e[0m"
+  puts
 end

data/bin/ttai

@@ -0,0 +1,47 @@
+#!/usr/bin/env ruby
+
+# NOTE: If you would like to execute this file as a developer
+#       but not install the CSD gem, you can use this command:
+#       ruby -I path/to/csd/lib path/to/csd/bin/ai
+
+# First, let's load the RubyGems framework and the CSD gem.
+# Even though RubyGems is already loaded for Ruby >= 1.9,
+# we want to go sure here and load it to provide robustness
+require 'rubygems'
+require 'csd'
+
+begin
+  # Running the CSD library and telling it who started it
+  CSD.bootstrap :executable => 'ttai'
+rescue CSD::Error::CSDError => e
+  # Here we catch CSD internal errors and exit with the propriate status code
+  # We output the error message only for status codes 50 and higher, because they are rather severe
+  if e.status_code >= 50
+    CSD.ui.error e.message
+    if e.status_code < 200
+      puts
+      puts "  \e[31mPlease report bugs at:\e[0m \e[36mhttp://github.com/csd/csd/issues\e[0m"
+      puts
+    end
+  end
+  exit e.status_code
+rescue Interrupt
+  # Lastly, close the AI gracefully on abnormal termination
+  CSD.ui.separator
+  CSD.ui.info "Quitting the AI...".red
+  exit 1
+rescue ScriptError => e
+  puts "\e[31m\e[5mINTERNAL SCRIPT ERROR: \e[0m\e[31m#{e}\e[0m"
+  puts
+  puts e.backtrace.join("\n")
+  puts
+  puts "  \e[31m\e[1mPlease report errors at:\e[0m \e[36mhttp://github.com/csd/csd/issues\e[0m"
+  puts
+rescue StandardError => e
+  puts "\e[31m\e[5mINTERNAL ERROR: \e[0m\e[31m#{e}\e[0m"
+  puts
+  puts e.backtrace.join("\n")
+  puts
+  puts "  \e[31m\e[1mPlease report errors at:\e[0m \e[36mhttp://github.com/csd/csd/issues\e[0m"
+  puts
+end

data/csd.gemspec

@@ -5,15 +5,14 @@
 
 Gem::Specification.new do |s|
   s.name = %q{csd}
-  s.version = "0.1.18"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Technology Transfer Alliance Team"]
-  s.date = %q{2010-08-10}
-  s.default_executable = %q{ai}
+  s.date = %q{2010-08-25}
   s.description = %q{CSD stands for Communication Systems Design and is a project of the Telecommunication Systems Laboratory (TSLab) of the Royal Institute of Technology in Stockholm, Sweden. Within CSD many software tools are used to build up various networks and services. This gem is supposed to automate processes to handle the compilation and installation of these software tools. Technology Transfer Alliance (TTA) is the project team, which maintains this code.}
   s.email = %q{mtoday11@gmail.com}
-  s.executables = ["ai"]
+  s.executables = ["ai", "ttai"]
   s.extra_rdoc_files = [
     "README.rdoc"
   ]
@@ -25,6 +24,7 @@ Gem::Specification.new do |s|
      "Rakefile",
      "VERSION",
      "bin/ai",
+     "bin/ttai",
      "csd.gemspec",
      "lib/csd.rb",
      "lib/csd/application.rb",
@@ -34,6 +34,14 @@ Gem::Specification.new do |s|
      "lib/csd/application/decklink/options/install.rb",
      "lib/csd/application/default.rb",
      "lib/csd/application/default/base.rb",
+     "lib/csd/application/i2conf.rb",
+     "lib/csd/application/i2conf/about.yml",
+     "lib/csd/application/i2conf/base.rb",
+     "lib/csd/application/i2conf/config_example.rb",
+     "lib/csd/application/i2conf/options/common.rb",
+     "lib/csd/application/i2conf/options/common_defaults.rb",
+     "lib/csd/application/i2conf/options/install.rb",
+     "lib/csd/application/i2conf/options/install_defaults.rb",
      "lib/csd/application/minisip.rb",
      "lib/csd/application/minisip/about.yml",
      "lib/csd/application/minisip/base.rb",
@@ -42,13 +50,14 @@ Gem::Specification.new do |s|
      "lib/csd/application/minisip/component/ffmpeg.rb",
      "lib/csd/application/minisip/component/gnome.rb",
      "lib/csd/application/minisip/component/hdviper.rb",
+     "lib/csd/application/minisip/component/network.rb",
      "lib/csd/application/minisip/component/plugins.rb",
      "lib/csd/application/minisip/component/x264.rb",
      "lib/csd/application/minisip/error.rb",
      "lib/csd/application/minisip/options/common.rb",
      "lib/csd/application/minisip/options/common_defaults.rb",
-     "lib/csd/application/minisip/options/compile.rb",
-     "lib/csd/application/minisip/options/compile_defaults.rb",
+     "lib/csd/application/minisip/options/install.rb",
+     "lib/csd/application/minisip/options/install_defaults.rb",
      "lib/csd/application/minisip/options/package.rb",
      "lib/csd/application/minisip/options/package_defaults.rb",
      "lib/csd/application/minisip/phonebook_example.rb",

data/lib/csd.rb

@@ -1,4 +1,5 @@
 #-- encoding: UTF-8
+require 'net/http'
 
 # Loading all files in the subdirectory `csd´
 Dir[File.join(File.dirname(__FILE__), 'csd', '*.rb')].sort.each { |path| require "csd/#{File.basename(path, '.rb')}" }
@@ -17,26 +18,62 @@ module CSD
     def bootstrap(options={})
       @executable = options[:executable]
       Options.parse!
+      respond_to_internal_ai_options
       respond_to_incomplete_arguments
-      UI.debug "#{self}.bootstrap initializes the task #{Options.action.enquote} of the application #{Applications.current.name.to_s.enquote} now"
-      Applications.current.instance.send("#{Options.action}".to_sym)
+      UI.debug "#{self}.bootstrap initializes the task #{Options.action.to_s.enquote if Options.action} of the application #{Applications.current.name.to_s.enquote if Applications.current} now"
+      Applications.current.instance.send("#{Options.action}".to_sym) if Applications.current
     end
   
     private
-  
+    
+    def respond_to_internal_ai_options
+      if !Applications.current and ARGV.include?('update')
+        update_ai_using_rubygems
+      elsif !Applications.current and ARGV.include?('edge')
+        update_ai_to_cutting_edge
+      end
+    end
+    
+    # Updating the AI
+    #
+    def update_ai_using_rubygems
+      UI.info "Updating the AI to the newest version".green.bold
+      Cmd.run "sudo gem update csd --no-ri --no-rdoc", :announce_pwd => false, :verbose => true
+      exit!
+    end
+    
+    # This method is used to conveniently update the AI without officially publishing it on RubyGems.
+    # This can be handy when testing many things on many machines at the same time :)
+    #
+    def update_ai_to_cutting_edge
+      UI.info "Updating the AI to the cutting-edge experimental version".green.bold
+      # Create a temporary working directory
+      Path.edge_tmp = Dir.mktmpdir
+      Path.edge_file = File.join(Path.edge_tmp, 'edge.gem')
+      # Retrieve list of possible locations for edge versions
+      # Note that you can just modify that list to add your own locations
+      # You can modify the list at http://github.com/csd/csd/downloads
+      # Note that the Amazon G3 cache used by Github takes about 12 hours to refresh the file, though!
+      for location in Net::HTTP.get_response(URI.parse('http://cloud.github.com/downloads/csd/csd/edge.txt')).body.split.each do
+        # See if there is a downloadable edge version at this location. If not, move on to the next location
+        next unless Cmd.download(location, Path.edge_file).success?
+        # If the download was successful here, let's update the AI from that downloaded gem-file and exit
+        updated = Cmd.run("sudo gem install #{Path.edge_file} --no-ri --no-rdoc", :announce_pwd => false, :verbose => true).success?
+        break
+      end
+      UI.info "Currently there is no edge version published.".green.bold unless updated
+      # Cleaning up the temporary directory
+      FileUtils.rm_r Path.edge_tmp
+      exit!
+    end
+    
     # This method check the arguments the user has provided and terminates the AI with
     # some helpful message if the arguments are invalid.
     #
     def respond_to_incomplete_arguments
-      if !Applications.current and ARGV.include?('update')
-        # Updating the AI
-        UI.info "Updating the AI to the newest version".green.bold
-        Cmd.run "sudo gem update csd --no-ri --no-rdoc", :announce_pwd => false, :verbose => true
-        exit # The only smooth status code 0 exit in this whole application :)
-      else
-        choose_application unless Applications.current
-        choose_action unless Options.valid_action?
-      end
+      choose_application unless Applications.current
+      choose_action unless Options.valid_action?
+      choose_scope if Options.scope and not Options.valid_scope?
     end
   
     # This methods lists all available applications
@@ -53,7 +90,6 @@ module CSD
       end
       UI.separator
       UI.info '  For more information type:   '.green.bold + "#{executable} [APPLICATION NAME]".cyan.bold + "     Example: #{executable} minisip".dark
-      #UI.info '                For example:   '.green.bold + "#{executable} minisip".cyan.bold
       UI.separator
       UI.warn "You did not specify a valid application name."
       raise Error::Argument::NoApplication
@@ -65,7 +101,7 @@ module CSD
       UI.separator
       UI.info "  Automated Installer assistance for #{Applications.current.human}".green.bold
       UI.separator
-      UI.info "  The AI can assist you with the following tasks regarding #{Applications.current.human}: "
+      UI.info "  The AI can assist you with the following tasks regarding #{Applications.current.human}:"
       OptionParser.new do |opts|
         opts.banner = ''
         actions = Applications.current.actions['public']
@@ -74,12 +110,35 @@ module CSD
         UI.info opts.help
       end
       UI.separator
-      UI.info '  To execute a task:   '.green.bold + "#{executable} [TASK] #{Applications.current.name}".cyan.bold + "          Example: #{executable} compile minisip".dark
-      UI.info '   For more details:   '.green.bold + "#{executable} help [TASK] #{Applications.current.name}".cyan.bold + "     Example: #{executable} help compile minisip".dark
+      example_action = Options.actions_names.empty? ? 'install' : Options.actions_names.first
+      UI.info '  To execute a task:   '.green.bold + "#{executable} [TASK] #{Applications.current.name}".cyan.bold + "          Example: #{executable} #{example_action} #{Applications.current.name}".dark
+      UI.info '   For more details:   '.green.bold + "#{executable} help [TASK] #{Applications.current.name}".cyan.bold + "     Example: #{executable} help #{example_action} #{Applications.current.name}".dark
       UI.separator
       UI.warn "You did not specify a valid task name."
       raise Error::Argument::NoAction
     end
+    
+    # This methods lists all available scopes for a specific application and action
+    #
+    def choose_scope
+      UI.separator
+      UI.info "  Automated Installer assistance to #{Options.action} #{Applications.current.human}".green.bold
+      UI.separator
+      UI.info "  The AI can #{Options.action} the following #{Applications.current.human} components:"
+      OptionParser.new do |opts|
+        opts.banner = ''
+        scopes = Applications.current.scopes(Options.action)
+        scopes.flatten.each { |scope| opts.list_item(scope.keys.first, scope.values.first) }
+        UI.info opts.help
+      end
+      UI.separator
+      example_scope = Options.scopes_names.empty? ? 'myscope' : Options.scopes_names.first
+      UI.info '  To choose all components:   '.green.bold + "#{executable} #{Options.action} #{Applications.current.name}".cyan.bold + "                      Example: #{executable} #{Options.action} #{Applications.current.name}".dark
+      UI.info '   To choose one component:   '.green.bold + "#{executable} #{Options.action} #{Applications.current.name} [COMPONENT]".cyan.bold + "          Example: #{executable} #{Options.action} #{Applications.current.name} #{example_scope}".dark
+      UI.separator
+      UI.warn "You did not specify a valid scope."
+      raise Error::Argument::NoAction
+    end
 
   end
 end

data/lib/csd/application/decklink/base.rb

@@ -72,13 +72,13 @@ module CSD
           file = Dir[File.join(Path.packages, "Deck*#{archflag}*.deb")]
           UI.debug "#{self.class} identified these applicable packages: #{file.join(', ')}"
           UI.info "Installing Debian packages".green.bold
-          Cmd.run "sudo apt-get install #{DEBIAN_DEPENDENCIES.join(' ')} --yes", :announce_pwd => false
+          Cmd.run "sudo apt-get install #{DEBIAN_DEPENDENCIES.join(' ')} --yes --force-yes", :announce_pwd => false
           Cmd.run "sudo dpkg -i #{file.first || '[DRIVER FILE FOR THIS ARCHITECTURE]'}", :announce_pwd => false
         end
         
         def add_boot_loader
           content = Path.kernel_module.file? ? File.read(Path.kernel_module) : ''
-          if content !~ /\nblackmagic/m
+          if content !~ /\nblackmagic/m or Options.reveal
             UI.info "Adding Blackmagic drivers to the boot loader".green.bold
             Cmd.touch_and_replace_content Path.new_kernel_module, "#{content}\nblackmagic"
             Cmd.run "sudo cp #{Path.new_kernel_module} #{Path.kernel_module}", :announce_pwd => false

data/lib/csd/application/default.rb

@@ -35,8 +35,7 @@ module CSD
       end
     
       def scopes(action)
-        # TODO: about.scopes[:action]
-        []
+        about.scopes.key?(action) ? about.scopes[action] : []
       end
       
       # This method will look for application and task specific optionsfiles of the current application module.
@@ -45,7 +44,7 @@ module CSD
       #
       def options(action='')
         result = []
-        ["common.rb", "#{action}.rb"].each do |filename|
+        ["#{action}.rb", "common.rb"].each do |filename|
           file = File.join(Path.applications, name, 'options', filename)
           result << File.read(file) if File.file?(file)
         end

data/lib/csd/application/default/base.rb

@@ -37,7 +37,10 @@ module CSD
       end
       
       def create_working_directory
-        unless Path.work.directory?
+        UI.debug "The working directory is demanded to be #{Path.work}"
+        if Path.work.directory?
+          UI.debug "The working directory already exists and will not be created"
+        else
           UI.info "Creating working directory".green.bold
           Cmd.mkdir Path.work
         end
@@ -46,7 +49,7 @@ module CSD
       def cleanup_working_directory
         if !Options.work_dir and Options.temp and !Options.this_user and Path.work.directory?
           UI.info "Removing working directory".green.bold
-          UI.debug "MILESTONE: deleting_work_dir"
+          UI.debug "MILESTONE_deleting_work_dir"
           # TODO: Make this Windows working
           Cmd.run "sudo rm -Rf #{Path.work}", :announce_pwd => false
         end

data/lib/csd/application/i2conf.rb

@@ -0,0 +1,28 @@
+# -*- encoding: UTF-8 -*-
+require 'csd/application/default/base'
+require 'csd/application/i2conf/base'
+
+module CSD
+  module Application
+    # This is the Application Module for i2conf, a sip video conference MCU.
+    #
+    module I2conf
+      class << self
+
+        include CSD::Application::Default
+
+        # This method will check which system we're on and initialize the correct sub-module
+        #
+        def instance
+          if Gem::Platform.local.ubuntu?
+            UI.debug "#{self}.instance initializes the i2conf Base class now"
+            Base.new
+          else
+            raise 'Sorry, currently only Ubuntu is supported.'
+          end
+        end
+
+      end
+    end
+  end
+end

data/lib/csd/application/i2conf/about.yml

@@ -0,0 +1,8 @@
+# -*- encoding: UTF-8 -*-
+human: i2conf
+description: A SIP video conference MCU (Reflector).
+actions:
+  public:
+    - install: Downloads and installs the MCU.
+scopes:
+  --- {}

data/lib/csd/application/i2conf/base.rb

@@ -0,0 +1,215 @@
+# -*- encoding: UTF-8 -*-
+require 'csd/application/default/base'
+require 'csd/application/minisip/unix/linux/debian'
+require 'csd/application/i2conf/config_example'
+
+module CSD
+  module Application
+    module I2conf
+      class Base < CSD::Application::Base
+        
+        include ::CSD::Application::Minisip::Component
+        
+        DESKTOP_ENTRY = %{
+[Desktop Entry]
+Encoding=UTF-8
+Name=i2conf MCU
+GenericName=SIP Multipoint Control Unit (Reflector)
+Comment=Provide a multi-party video conference room
+Exec=PLACEHOLDER
+Icon=i2conf_gnome
+Terminal=true
+Type=Application
+StartupNotify=true
+Categories=Application;Internet;Network;Chat;AudioVideo}
+        
+        GNOME_ICON_URL = 'http://github.com/downloads/csd/i2conf/i2conf_gnome.png'
+        
+        # A list of apt-get packages that are required to install i2conf.
+        #
+        DEBIAN_DEPENDENCIES = %w{ libboost-dev libboost-thread-dev liblog4cxx* }
+        
+        def install
+          @minisip = ::CSD::Application::Minisip::Debian.new
+          define_relative_paths
+          UI.separator
+          UI.info "This operation will download and install the i2conf SIP video conferencing MCU.".green.bold
+          UI.separator
+          introduction
+          install!
+        end
+        
+        def install!
+          create_working_directory
+          compile_minisip
+          aptitude
+          checkout_strmanager
+          copy_libtool
+          fix_str_manager
+          compile_str_manager
+          checkout_i2conf
+          fix_i2conf
+          fix_i2conf_aclocal
+          compile_i2conf
+          create_desktop_entry
+          configure_i2conf
+          send_notification
+          congratulations
+        end
+        
+        def compile_minisip
+          return unless Options.minisip
+          @minisip.aptitude
+          Options.only = %w{ libmutil libmnetutil libmcrypto libmikey libmsip libmstun libminisip }
+          Options.blank_minisip_configuration = true
+          Options.bootstrap = true
+          Options.configure = true
+          Options.make = true
+          Options.make_install = true
+          Core.checkout
+          Core.modify_dirlist
+          Core.compile_libraries
+          Core.link_libraries
+        end
+        
+        def aptitude
+          return unless Options.apt_get
+          UI.info "Installing Debian dependencies for i2conf".green.bold
+          Cmd.run 'sudo apt-get update', :announce_pwd => false
+          Cmd.run "sudo apt-get install #{DEBIAN_DEPENDENCIES.sort.join(' ')} --yes --fix-missing", :announce_pwd => false
+        end
+        
+        def checkout_strmanager
+          Cmd.git_clone('strManager library', 'git://github.com/csd/strManager.git', Path.str_manager)
+        end
+        
+        def copy_libtool
+          UI.info 'Copying libtool dependencies'.green.bold
+          Cmd.cd Path.str_manager, :internal => true
+          Cmd.run 'cp /usr/share/libtool/config/config.sub .'
+          Cmd.run 'cp /usr/share/libtool/config/config.guess .'
+          Cmd.run 'cp /usr/share/libtool/config/ltmain.sh .'
+        end
+        
+        def fix_str_manager
+          UI.info 'Fixing strManager'.green.bold
+          [Path.str_src_manager, Path.str_src_worker].each do |file|
+            if Options.reveal or !File.read(file).include?('#include <iostream>')
+              Cmd.replace file, '#include', "#include <iostream>\n#include", { :only_first_occurence => true }
+            end
+          end
+        end
+        
+        def compile_str_manager
+          UI.info 'Compiling strManager'.green.bold
+          Cmd.cd Path.str_manager, :internal => true
+          Cmd.run './configure'
+          Cmd.run 'aclocal'
+          Cmd.run 'make'
+          Cmd.run 'sudo make install'
+          Cmd.run "sudo ldconfig /usr/local/lib/libstrmanager.so", :announce_pwd => false
+        end
+        
+        def checkout_i2conf
+          Cmd.git_clone('i2conf repository', 'git://github.com/csd/i2conf.git', Path.i2conf)
+        end
+        
+        def fix_i2conf
+          if Options.reveal or !File.read(Path.i2conf_bootstrap).include?('automake-1.11')
+            UI.info 'Fixing i2conf automake'.green.bold
+            Cmd.replace Path.i2conf_bootstrap, 'elif automake-1.10', %{elif automake-1.11 --version >/dev/null 2>&1; then\n  amvers="-1.11"\nelif automake-1.10}, { :only_first_occurence => true }
+          end
+        end
+        
+        def fix_i2conf_aclocal
+          if Options.reveal or File.read(Path.i2conf_bootstrap).include?('-I m4')
+            UI.info 'Fixing i2conf aclocal'.green.bold
+            Cmd.replace Path.i2conf_bootstrap, '-I m4 ', ''
+          end
+        end
+        
+        def compile_i2conf
+          UI.info 'Compiling i2conf'.green.bold
+          Cmd.cd Path.i2conf, :internal => true
+          Cmd.run './bootstrap'
+          Cmd.run './configure'
+          Cmd.run 'aclocal'
+          Cmd.run 'make'
+          Cmd.run 'sudo make install'
+        end
+        
+        def create_desktop_entry
+          UI.info "Installing Gnome menu item".green.bold
+          if Cmd.download(GNOME_ICON_URL, Path.i2conf_gnome_png).success?
+            Cmd.run("sudo cp #{Path.i2conf_gnome_png} #{Path.i2conf_gnome_pixmap}", :announce_pwd => false)
+            Cmd.touch_and_replace_content Path.i2conf_new_desktop_entry, DESKTOP_ENTRY.sub('PLACEHOLDER', "i2conf -f #{Path.i2conf_example_conf}"), :internal => true
+            Cmd.run "sudo mv #{Path.i2conf_new_desktop_entry} #{Path.i2conf_desktop_entry}", :announce_pwd => false
+            Gnome.update_gnome_menu_cache
+          else
+            UI.warn "The menu item could not be created, because the image file could not be downloaded from #{GNOME_ICON_URL}.".green.bold
+          end
+        end
+                
+        def configure_i2conf
+          if Path.i2conf_example_conf.file?
+            UI.warn "Creating no example configuration file, because it already exists: #{Path.i2conf_example_conf}. "
+          else
+            UI.info "Creating example i2conf configuration file".green.bold
+            Cmd.touch_and_replace_content Path.i2conf_example_conf, ::CSD::Application::I2conf::CONFIG_EXAMPLE
+          end
+        end
+
+        def send_notification
+          Cmd.run %{notify-send --icon=i2conf_gnome "I2conf installation complete" "You are now ready to use your SIP MCU." }, :internal => true, :die_on_failure => false
+        end
+        
+        def congratulations
+          cleanup_working_directory if Options.temp
+          UI.separator
+          UI.info "  i2conf installation complete.".green.bold
+          UI.separator
+          UI.info "  1. Change the password in the example configuration file:".yellow
+          UI.info "     #{Path.i2conf_example_conf}".cyan
+          UI.separator
+          UI.info "  2. Start the MCU".yellow
+          UI.info "     Application menu -> Internet".cyan
+          UI.info "     or"
+          UI.info "     i2conf -f #{Path.i2conf_example_conf}".cyan
+          UI.separator
+        end
+        
+        def introduction
+          UI.info " Working directory:       ".green.bold + Path.work.to_s.yellow
+          if Options.debug
+            UI.info " Your Platform:           ".green + Gem::Platform.local.humanize.to_s.yellow
+            UI.info(" Application module:      ".green + self.class.name.to_s.yellow)
+          end
+          UI.separator
+          if Options.help
+            UI.info Options.helptext
+            # Cleanup in case the working directory was temporary and is empty
+            Path.work.rmdir if Options.temp and Path.work.directory? and Path.work.children.empty?
+            raise CSD::Error::Argument::HelpWasRequested
+          else
+            raise Interrupt unless Options.yes or Options.reveal or UI.continue?
+          end
+        end
+        
+        def define_relative_paths
+          UI.debug "#{self.class}#define_relative_paths defines relative i2conf paths now"
+          Path.str_manager              = Pathname.new(File.join(Path.work, 'libstrmanager'))
+          Path.str_src_manager          = Pathname.new(File.join(Path.str_manager, 'src', 'Manager.cpp'))
+          Path.str_src_worker           = Pathname.new(File.join(Path.str_manager, 'src', 'workers', 'StatsWorker.cpp'))
+          Path.i2conf                   = Pathname.new(File.join(Path.work, 'i2conf'))
+          Path.i2conf_bootstrap         = Pathname.new(File.join(Path.i2conf, 'bootstrap'))
+          Path.i2conf_example_conf      = Pathname.new(File.join(ENV['HOME'], 'i2conf.example.xml'))
+          Path.i2conf_gnome_png         = Pathname.new(File.join(Path.work, 'i2conf_gnome.png'))
+          Path.i2conf_gnome_pixmap      = Pathname.new(File.join('/', 'usr', 'share', 'pixmaps', 'i2conf_gnome.png'))
+          Path.i2conf_desktop_entry     = Pathname.new(File.join('/', 'usr', 'share', 'applications', 'i2conf.desktop'))
+          Path.i2conf_new_desktop_entry = Pathname.new(File.join(Path.work, 'i2conf.desktop'))
+        end
+        
+      end
+    end
+  end
+end