console-launcher 0.0.6 → 0.0.8

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NzdlYmU5NTgzZmI5NTlmYzdhYmZiYmQ2OGMwNzQ3MmRmNDA2YjkzNg==
+  data.tar.gz: !binary |-
+    MDU4Y2JlNmIxODI1OGE4ODE3Njg2NzJiNzg3OGFmZjFjODA3ZDU5Yw==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    YmE0YTFkMWRjZGQ4NjUwZTkzYzcxOWYyYWQ3NTE1ZDY0MTVjMWUyNTJmNjFk
+    ZmM5MmM1MTZkN2M5NWE3MDVhZTg2NzIyZDZmZWM3OTZiMjZkNzlkNTc0YWZm
+    ZTUyN2M0NTU2N2ZiMTEyZmFlNjFkZWJiZDk4YWU2Yjg2YjhmNWM=
+  data.tar.gz: !binary |-
+    ZGUzYmM3NTRhNTVlYmJlYWI4NjQwZDMxY2Q5YmQ1YzZlYzMzNGQwZGYyYzY3
+    ZDgyYjIyNjBiMTUzZTZkMThjODg5YzVmZDdjN2FjMjQ3NWRlYTlkMTE2ZTli
+    ZDJmNGFlMTc3NTNjMDdlZmM3ZGY1MTI3YjY1MTFhZDI0NmVkMDk=

data/bin/console-launcher

@@ -29,57 +29,56 @@
 #   - Made sure to strip http and https from the host definition
 
 require 'rubygems'
-require 'rest_client'
-require 'xmlsimple'
+require 'console-launcher'
+require 'console-launcher_version'
 require 'optparse'
-require 'tempfile' # required to download the certificate files on they fly
-require 'net/http'
-require 'highline/import' # Secure Password Prompting if a user does not provide it when the script is called
-
-# queries the User for a password
-def get_password(prompt="RHEV-M Password: ")
-   ask(prompt) {|q| q.echo = "*"}
-end
-
-def strip_url(url)
-  # Remove any leading http or https from the host
-  url = url.split("://")[1] if url.include? "://"
-  return url
+require 'yaml'
+include Helper
+
+options = {
+    print: false,
+    dryrun: false,
+    host: nil,
+    user: "admin@internal",
+    pass: nil
+}
+
+CONFIG_FILE = File.join(ENV['HOME'], '.config-launcher.rc.yaml')
+if File.exists? CONFIG_FILE
+  config_options = YAML.load_file(CONFIG_FILE)
+  options.merge!(config_options)
+else
+  File.open(CONFIG_FILE, 'w') { |file| YAML::dump(options, file) }
+  STDERR.puts "Initialized configuration file in #{CONFIG_FILE}"
 end
 
-@options = {}
-
 optparse = OptionParser.new do |opts|
   opts.banner = "Usage: #{$PROGRAM_NAME} [options]"
 
-  @options[:print] = false
-  opts.on( '--print', 'Print the command to launch the Remote Viewer instead of executing it') do |directory|
-    @options[:print] = true
+
+  opts.on('--print', 'Print the command that is called to launch the Console Session') do
+    options[:print] = true
   end
 
-  @options[:dryrun] = false
-  opts.on( '-d', '--dry-run', 'Do not execute the Remote Viewer Application') do |dryrun|
-    @options[:dryrun] = true
+  opts.on('-d', '--dry-run', 'Do not execute the Remote Viewer Application') do
+    options[:dryrun] = true
   end
 
-  @options[:host] = nil
-  opts.on( '-h', '--host HOSTNAME', 'The Hostname of your RHEV-M Installation') do |host|
-    @options[:host] = strip_url(host)
+  opts.on('-h', '--host HOSTNAME', 'The Hostname of your RHEV-M Installation') do |host|
+    options[:host] = strip_url(host)
   end
 
-  @options[:user] = "admin@internal"
-  opts.on( '-u', '--username USERNAME', 'The Username used to establish the connection to --host (defaults to admin@internal)') do |u|
-    @options[:user] = u
+  opts.on('-u', '--username USERNAME', 'The Username used to establish the connection to --host (defaults to admin@internal)') do |u|
+    options[:user] = u
   end
 
-  @options[:pass] = nil
-  opts.on( '-p', '--password PASSWORD', 'The Password used to establish the connection to --host') do |pass|
-    @options[:pass] = pass
+  opts.on('-p', '--password PASSWORD', 'The Password used to establish the connection to --host') do |pass|
+    options[:pass] = pass
   end
 
   # This displays the help screen, all programs are
   # assumed to have this option.
