tem_multi_updater 0.1

data/CHANGELOG

@@ -0,0 +1 @@
+v0.1. Initial release.

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2009 Massachusetts Institute of Technology
+
+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/Manifest

@@ -0,0 +1,8 @@
+CHANGELOG
+LICENSE
+Manifest
+README
+Rakefile
+bin/tem_multi_update_fw
+lib/tem_multi_updater.rb
+lib/tem_multi_updater/updater.rb

data/README

@@ -0,0 +1,5 @@
+tem_multi_updater is a tool that installs or updates the TEM firmware on all the
+smartcards connected to a tem_multi_proxy server.
+
+The tool was written to simplify the maintainance of proof-of-concept
+Map-Reduce TEM clusters.

data/Rakefile

@@ -0,0 +1,31 @@
+# Rakefile for the tem_multi_updater gem.
+#
+# Author:: Victor Costan
+# Copyright:: Copyright (C) 2009 Massachusetts Institute of Technology
+# License:: MIT
+
+require 'rubygems'
+gem 'echoe'
+require 'echoe'
+
+Echoe.new('tem_multi_updater') do |p|
+  p.project = 'tem'  # rubyforge project
+  p.docs_host = "costan@rubyforge.org:/var/www/gforge-projects/tem/rdoc/"
+  
+  p.author = 'Victor Costan'
+  p.email = 'victor@costan.us'
+  p.summary = 'Updates the firmware on all TEMs connected to a tem_multi_proxy.'
+  p.url = 'http://tem.rubyforge.org'
+  p.dependencies = ['smartcard >=0.4.7',
+                    'tem_multi_proxy >=0.2.5',
+                    'tem_ruby >=0.12.0']
+  
+  p.need_tar_gz = !Gem.win_platform?
+  p.need_zip = !Gem.win_platform?
+  p.rdoc_pattern = /^(lib|bin|tasks|ext)|^BUILD|^README|^CHANGELOG|^TODO|^LICENSE|^COPYING$/  
+end
+
+if $0 == __FILE__
+  Rake.application = Rake::Application.new
+  Rake.application.run
+end

data/bin/tem_multi_update_fw

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+#
+# Launcher for the multi-updater code.
+#
+# Author:: Victor Costan
+# Copyright:: Copyright (C) 2009 Massachusetts Institute of Technology
+# License:: MIT
+#
+# Usage: tem_multi_update_fw [host[:port]]
+# The host:port should point to the RPC port of the tem_multi_proxy server.
+# The default host is localhost, and the default port is 9000.
+
+require 'logger'
+require 'rubygems'
+require 'tem_multi_proxy'
+require 'tem_multi_updater'
+
+server_addr = ARGV[0] || 'localhost'
+logger = Logger.new STDERR
+logger.level = Logger::INFO
+updater = Tem::MultiUpdater::Updater.new logger, server_addr
+updater.run

data/lib/tem_multi_updater/updater.rb

@@ -0,0 +1,121 @@
+# Updates the TEM firmware in all the smartcards on tem_multi_proxy server.
+#
+# Author:: Victor Costan
+# Copyright:: Copyright (C) 2009 Massachusetts Institute of Technology
+# License:: MIT
+
+require 'thread'
+
+# :nodoc: namespace
+module Tem::MultiUpdater
+
+
+# Updates the TEM firmware in all the smartcards on tem_multi_proxy server.
+class Updater
+  # Creates a multi-proxy firmware updater.
+  #
+  # Args:
+  #   logger:: receives update progress notifications
+  #   multiproxy_server_addr:: the address (host or host:port) of the
+  #                            tem_multi_proxy RPC port
+  def initialize(logger, multiproxy_server_addr)
+    @logger = logger
+    @server_addr = multiproxy_server_addr
+    @pending = nil
+    @pending_mx, @pending_cv = Mutex.new, ConditionVariable.new
+  end
+
+  # Runs the multi-proxy update.
+  def run
+    return unless @pending.nil?
+    
+    @logger.info "Querying #{@server_addr}"
+    @transport_configs = Tem::MultiProxy::Client.query_tems @server_addr
+    
+    spawn_threads
+    wait_for_threads
+  end
+
+  # Spawns one updating thread for each smart-card transport configuration.
+  def spawn_threads
+    @pending = @transport_configs.length
+    @transport_configs.each do |transport_config|
+      Thread.new(transport_config) do |config|
+        update_thread config
+      end
+    end
+  end
+  
+  # Waits for all the updating threads to complete.
+  def wait_for_threads
+    @pending_mx.synchronize do
+      loop do
+        break if @pending == 0
+        @pending_cv.wait @pending_mx
+      end
+    end
+  end
+  
+  # Main method for a TEM firmware updating thread.
+  #
+  # Args:
+  #   transport_config:: configuration for the TEM's smart-card transport 
+  def update_thread(transport_config)
+    transport = Smartcard::Iso::AutoConfigurator.try_transport transport_config
+    if transport
+      @logger.info "Connected to #{transport.inspect}"
+      update_transport transport
+    else
+      @logger.warn "Failed connecting to #{transport_config.inspect}"
+    end
+    
+    @pending_mx.synchronize do
+      @pending -= 1
+      @pending_cv.signal
+    end
+  end
+  
+  # Installs or updates TEM firmware on a smart-card.
+  # 
+  # Args:
+  #   transport_config:: smart-card transport connecting to the TEM card
+  #
+  # No firmware will be uploaded if the smart-card already has the latest
+  # version of the TEM software.
+  def update_transport(transport)
+    if !needs_update? transport
+      @logger.info "No update needed at #{transport.inspect}"
+      return
+    end
+    
+    @logger.info "Uploading TEM firmware to #{transport.inspect}"
+    begin
+      Tem::Firmware::Uploader.upload_cap transport
+    rescue Exception => e
+      @logger.error "Error while uploading TEM firmware to " +
+                    "#{transport.inspect} - #{e.class.name}: #{e.message}"
+      @logger.info e.backtrace.join("\n")
+    end
+  end
+
+  # Checks if the a smart-card needs a TEM firmware upload.
+  #
+  # Args:
+  #   transport_config:: smart-card transport connecting to the TEM card 
+  def needs_update?(transport)    
+    begin
+      tem = Tem::Session.new transport
+      tem_version = tem.fw_version
+      local_version = Tem::Firmware::Uploader.fw_version
+      if local_version[:major] != tem_version[:major]
+        return local_version[:major] > tem_version[:major]
+      end
+      return local_version[:minor] > tem_version[:minor]
+    rescue Smartcard::Iso::ApduError
+      # An APDU error here means the TEM firmware was not installed.
+      return true       
+    end
+  end
+end  # class Tem::MultiUpdater::Updater
+
+end  # namespace Tem::MultiUpdater