-  opts.on( '', '--help', 'Display this Help Message' ) do
+  opts.on('', '--help', 'Display this Help Message') do
     puts ""
     puts "This script connects to a RHEV-M Instance and lists all running VMs. You can choose which VM you want to"
     puts "connect to via SPICE Protocol."
@@ -89,6 +88,8 @@ optparse = OptionParser.new do |opts|
     puts "   - Linux:     TBD"
     puts "   - Windows:   TBD"
     puts ""
+    puts "Version: " + ConsoleLauncher::VERSION
+    puts ""
     puts opts
     exit
   end
@@ -101,166 +102,72 @@ end
 # the @options. What's left is the list of files to resize.
 optparse.parse!
 
-if @options[:host] == nil
+if options[:host] == nil
   puts "ERROR: You have to configure RHEV-M Hostname to connect to"
   puts optparse.help
   exit 1
 end
 
-@options[:pass] = get_password if @options[:pass] == nil
+options[:pass] = get_password() if options[:pass] == nil
 
-class VM
-  attr_accessor :id, :name, :description, :host_uuid, :state, :port, :secure_port, :address
-
-  def initialize(vm)
-    @id = vm['id']
-    @name = vm['name']
-    @description = vm['description']    
-    @address = vm['display']['address'] unless vm['display'].nil?
-    @port = vm['display']['port'] unless vm['display'].nil?
-    @secure_port = vm['display']['secure_port'] unless vm['display'].nil?
-    @state = vm['status']['state'] unless vm['status'].nil?
-    @host_uuid = vm['host']['id'] unless vm['host'].nil?
-  end
-end
-
-
-# download the certificate file on the fly
-begin
-  cert = Tempfile.new(@options[:host] + ".crt")    
-  Net::HTTP.start(@options[:host]) do |http|
-    begin
-      http.request_get('/ca.crt') do |resp|
-        resp.read_body do |segment|
-          cert.write(segment)
-        end
-      end
-    ensure
-      cert.close()
-    end
-  end
-  @cert = cert.path
-rescue => e
-  puts "There has been an error downloading the certificate file from #{@options[:host]}"
-  e.message
-  exit 1
-end
-
-# Create a little helper object that we will use to 
-# make connections to the REST API
-@rhevm = RestClient::Resource.new(
-    "https://" + @options[:host], 
-    :user => @options[:user], 
-    :password => @options[:pass],
-    :ssl_ca_cert => @cert,
-    :ssl_version => "SSLv3",
-    :verify_ssl => OpenSSL::SSL::VERIFY_NONE)
-
-def get_vms(vms_data)
-  # Iterate through the VM's and get all the 
-  # required information
-  @vms = Array.new	# Clear out array
-  vms_data['vm'].each do |vm|
-    # Making sure we only consider VM's that are in state up (so they do have a console to connect to)
-    # and that have the spice protocol enabled as the connection mode
-    if vm['status']['state'] == "up" && vm['display']['type'] == "spice"
-      @vms.push(VM.new(vm))
-    end
-  end
-  return @vms
-end
-
-def launch_viewer(index)
-  vm = @vms[index-1]
-
-  # let us no gather the host subject
-  hosts_data = XmlSimple.xml_in(@rhevm["/api/hosts/"+vm.host_uuid].get.body, { 'ForceArray' => false })
-  host_subject = hosts_data['certificate']['subject']
-
-  ticket_data = XmlSimple.xml_in(@rhevm["/api/vms/" + vm.id + "/ticket"].post("<action><ticket><expiry>300</expiry></ticket></action>", :content_type => 'application/xml').body, { 'ForceArray' => false })
-  password = ticket_data['ticket']['value']
-
-  # Creating the .vv File for the connection
-  # download the certificate file on the fly
-  vv = Tempfile.new("#{vm.name}.vv")    
-  begin
-    vv.puts("[virt-viewer]")
-    vv.puts("type=spice")
-    vv.puts("host=#{vm.address}")
-    vv.puts("port=#{vm.port}")
-    vv.puts("password=#{password}")
-    vv.puts("tls-port=#{vm.secure_port}")
-    vv.puts("fullscreen=0")
-    vv.puts("title=vm:#{vm.name} - %d - Press SHIFT+F12 to Release Cursor")
-    vv.puts("enable-smartcard=0")
-    vv.puts("enable-usb-autoshare=1")
-    vv.puts("usb-filter=-1,-1,-1,-1,0")
-    vv.puts("host-subject=#{host_subject}")
-    vv.puts("toggle-fullscreen=shift+f11")
-    vv.puts("release-cursor=shift+f12")
-  ensure 
-    vv.close()
-  end
-
-  # Now that we have all the information we can print the cmd line
-  puts "Console to VM: #{vm.name} state: #{vm.state} is started"
-  command = "/Applications/RemoteViewer.app/Contents/MacOS/RemoteViewer --spice-ca-file #{@cert} #{vv.path}"
-  puts command if @options[:print]
-  unless @options[:dryrun]
-    pid = Process.fork
-    if pid.nil? then
-      # In child
-      $stdout.reopen(Tempfile.new("RV-stdout").path, 'w')
-      $stderr.reopen(Tempfile.new("RV-stderr").path, 'w')
-      exec(command)
-    else
-      # In parent
-      Process.detach(pid)
-    end   
-  end
-  puts "Reloading Virtual Machines Selection Menu ..."
-  sleep(5)
-end
+rhevm = RhevManager.new(options[:host], options[:user], options[:pass])
 
 while true do
   begin
-    @vms = Array.new	# Clear out array
-    # get the vms api and get the list of vms
-    vms_data = XmlSimple.xml_in(@rhevm["/api/vms"].get.body, { 'ForceArray' => false })
-    @vms = get_vms(vms_data)
+    vms = rhevm.get_vms()
+
     # Print the selection to the User
     puts
-    puts "Running Virtual Machines found for #{@options[:host]}:"
-    @vms.each_with_index do |v, index|
+    puts "Running Virtual Machines found for #{options[:host]}:"
+    vms.each_with_index do |v, index|
       puts "#{index+1}. Name: #{v.name} Description: #{v.description} State: #{v.state}"
     end
     puts
     puts "r. Refresh"
     puts "q. Quit"
     puts
-  
+
     puts "Please select the VM you wish to open: "
-  
-    STDOUT.flush  
-    index = gets.chomp	# Hackish, just wanting to add quit
+
+    STDOUT.flush
+    index = gets.chomp # Hackish, just wanting to add quit
     if index.to_s == "q"
       exit 0
     elsif index.to_s == "r"
       next
     end
     index = index.to_i
-    if (1..@vms.size).member?(index)
-      launch_viewer(index)
+
+    if (1..vms.size).member?(index)
+      command = rhevm.launch_viewer(index)
+      puts command if options[:print]
+      unless options[:dryrun]
+        pid = Process.fork
+
+        if pid.nil?
+          # In child
+          $stdout.reopen(Tempfile.new("RV-stdout").path, 'w')
+          $stderr.reopen(Tempfile.new("RV-stderr").path, 'w')
+          exec(command)
+        else
+          # In parent
+          Process.detach(pid)
+        end
+
+      end
+
+      puts "Reloading Virtual Machines Selection Menu ..."
+      sleep(2)
     else
       puts "ERROR: Your selection #{index} is out of range."
     end
   rescue => e
-    puts "There was an error retrieving the Virtual Machines from #{@options[:host]}: #{e.message}"
+    puts "There was an error retrieving the Virtual Machines from #{options[:host]}: #{e.message}"
     puts e.backtrace
     exit 1
   end
 end
-  
+
 exit 0
 
 

data/lib/console-launcher.rb