data/lib/tem_multi_updater.rb

@@ -0,0 +1,18 @@
+# Main include file for the tem_multi_updater Rubygem.
+#
+# Author:: Victor Costan
+# Copyright:: Copyright (C) 2009 Massachusetts Institute of Technology
+# License:: MIT
+
+# Gem requirements.
+require 'rubygems'
+require 'smartcard'
+require 'tem_ruby'
+require 'tem_multi_proxy'
+
+# :nodoc: namespace
+module Tem  
+end
+
+# The files making up the gem.
+require 'tem_multi_updater/updater.rb'

data/tem_multi_updater.gemspec

@@ -0,0 +1,41 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{tem_multi_updater}
+  s.version = "0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Victor Costan"]
+  s.date = %q{2009-11-10}
+  s.default_executable = %q{tem_multi_update_fw}
+  s.description = %q{Updates the firmware on all TEMs connected to a tem_multi_proxy.}
+  s.email = %q{victor@costan.us}
+  s.executables = ["tem_multi_update_fw"]
+  s.extra_rdoc_files = ["CHANGELOG", "LICENSE", "README", "bin/tem_multi_update_fw", "lib/tem_multi_updater.rb", "lib/tem_multi_updater/updater.rb"]
+  s.files = ["CHANGELOG", "LICENSE", "Manifest", "README", "Rakefile", "bin/tem_multi_update_fw", "lib/tem_multi_updater.rb", "lib/tem_multi_updater/updater.rb", "tem_multi_updater.gemspec"]
+  s.homepage = %q{http://tem.rubyforge.org}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Tem_multi_updater", "--main", "README"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{tem}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Updates the firmware on all TEMs connected to a tem_multi_proxy.}
+
+  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<smartcard>, [">= 0.4.7"])
+      s.add_runtime_dependency(%q<tem_multi_proxy>, [">= 0.2.5"])
+      s.add_runtime_dependency(%q<tem_ruby>, [">= 0.12.0"])
+    else
+      s.add_dependency(%q<smartcard>, [">= 0.4.7"])
+      s.add_dependency(%q<tem_multi_proxy>, [">= 0.2.5"])
+      s.add_dependency(%q<tem_ruby>, [">= 0.12.0"])
+    end
+  else
+    s.add_dependency(%q<smartcard>, [">= 0.4.7"])
+    s.add_dependency(%q<tem_multi_proxy>, [">= 0.2.5"])
+    s.add_dependency(%q<tem_ruby>, [">= 0.12.0"])
+  end
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification 
+name: tem_multi_updater
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Victor Costan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-10 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: smartcard
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.4.7
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: tem_multi_proxy
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.2.5
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: tem_ruby
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.12.0
+    version: 
+description: Updates the firmware on all TEMs connected to a tem_multi_proxy.
+email: victor@costan.us
+executables: 
+- tem_multi_update_fw
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- LICENSE
+- README
+- bin/tem_multi_update_fw
+- lib/tem_multi_updater.rb
+- lib/tem_multi_updater/updater.rb
+files: 
+- CHANGELOG
+- LICENSE
+- Manifest
+- README
+- Rakefile
+- bin/tem_multi_update_fw
+- lib/tem_multi_updater.rb
+- lib/tem_multi_updater/updater.rb
+- tem_multi_updater.gemspec
+has_rdoc: true
+homepage: http://tem.rubyforge.org
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Tem_multi_updater
+- --main
+- README
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: tem
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Updates the firmware on all TEMs connected to a tem_multi_proxy.
+test_files: []
+