@@ -0,0 +1,139 @@
+# Copyright 2013 Red Hat Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'rubygems'
+require 'rest_client'
+require 'xmlsimple'
+require 'tmpdir' # required to download the certificate files on they fly
+require 'net/http'
+require 'highline/import' # Secure Password Prompting if a user does not provide it when the script is called
+require 'rhev-manager/virtual-machine'
+
+  class RhevManager
+
+    TMP_DIR = Dir.tmpdir
+
+    def initialize(host, user, password)
+      @host = host
+      @user = user
+      @pass = password
+
+      # Create a little helper object that we will use to
+      # make connections to the REST API
+      @rhevm = RestClient::Resource.new(
+          "https://" + @host,
+          :user => @user,
+          :password => @pass,
+          :ssl_ca_cert => @cert,
+          :ssl_version => "SSLv3",
+          :verify_ssl => OpenSSL::SSL::VERIFY_NONE)
+      get_cert
+    end
+
+    def get_cert()
+      # download the certificate file on the fly
+      begin
+        cert = File.new(TMP_DIR + "/" + @host + ".crt", "w+")
+        Net::HTTP.start(@host) do |http|
+          begin
+            http.request_get('/ca.crt') do |resp|
+              resp.read_body do |segment|
+                cert.write(segment)
+              end
+            end
+          ensure
+            cert.close()
+          end
+        end
+        @cert = cert.path
+      rescue => e
+        raise "There has been an error downloading the certificate file from #{@host}: #{e.message}"
+      end
+    end
+
+    def get_vms()
+      @vms = Array.new # Clear out array
+                       # get the vms api and get the list of vms
+      vms_data = XmlSimple.xml_in(@rhevm["/api/vms"].get.body, {'ForceArray' => false})
+
+      # Iterate through the VM's and get all the
+      # required information
+      vms_data['vm'].each do |vm|
+        # Making sure we only consider VM's that are in state up (so they do have a console to connect to)
+        # and that have the spice protocol enabled as the connection mode
+        if vm['status']['state'] == "up" && vm['display']['type'] == "spice"
+          @vms.push(VirtualMachine.new(vm))
+        end
+      end
+      return @vms
+    end
+
+    def launch_viewer(index)
+      vm = @vms[index-1]
+
+      # let us no gather the host subject
+      hosts_data = XmlSimple.xml_in(@rhevm["/api/hosts/"+vm.host_uuid].get.body, {'ForceArray' => false})
+      host_subject = hosts_data['certificate']['subject']
+
+      ticket_data = XmlSimple.xml_in(@rhevm["/api/vms/" + vm.id + "/ticket"].post("<action><ticket><expiry>30</expiry></ticket></action>", :content_type => 'application/xml').body, {'ForceArray' => false})
+      password = ticket_data['ticket']['value']
+
+      # Creating the .vv File for the connection
+      # download the certificate file on the fly
+      @vv = File.new(TMP_DIR + "/" + vm.name + ".vv", "w+")
+      begin
+        @vv.puts("[virt-viewer]")
+        @vv.puts("type=spice")
+        @vv.puts("host=#{vm.address}")
+        @vv.puts("port=#{vm.port}")
+        @vv.puts("password=#{password}")
+        @vv.puts("tls-port=#{vm.secure_port}")
+        @vv.puts("fullscreen=0")
+        @vv.puts("title=vm:#{vm.name} - %d - Press SHIFT+F12 to Release Cursor")
+        @vv.puts("enable-smartcard=0")
+        @vv.puts("enable-usb-autoshare=1")
+        @vv.puts("usb-filter=-1,-1,-1,-1,0")
+        @vv.puts("host-subject=#{host_subject}")
+        @vv.puts("toggle-fullscreen=shift+f11")
+        @vv.puts("release-cursor=shift+f12")
+      ensure
+        @vv.close()
+      end
+
+      # Now that we have all the information we can print the cmd line
+      puts "Console to VM: #{vm.name} state: #{vm.state} is started"
+
+      command = "/Applications/RemoteViewer.app/Contents/MacOS/RemoteViewer --spice-ca-file #{@cert} #{@vv.path}"
+    end
+
+
+  end
+
+module Helper
+
+  # queries the User for a password
+  def get_password(prompt="RHEV-M Password: ")
+    ask(prompt) { |q| q.echo = "*" }
+  end
+
+  def strip_url(url)
+    # Remove any leading http or https from the host
+    url = url.split("://")[1] if url.include? "://"
+    return url
+  end
+
+  def initialize
+
+  end
+end

data/lib/console-launcher_version.rb

@@ -0,0 +1,4 @@
+
+module ConsoleLauncher
+  VERSION = '0.0.8'
+end

data/lib/rhev-manager/virtual-machine.rb

@@ -0,0 +1,15 @@
+class VirtualMachine
+  attr_accessor :id, :name, :description, :host_uuid, :state, :port, :secure_port, :address
+
+  def initialize(vm)
+    @id = vm['id']
+    @name = vm['name']
+    @description = vm['description']
+    @address = vm['display']['address'] unless vm['display'].nil?
+    @port = vm['display']['port'] unless vm['display'].nil?
+    @secure_port = vm['display']['secure_port'] unless vm['display'].nil?
+    @state = vm['status']['state'] unless vm['status'].nil?
+    @host_uuid = vm['host']['id'] unless vm['host'].nil?
+  end
+end
+

data/man/console-launcher.1

@@ -0,0 +1,60 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "CONSOLE\-LAUNCHER" "1" "May 2013" "" ""
+.
+.SH "NAME"
+\fBconsole\-launcher\fR \- Launch consoles for VM\'s hosted on your RHEV Manager
+.
+.SH "SYNOPSIS"
+\fBconsole\-launcher\fR \-\-host \fIrhevm_hostname\fR \-\-user \fIrhevm_username\fR
+.
+.br
+.
+.SH "DESCRIPTION"
+\fBconsole\-launcher\fR is a simple command\-line tool for launching console sessions to your Virtual Machines running in your RHEV Environment\. It utilizes the RHEV\-M REST API to query for the list of VM\'s running\.
+.
+.P
+It will only display Virtual Machines that have the \fBSPICE\fR Protocol selected and that are actually in state \fBup\fR\. After you select a Virtual Machine to connect to it automatically creates a Session Ticket and stores it inside a \.vv File\.
+.
+.P
+All the files necessary to start the console session are created fully automatically for you\. The Ticket that is generated is valid for 30 seconds\. So although the files are stored inside of the temp directory of the system, the credentials in there should not be valid after the script is ended\.
+.
+.P
+The script creates a configuration file \fBUSER_HOME/\.console\-launcher\.rc\.yaml\fR which can be adapted to your environment, to speed up your workflow to start console sessions\.
+.
+.SH "OPTIONS"
+.
+.TP
+\fB\-\-print\fR
+Print the command that is called to launch the Console Session
+.
+.TP
+\fB\-d\fR, \fB\-\-dry\-run\fR
+Do not execute the command to launch the Console Session\. This can be used for testing purposes\.
+.
+.TP
+\fB\-h\fR, \fB\-\-host HOSTNAME\fR
+The Hostname of your RHEV\-M Server\. This is the FQDN or IP Address not the URL\.
+.
+.TP
+\fB\-u\fR, \fB\-\-username USERNAME\fR
+The Username used to establish the connection to \-\-host (defaults to admin@internal)
+.
+.TP
+\fB\-p\fR, \fB\-\-password PASSWORD\fR
+The Password used to establish the connection to \-\-host
+.
+.SH "EXAMPLES"
+Connect to your RHEV Manager running on rhev\.example\.com\. The username is the default admin@internal\. The password will be asked from the user\.
+.
+.IP "" 4
+.
+.nf
+
+$ console\-launcher \-\-host rhev\.example\.com
+.
+.fi
+.
+.IP "" 0
+

data/man/console-launcher.1.html

@@ -0,0 +1,123 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv='content-type' value='text/html;charset=utf8'>
+  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
+  <title>console-launcher(1) - Launch consoles for VM's hosted on your RHEV Manager</title>
+  <style type='text/css' media='all'>
+  /* style: man */
+  body#manpage {margin:0}
+  .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
+  .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
+  .mp h2 {margin:10px 0 0 0}
+  .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
+  .mp h3 {margin:0 0 0 4ex}
+  .mp dt {margin:0;clear:left}
+  .mp dt.flush {float:left;width:8ex}
+  .mp dd {margin:0 0 0 9ex}
+  .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
+  .mp pre {margin-bottom:20px}
+  .mp pre+h2,.mp pre+h3 {margin-top:22px}
+  .mp h2+pre,.mp h3+pre {margin-top:5px}
+  .mp img {display:block;margin:auto}
+  .mp h1.man-title {display:none}
+  .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
+  .mp h2 {font-size:16px;line-height:1.25}
+  .mp h1 {font-size:20px;line-height:2}
+  .mp {text-align:justify;background:#fff}
+  .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
+  .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
+  .mp u {text-decoration:underline}
+  .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
+  .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
+  .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
+  .mp b.man-ref {font-weight:normal;color:#434241}
+  .mp pre {padding:0 4ex}
+  .mp pre code {font-weight:normal;color:#434241}
+  .mp h2+pre,h3+pre {padding-left:0}
+  ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
+  ol.man-decor {width:100%}
+  ol.man-decor li.tl {text-align:left}
+  ol.man-decor li.tc {text-align:center;letter-spacing:4px}
+  ol.man-decor li.tr {text-align:right;float:right}
+  </style>
+</head>
+<!--
+  The following styles are deprecated and will be removed at some point:
+  div#man, div#man ol.man, div#man ol.head, div#man ol.man.
+
+  The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
+  .man-navigation should be used instead.
+-->
+<body id='manpage'>
+  <div class='mp' id='man'>
+
+  <div class='man-navigation' style='display:none'>
+    <a href="#NAME">NAME</a>
+    <a href="#SYNOPSIS">SYNOPSIS</a>
+    <a href="#DESCRIPTION">DESCRIPTION</a>
+    <a href="#OPTIONS">OPTIONS</a>
+    <a href="#EXAMPLES">EXAMPLES</a>
+  </div>
+
+  <ol class='man-decor man-head man head'>
+    <li class='tl'>console-launcher(1)</li>
+    <li class='tc'></li>
+    <li class='tr'>console-launcher(1)</li>
+  </ol>
+
+  <h2 id="NAME">NAME</h2>
+<p class="man-name">
+  <code>console-launcher</code> - <span class="man-whatis">Launch consoles for VM's hosted on your RHEV Manager</span>
+</p>
+
+<h2 id="SYNOPSIS">SYNOPSIS</h2>
+
+<p><code>console-launcher</code> --host <var>rhevm_hostname</var> --user <var>rhevm_username</var><br /></p>
+
+<h2 id="DESCRIPTION">DESCRIPTION</h2>
+
+<p>  <strong>console-launcher</strong> is a simple command-line tool for launching console sessions
+  to your Virtual Machines running in your RHEV Environment. It utilizes the RHEV-M REST
+  API to query for the list of VM's running.</p>
+
+<p>  It will only display Virtual Machines that have the <strong>SPICE</strong> Protocol selected and that are
+  actually in state <strong>up</strong>. After you select a Virtual Machine to connect to it automatically creates
+  a Session Ticket and stores it inside a .vv File.</p>
+
+<p>  All the files necessary to start the console session are created fully automatically for you. The
+  Ticket that is generated is valid for 30 seconds. So although the files are stored inside of the temp
+  directory of the system, the credentials in there should not be valid after the script is ended.</p>
+
+<p>  The script creates a configuration file <strong>USER_HOME/.console-launcher.rc.yaml</strong> which can be adapted
+  to your environment, to speed up your workflow to start console sessions.</p>
+
+<h2 id="OPTIONS">OPTIONS</h2>
+
+<dl>
+<dt class="flush"><code>--print</code></dt><dd><p>Print the command that is called to launch the Console Session</p></dd>
+<dt><code>-d</code>, <code>--dry-run</code></dt><dd><p>Do not execute the command to launch the Console Session. This can be used for testing purposes.</p></dd>
+<dt><code>-h</code>, <code>--host HOSTNAME</code></dt><dd><p>The Hostname of your RHEV-M Server. This is the FQDN or IP Address not the URL.</p></dd>
+<dt><code>-u</code>, <code>--username USERNAME</code></dt><dd><p>The Username used to establish the connection to --host (defaults to admin@internal)</p></dd>
+<dt><code>-p</code>, <code>--password PASSWORD</code></dt><dd><p>The Password used to establish the connection to --host</p></dd>
+</dl>
+
+
+<h2 id="EXAMPLES">EXAMPLES</h2>
+
+<p>  Connect to your RHEV Manager running on rhev.example.com. The username is the default admin@internal.
+   The password will be asked from the user.</p>
+
+<pre><code>$ console-launcher --host rhev.example.com
+</code></pre>
+
+
+  <ol class='man-decor man-foot man foot'>
+    <li class='tl'></li>
+    <li class='tc'>May 2013</li>
+    <li class='tr'>console-launcher(1)</li>
+  </ol>
+
+  </div>
+</body>
+</html>

metadata

@@ -1,8 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: console-launcher
 version: !ruby/object:Gem::Version
-  version: 0.0.6
-  prerelease: 
+  version: 0.0.8
 platform: ruby
 authors:
 - Juergen Hoffmann
@@ -11,12 +10,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-23 00:00:00.000000000 Z
+date: 2013-05-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -24,7 +22,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -32,7 +29,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: xml-simple
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -40,7 +36,6 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -48,7 +43,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: highline
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -56,11 +50,38 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 1.6.19
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: This gem provides the ability to launch console sessions on Mac
 email:
 - buddy@redhat.com
@@ -71,21 +92,25 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- lib/console-launcher.rb
+- lib/console-launcher_version.rb
+- lib/rhev-manager/virtual-machine.rb
 - bin/console-launcher
+- man/console-launcher.1.html
+- man/console-launcher.1
 homepage: https://github.com/juhoffma/rhev-console-launcher
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
@@ -93,8 +118,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements:
 - RemoteViewer - get it from http://people.freedesktop.org/~teuf/spice-gtk-osx/dmg/0.3.1/
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: RHEV-M Console Launcher
 test_files: []