CloudyScripts 2.14.63 → 2.14.64

data/Rakefile

@@ -12,7 +12,7 @@ require 'rake/testtask'
 
 spec = Gem::Specification.new do |s|
   s.name = 'CloudyScripts'
-  s.version = '2.14.63' #<number cloud-stacks supported>.<number cloud-scripts>.<counting releases>
+  s.version = '2.14.64' #<number cloud-stacks supported>.<number cloud-scripts>.<counting releases>
   s.has_rdoc = true
   s.extra_rdoc_files = ['README.rdoc', 'LICENSE']
   s.summary = 'Scripts to facilitate programming for infrastructure clouds.'
@@ -31,6 +31,8 @@ spec = Gem::Specification.new do |s|
   s.add_dependency("amazon-ec2")
   s.add_dependency("net-ssh")
   s.add_dependency("net-scp")
+  s.add_dependency("net-sftp")
+  s.add_dependency("zip")
 end
 
 Rake::GemPackageTask.new(spec) do |p|

data/lib/help/state_transition_helper.rb

@@ -579,7 +579,7 @@ module StateTransitionHelper
           ec2_handler().authorize_security_group_ingress(:group_name => name,
             :ip_protocol => rule[:ip_protocol], :from_port => rule[:from_port], :to_port => rule[:to_port], :cidr_ip => rule[:cidr_ip])
         rescue AWS::InvalidPermissionDuplicate => e
-          @logger.warn "'#{rule[:proto].upcase()} (#{rule[:from_port]}-#{rule[:to_port]})' rule already exists: #{e.to_s}"
+          @logger.warn "'#{rule[:ip_protocol].upcase()} (#{rule[:from_port]}-#{rule[:to_port]})' rule already exists: #{e.to_s}"
         end
       }
     end
@@ -626,6 +626,21 @@ module StateTransitionHelper
     if !type.nil? && !type.empty?
       fs_type = type
     end
+    #XXX: detect new kernel that have /dev/xvdX device node instead of /dev/sdX
+    if device =~ /\/dev\/sd[a-z]/
+      if !remote_handler().file_exists?(device)
+        post_message("'#{device}' device node not found, checking for new kernel support...")
+        @logger.debug "'#{device}' device node not found, checking for new kernel support" 
+        new_device = device.gsub('sd', 'xvd')
+        if remote_handler().file_exists?(new_device)
+          post_message("'#{new_device}' device node found")
+          @logger.debug "'#{new_device}' device node found"
+          device = new_device
+        end
+      end
+    #elsif device =~/\/dev\/xvd[a-z]/
+    end
+
     @logger.debug "create '#{fs_type}' filesystem on device '#{device}'"
     status = remote_handler().create_filesystem(fs_type, device)
     if status == false
@@ -1334,6 +1349,27 @@ module StateTransitionHelper
                                  #Ubuntu kernel Amazon Kernel ID
                                  'aki-87f38cd5' => 'aki-ubuntu-karmic-v2.6.31-302.i386'
                            },
+            'ap-southeast-2' => {'' => 'pv-grub-hd00-V1.01-i386',
+                                 '' => 'pv-grub-hd00-V1.01-x86_64',
+                                 '' => 'pv-grub-hd0-V1.01-i386',
+                                 '' => 'pv-grub-hd0-V1.01-x86_64',
+                                 '' => 'pv-grub-hd00_1.02-i386',
+                                 '' => 'pv-grub-hd00_1.02-x86_64',
+                                 '' => 'pv-grub-hd0_1.02-i386',
+                                 '' => 'pv-grub-hd0_1.02-x86_64',
+                                 'aki-33990e09' => 'pv-grub-hd0_1.03-i386',
+                                 'aki-31990e0b' => 'pv-grub-hd0_1.03-x86_64',
+                                 'aki-3f990e05' => 'pv-grub-hd00_1.03-i386',
+                                 'aki-3d990e07' => 'pv-grub-hd00_1.03-x86_64',
+
+                                 #RHEL kernel Amazon Kernel ID
+                                 'aki-9b8413a1' => 'aki-rhel-i386',	# RH-pv-grub-hd0-V1.01-i386
+                                 'aki-998413a3' => 'aki-rhel-x86_64',	# RH-pv-grub-hd0-V1.01-x86_64
+
+                                 #Ubuntu kernel Amazon Kernel ID
+                                 '' => 'aki-ubuntu-karmic-v2.6.31-302.i386'
+                           },
+
             'ap-northeast-1' => {'aki-d209a2d3' => 'pv-grub-hd00-V1.01-i386',
                                  'aki-d409a2d5' => 'pv-grub-hd00-V1.01-x86_64',
                                  'aki-d609a2d7' => 'pv-grub-hd0-V1.01-i386',
@@ -1358,10 +1394,10 @@ module StateTransitionHelper
                             'aki-d03ce3cd' => 'pv-grub-hd00-V1.01-x86_64',
                             'aki-863ce39b' => 'pv-grub-hd0-V1.01-i386',
                             'aki-d63ce3cb' => 'pv-grub-hd0-V1.01-x86_64',
-                            'aki-bc3ce3a1' => 'pv-grub-hd00_1.02-i386',
-                            'aki-cc3ce3d1' => 'pv-grub-hd00_1.02-x86_64',
-                            'aki-823ce39f' => 'pv-grub-hd0_1.02-i386',
-                            'aki-d23ce3cf' => 'pv-grub-hd0_1.02-x86_64',
+                            'aki-823ce39f' => 'pv-grub-hd00_1.02-i386',
+                            'aki-d23ce3cf' => 'pv-grub-hd00_1.02-x86_64',
+                            'aki-bc3ce3a1' => 'pv-grub-hd0_1.02-i386',
+                            'aki-cc3ce3d1' => 'pv-grub-hd0_1.02-x86_64',
                             'aki-ca8f51d7' => 'pv-grub-hd0_1.03-i386',
                             'aki-c48f51d9' => 'pv-grub-hd0_1.03-x86_64',
                             'aki-ce8f51d3' => 'pv-grub-hd00_1.03-i386',
@@ -1407,14 +1443,16 @@ module StateTransitionHelper
     case endpoint
       when /us-east/
         region = "us-east-1"
-      when /us-west-2/
-        region = "us-west-2"
       when /us-west-1/
         region = "us-west-1"
+      when /us-west-2/
+        region = "us-west-2"
       when /eu-west/
         region = "eu-west-1"
-      when /ap-southeast/
+      when /ap-southeast-1/
         region = "ap-southeast-1"
+      when /ap-southeast-2/
+        region = "ap-southeast-2"
       when /ap-northeast/
         region = "ap-northeast-1"
       when /sa-east-1/

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: CloudyScripts
 version: !ruby/object:Gem::Version 
-  hash: 73
-  prerelease: false
+  hash: 183
+  prerelease: 
   segments: 
   - 2
   - 14
-  - 63
-  version: 2.14.63
+  - 64
+  version: 2.14.64
 platform: ruby
 authors: 
 - Matthias Jung
@@ -16,8 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-10-16 00:00:00 +00:00
-default_executable: 
+date: 2013-01-03 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: amazon-ec2
@@ -61,6 +60,34 @@ dependencies:
         version: "0"
   type: :runtime
   version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: net-sftp
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: zip
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id005
 description: Scripts to facilitate programming for infrastructure clouds.
 email: 
 - matthias.jung@gmail.com
@@ -255,7 +282,6 @@ files:
 - lib/scripts/ec2/port_range_detector.rb
 - lib/scripts/ec2/ec2_script.rb
 - lib/scripts/ec2/vpc_critical_ports_audit.rb
-- lib/scripts/ec2/copy_ami_test.rb
 - lib/scripts/ec2/copy_snapshot.rb
 - lib/scripts/ec2/copy_mswindows_ami.rb
 - lib/scripts/ec2/copy_mswindows_snapshot.rb
@@ -267,7 +293,6 @@ files:
 - lib/scripts/ec2/snapshot_optimization.rb
 - lib/scripts/ec2/audit_via_ssh.rb
 - lib/scripts/ec2/download_snapshot.rb
-- lib/scripts/ec2/check_cloudyscripts.rb
 - lib/scripts/vCloud/v_cloud_script.rb
 - lib/scripts/vCloud/open_port_checker_vm.rb
 - lib/cloudyscripts.rb
@@ -281,7 +306,6 @@ files:
 - lib/help/progress_message_listener.rb
 - lib/help/remote_command_handler.rb
 - lib/help/helper.rb
-has_rdoc: true
 homepage: http://elastic-security.com
 licenses: []
 
@@ -311,7 +335,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: CloudyScripts
-rubygems_version: 1.3.7
+rubygems_version: 1.7.2
 signing_key: 
 specification_version: 3
 summary: Scripts to facilitate programming for infrastructure clouds.

data/lib/scripts/ec2/check_cloudyscripts.rb

@@ -1,142 +0,0 @@
-require "help/script_execution_state"
-require "scripts/ec2/ec2_script"
-require "help/remote_command_handler"
-require "help/dm_crypt_helper"
-require "help/ec2_helper"
-require "AWS"
-
-# Goal: check internal piece of CloudyScripts without launching the full scripts
-#
-
-class CheckCloudyScripts < Ec2Script
-  
-  def initialize(input_params)
-    super(input_params)
-  end
-
-  def check_input_parameters()
-    if @input_params[:ami_id] == nil && !(@input_params[:ami_id] =~ /^ami-.*$/)
-      raise Exception.new("Invalid AMI ID specified: #{@input_params[:ami_id]}")
-    end
-    ec2_helper = Ec2Helper.new(@input_params[:ec2_api_handler])
-    if ec2_helper.ami_prop(@input_params[:ami_id], 'rootDeviceType') != "ebs"
-      raise Exception.new("must be an EBS type image")
-    end
-    local_ec2_helper = ec2_helper
-    if !local_ec2_helper.check_open_port('default', 22)
-      raise Exception.new("Port 22 must be opened for security group 'default' to connect via SSH in source-region")
-    end
-    remote_ec2_helper = Ec2Helper.new(@input_params[:target_ec2_handler])
-    if !remote_ec2_helper.check_open_port('default', 22)
-      raise Exception.new("Port 22 must be opened for security group 'default' to connect via SSH in target-region")
-    end
-    if @input_params[:root_device_name] == nil
-      @input_params[:root_device_name] = "/dev/sda1"
-    end
-    if @input_params[:temp_device_name] == nil
-      @input_params[:temp_device_name] = "/dev/sdj"
-    end
-    if @input_params[:source_ssh_username] == nil
-      @input_params[:source_ssh_username] = "root"
-    end
-    if @input_params[:target_ssh_username] == nil
-      @input_params[:target_ssh_username] = "root"
-    end
-  end
-
-  # Load the initial state for the script.
-  # Abstract method to be implemented by extending classes.
-  def load_initial_state()
-    CheckCloudyScriptsState.load_state(@input_params)
-  end
-
-  private
-
-  # Here begins the state machine implementation
-  class CheckCloudyScriptsState < ScriptExecutionState
-
-    def self.load_state(context)
-      InitialState.new(context)
-    end
-
-    def local_region
-      self.ec2_handler=(@context[:ec2_api_handler])
-    end
-
-    def remote_region
-      self.ec2_handler=(@context[:target_ec2_handler])
-    end
-  end
-
-  # Initial state: start up AMI in source region
-  class InitialState < CheckCloudyScriptsState
-    def enter()
-      post_message("INFO: Entering InitialState...")
-
-      #@context[:source_instance_id], @context[:source_dns_name], @context[:source_availability_zone], 
-      #  @context[:kernel_id], @context[:ramdisk_id], @context[:architecture], @context[:root_device_name] =
-      #  launch_instance(@context[:ami_id], @context[:source_key_name], "default")
-      start_instance(@context[:source_instance_id])
-      res = describe_instance(@context[:source_instance_id])
-      puts "DEBUG: instance: #{res.inspect}"
-      #@context[:source_instance_id] = "i-0a663643" 
-      @context[:source_dns_name] = res[1]
-      @context[:source_availability_zone] = res[2]
-      @context[:kernel_id] = res[3]
-      @context[:ramdisk_id] = res[4]
-      @context[:architecture] = res[5]
-      @context[:root_device_name] = res[6]
-
-      ec2_helper = Ec2Helper.new(@context[:ec2_api_handler])
-      puts "DEBUG: get_attached returns: #{ec2_helper.get_attached_volumes(@context[:source_instance_id]).inspect}"
-      @context[:ebs_volume_id] = ec2_helper.get_attached_volumes(@context[:source_instance_id])[0]['volumeId']#TODO: what when more root devices?
-
-      CSTestingState.new(@context)
-    end
-  end
-
-  # Snapshot is created from the AMI. Create a volume from the snapshot, attach and mount the volume as second device.
-  class CSTestingState < CheckCloudyScriptsState
-    def enter()
-      post_message("INFO: Entering CSTestingState...")
-
-      #@context[:source_volume_id] = create_volume_from_snapshot(@context[:snapshot_id],
-      #  @context[:source_availability_zone])
-      @context[:source_volume_id] = "vol-6eb34b06" 
-
-      device = @context[:temp_device_name]
-      mount_point = "/mnt/tmp_#{@context[:source_volume_id]}"
-      attach_volume(@context[:source_volume_id], @context[:source_instance_id], device)
-      connect(@context[:source_dns_name], @context[:source_ssh_username], nil, @context[:source_ssh_keydata]) 
-      # detect if there is a shift for device mapping (between AWS and the operating system of the system)
-      root_device_name = get_root_device_name()
-      # detect letters
-      aws_root_device = @context[:root_device_name]
-      aws_letter = aws_root_device.split('/')[2].gsub('sd', '').gsub('xvd', '').gsub(/[0-9]/, '')
-      os_letter = root_device_name.split('/')[2].gsub('sd', '').gsub('xvd', '').gsub(/[0-9]/, '')
-      aws_device_letter = device.split('/')[2].gsub('sd', '').gsub('xvd', '').gsub(/[0-9]/, '')
-      puts "DEBUG: AWS info: #{aws_root_device}, #{aws_letter}"
-      puts "DEBUG: OS info: #{root_device_name}, #{os_letter}"
-      if !aws_letter.eql?(os_letter)
-        post_message("Detected specific kernel with shift between AWS and Kernel OS for device naming")
-        puts "Detected specific kernel with shift between AWS and Kernel OS for device naming (#{aws_root_device} vs #{root_device_name})"
-      end
-      while !aws_letter.eql?(os_letter)
-        aws_letter.succ!
-        aws_device_letter.succ!
-      end
-      device = "/dev/sd#{aws_device_letter}" 
-      post_message("Using AWS name '#{@context[:temp_device_name]}' and OS name '#{device}'")
-      puts "Using AWS name '#{@context[:temp_device_name]}' and OS name '#{device}'"
-      mount_fs(mount_point, device)
-      # get root partition label and filesystem type
-      #@context[:label] = get_root_partition_label()
-      #@context[:fs_type] = get_root_partition_fs_type()
-      @context[:fs_type], @context[:label] = get_root_partition_fs_type_and_label()
-      disconnect()
-
-      Done.new()
-    end
-  end
-
-end

data/lib/scripts/ec2/copy_ami_test.rb

@@ -1,449 +0,0 @@
-require "help/script_execution_state"
-require "scripts/ec2/ec2_script"
-require "help/remote_command_handler"
-require "help/dm_crypt_helper"
-require "help/ec2_helper"
-require "AWS"
-require "help/helper"
-
-
-# Copy a given snapshot to another region
-# * start up instance in source-region, create a snapshot from the mounted EBS
-# * then create volume from snapshot, attach volume, and mount it
-# * start up instance in destination-region, create empty volume of same size, attache volume, and mount it
-# * copy the destination key to the source instance
-# * perform an rsynch
-#   sync -PHAXaz --rsh "ssh -i /home/${src_user}/.ssh/id_${dst_keypair}" --rsync-path "sudo rsync" ${src_dir}/ ${dst_user}@${dst_public_fqdn}:${dst_dir}/
-# * create a snapshot of the volume
-# * register the snapshot as AMI
-# * clean-up everything
-
-class CopyAmiTest < Ec2Script
-  # context information needed
-  # * the EC2 credentials (see #Ec2Script)
-  # * ami_id => the ID of the AMI to be copied in another region
-  # * target_ec2_handler => The EC2 handler connected to the region where the snapshot is being copied to
-  # * source_ssh_username => The username for ssh for source-instance (default = root)
-  # * source_key_name => Key name of the instance that manages the snaphot-volume in the source region
-  # * source_ssh_key_data => Key information for the security group that starts the AMI [if not set, use ssh_key_files]
-  # * source_ssh_key_files => Key information for the security group that starts the AMI
-  # * target_ssh_username => The username for ssh for target-instance (default = root)
-  # * target_key_name => Key name of the instance that manages the snaphot-volume in the target region
-  # * target_ssh_key_data => Key information for the security group that starts the AMI [if not set, use ssh_key_files]
-  # * target_ssh_key_files => Key information for the security group that starts the AMI
-  # * target_ami_id => ID of the AMI to start in the target region
-  # * name => name of new AMI to be created
-  # * description => description of new AMI to be created
-  
-  def initialize(input_params)
-    super(input_params)
-  end
-
-  def check_input_parameters()
-    post_message("Checking parameters...")
-    if @input_params[:ami_id] == nil || !(@input_params[:ami_id] =~ /^ami-.*$/)
-      raise Exception.new("Invalid AMI ID specified: #{@input_params[:ami_id]}")
-    end
-    ec2_helper = Ec2Helper.new(@input_params[:ec2_api_handler])
-    if ec2_helper.ami_prop(@input_params[:ami_id], 'rootDeviceType') != "ebs"
-      raise Exception.new("must be an EBS type image")
-    end
-    local_ec2_helper = ec2_helper
-    remote_ec2_helper = Ec2Helper.new(@input_params[:target_ec2_handler])
-    # AWS KeyPair
-    if @input_params[:source_key_name] == nil || @input_params[:source_key_name].empty?()
-      raise Exception.new("No KeyPair name specified for source region")
-    else
-      begin
-        local_ec2_helper.check_keypair(@input_params[:source_key_name])
-      rescue Exception => e
-        post_message("'#{@input_params[:source_key_name]}' Key pair not found in source region") 
-        raise Exception.new("source region: #{e.to_s}")
-      end
-    end
-    if @input_params[:target_key_name] == nil || @input_params[:target_key_name].empty?()
-      raise Exception.new("No KeyPair name specified for target region")
-    else
-      begin
-        remote_ec2_helper.check_keypair(@input_params[:target_key_name])
-      rescue Exception => e
-        post_message("'#{@input_params[:target_key_name]}' Key pair not found in target region") 
-        raise Exception.new("target region: #{e.to_s}")
-      end
-    end
-    # AWS SecurityGroup
-    if @input_params[:source_security_group] == nil
-      @input_params[:source_security_group] = "default"
-    end
-    if !local_ec2_helper.check_open_port(@input_params[:source_security_group], 22)
-      post_message("'#{@input_params[:source_security_group]}' Security Group not opened port 22 for connect via SSH in source region")
-      @input_params[:source_security_group] = nil
-    else
-      post_message("'#{@input_params[:source_security_group]}' Security Group opened port 22 for connect via SSH in source region")
-    end
-    if @input_params[:target_security_group] == nil
-      @input_params[:target_security_group] = "default"
-    end
-    if !remote_ec2_helper.check_open_port(@input_params[:target_security_group], 22)
-      post_message("'#{@input_params[:target_security_group]}' Security Group not opened port 22 for connect via SSH in target region")
-      @input_params[:target_security_group] = nil
-    else
-      post_message("'#{@input_params[:target_security_group]}' Security Group opened port 22 for connect via SSH in target region")
-    end
-    # Device to use
-    if @input_params[:root_device_name] == nil
-      @input_params[:root_device_name] = "/dev/sda1"
-    end
-    if @input_params[:temp_device_name] == nil
-      @input_params[:temp_device_name] = "/dev/sdj"
-    end
-    # SSH Parameters
-    if @input_params[:source_ssh_username] == nil
-      @input_params[:source_ssh_username] = "root"
-    end
-    if @input_params[:target_ssh_username] == nil
-      @input_params[:target_ssh_username] = "root"
-    end
-    if @input_params[:source_ssh_keydata] == nil
-      raise Exception.new("No Private Key for source region")
-    else
-      begin
-        check_ssh_key(@input_params[:source_ssh_keydata])
-      rescue Exception => e
-        post_message("not a Private Key: #{e.to_s}")
-        raise Exception.new("Invalid Private Key for source region: #{e.to_s}")
-      end
-    end
-    if @input_params[:target_ssh_keydata] == nil
-      raise Exception.new("No Private Key for target region")
-    else
-      begin
-        check_ssh_key(@input_params[:target_ssh_keydata])
-      rescue Exception => e
-        post_message("not a Private Key: #{e.to_s}") 
-        raise Exception.new("Invalid Private Key for target region: #{e.to_s}")
-      end
-    end
-    # AWS Name and Description
-    if @input_params[:description] == nil || !check_aws_desc(@input_params[:description])
-      @input_params[:description] = "Created by CloudyScripts - #{self.class.name}"
-    end
-    if @input_params[:name] == nil || !check_aws_name(@input_params[:name])
-      @input_params[:name] = "Created_by_CloudyScripts/#{self.class.name}_from_#{@input_params[:ami_id]}"
-    end
-  end
-
-  # Load the initial state for the script.
-  # Abstract method to be implemented by extending classes.
-  def load_initial_state()
-    CopyAmiTestState.load_state(@input_params)
-  end
-
-  private
-
-  # Here begins the state machine implementation
-  class CopyAmiTestState < ScriptExecutionState
-
-    def self.load_state(context)
-      InitialState.new(context)
-    end
-
-    def local_region
-      self.ec2_handler=(@context[:ec2_api_handler])
-    end
-
-    def remote_region
-      self.ec2_handler=(@context[:target_ec2_handler])
-    end
-  end
-
-  # Initial state: start up AMI in source region
-  class InitialState < CopyAmiTestState
-    def enter()
-      local_region()
-      #XXX: create a CloudyScripts Security Group with TCP port 22 publicly opened
-      if @context[:source_security_group] == nil
-        @context[:source_security_group] = Ec2Script::CS_SEC_GRP_NAME
-        create_security_group_with_rules(@context[:source_security_group], Ec2Script::CS_SEC_GRP_DESC, 
-          [{:ip_protocol => "tcp", :from_port => 22, :to_port => 22, :cidr_ip => "0.0.0.0/0"}])
-        post_message("'#{@context[:source_security_group]}' Security Group created with TCP port 22 publicly opened.")
-      end
-
-      @context[:source_instance_id], @context[:source_dns_name], @context[:source_availability_zone], 
-        @context[:kernel_id], @context[:ramdisk_id], @context[:architecture], @context[:root_device_name] =
-        launch_instance(@context[:ami_id], @context[:source_key_name], @context[:source_security_group])
-      ec2_helper = Ec2Helper.new(@context[:ec2_api_handler])
-      @context[:ebs_volume_id] = ec2_helper.get_attached_volumes(@context[:source_instance_id])[0]['volumeId']	#TODO: what when more root devices?
-
-      SourceInstanceLaunchedState.new(@context)
-    end
-  end
-
-  # Source is started. Create a snapshot on the volume that is linked to the instance.
-  class SourceInstanceLaunchedState < CopyAmiTestState
-    def enter()
-      @context[:snapshot_id] = create_snapshot(@context[:ebs_volume_id], 
-        "Created by CloudyScripts - #{self.get_superclass_name()} from #{@context[:ebs_volume_id]}")
-
-      AmiSnapshotCreatedState.new(@context)
-    end
-  end
-
-  # Snapshot is created from the AMI. Create a volume from the snapshot, attach and mount the volume as second device.
-  class AmiSnapshotCreatedState < CopyAmiTestState
-    def enter()
-      @context[:source_volume_id] = create_volume_from_snapshot(@context[:snapshot_id],
-        @context[:source_availability_zone])
-      device = @context[:temp_device_name]
-      mount_point = "/mnt/tmp_#{@context[:source_volume_id]}"
-      #XXX: attach volume after root partition detection
-      attach_volume(@context[:source_volume_id], @context[:source_instance_id], device)
-      connect(@context[:source_dns_name], @context[:source_ssh_username], nil, @context[:source_ssh_keydata]) 
-      # detect if there is a shift for device mapping (between AWS and the operating system of the system)
-      root_device_name = get_root_device_name()
-      # detect letters
-      aws_root_device = @context[:root_device_name]
-      aws_letter = aws_root_device.split('/')[2].gsub('sd', '').gsub('xvd', '').gsub(/[0-9]/, '')
-      os_letter = root_device_name.split('/')[2].gsub('sd', '').gsub('xvd', '').gsub(/[0-9]/, '')
-      aws_device_letter = device.split('/')[2].gsub('sd', '').gsub('xvd', '').gsub(/[0-9]/, '')
-      if !aws_letter.eql?(os_letter)
-        post_message("Detected specific kernel with shift between AWS and Kernel OS for device naming: '#{aws_root_device}' vs '#{root_device_name}'")
-      end
-      while !aws_letter.eql?(os_letter)
-        aws_letter.succ!
-        aws_device_letter.succ!
-      end
-
-      # attach volume
-      #attach_volume(@context[:source_volume_id], @context[:source_instance_id], device)
-
-      device = "/dev/sd#{aws_device_letter}"
-      # detect root partition vs root volume: simply check if we have several /dev/sdx* entries
-      parts_count = get_partition_count(device)
-      if parts_count >= 2
-        # retrieve partition table, in order to restore it in the target region
-        post_message("Detected specific volume with a valid partition table on device '#{device}'...")
-        partition_table = get_partition_table(device)
-        @context[:partition_table] = partition_table
-        #XXX: HANDLE at a LOWER LEVEL
-        # update partition table with device
-        # s/device/@context[:temp_device_name]/ on partition table 
-        #@context[:partition_table] = partition_table.gsub("#{device}", "#{@context[:temp_device_name]}")
-        # retrieve the root partition number
-        os_nb = root_device_name.split('/')[2].gsub('sd', '').gsub('xvd', '').gsub(/[a-z]/, '')
-        device = device + os_nb
-        @context[:root_partition_nb] = os_nb
-        post_message("Using root partition: '#{device}'...")
-      end
-      post_message("Using AWS name '#{@context[:temp_device_name]}' and OS name '#{device}'")
-      mount_fs(mount_point, device)
-      # get root partition label and filesystem type
-      #@context[:label] = get_root_partition_label()
-      #@context[:fs_type] = get_root_partition_fs_type()
-      @context[:fs_type], @context[:label] = get_root_partition_fs_type_and_label()
-      disconnect()
-
-      #XXX: go to clean up state
-      #SourceVolumeReadyState.new(@context)
-      AmiRegisteredState.new(@context)      
-    end
-  end
-
-  # Source is ready. Now start instance in the target region
-  class SourceVolumeReadyState < CopyAmiTestState
-    def enter()
-      remote_region()
-      #XXX: create a CloudyScripts Security Group with TCP port 22 publicly opened
-      if @context[:target_security_group] == nil
-        @context[:target_security_group] = Ec2Script::CS_SEC_GRP_NAME
-        create_security_group_with_rules(@context[:target_security_group], Ec2Script::CS_SEC_GRP_DESC, 
-          [{:ip_protocol => "tcp", :from_port => 22, :to_port => 22, :cidr_ip => "0.0.0.0/0"}])
-        post_message("'#{@context[:target_security_group]}' Security Group created with TCP port 22 publicly opened.")
-      end
-
-      result = launch_instance(@context[:target_ami_id], @context[:target_key_name], @context[:target_security_group])
-      @context[:target_instance_id] = result.first
-      @context[:target_dns_name] = result[1]
-      @context[:target_availability_zone] = result[2]
-
-      TargetInstanceLaunchedState.new(@context)
-    end
-  end
-
-  # Destination instance is started. Now configure storage.
-  class TargetInstanceLaunchedState < CopyAmiTestState
-    def enter()
-      local_region()
-      ec2_helper = Ec2Helper.new(@context[:ec2_api_handler])
-      volume_size = ec2_helper.snapshot_prop(@context[:snapshot_id], :volumeSize).to_i
-      #
-      remote_region()
-      @context[:target_volume_id] = create_volume(@context[:target_availability_zone], volume_size)
-      device = @context[:temp_device_name]
-      mount_point = "/mnt/tmp_#{@context[:target_volume_id]}"
-      attach_volume(@context[:target_volume_id], @context[:target_instance_id], device)
-      connect(@context[:target_dns_name], @context[:target_ssh_username], nil, @context[:target_ssh_keydata])
-      # check if we need to create a partition table
-      if !(@context[:partition_table] == nil)
-        post_message("Creating a partition table on device '#{device}'...")
-        set_partition_table(device, @context[:partition_table])
-        #XXX: HANDLE at a LOWER LEVEL
-        # before adding partition table, adjust device name
-        #set_partition_table(device, @context[:partition_table].gsub(/\/dev\/(s|xv)d[a-z]/, "#{@context[:temp_device_name]}"))
-        # adjust partition to mount
-        device = device + @context[:root_partition_nb]
-      end
-      # make root partition
-      create_labeled_fs(@context[:target_dns_name], device, @context[:fs_type], @context[:label])
-      mount_fs(mount_point, device)
-      disconnect()
-
-      TargetVolumeReadyState.new(@context)
-    end
-  end
-
-  # Storages are ready. Only thing missing: the key of the target region
-  # must be available on the instance in the source region to be able to perform
-  # a remote copy.
-  class TargetVolumeReadyState < CopyAmiTestState
-    def enter()
-      post_message("upload key of target-instance to source-instance...")
-      path_candidates = ["/#{@context[:source_ssh_username]}/.ssh/",
-        "/home/#{@context[:source_ssh_username]}/.ssh/"]
-      key_path = determine_file(@context[:source_dns_name], @context[:source_ssh_username], @context[:source_ssh_keydata], path_candidates)
-      #XXX: fix the problem fo key name with white space
-      #upload_file(@context[:source_dns_name], @context[:source_ssh_username], @context[:source_ssh_keydata],
-      #  @context[:target_ssh_keyfile], "#{key_path}#{@context[:target_key_name]}.pem")
-      upload_file(@context[:source_dns_name], @context[:source_ssh_username], @context[:source_ssh_keydata],
-        @context[:target_ssh_keyfile], "#{key_path}#{@context[:target_key_name].gsub(/\s+/, '_')}.pem")
-      post_message("credentials are in place to connect source and target.")
-
-      KeyInPlaceState.new(@context)
-    end
-  end
-
-  # Now we can copy.
-  class KeyInPlaceState < CopyAmiTestState
-    def enter()
-      connect(@context[:target_dns_name], @context[:target_ssh_username], nil, @context[:target_ssh_keydata])
-      disable_ssh_tty(@context[:target_dns_name])
-      disconnect()
-      #
-      connect(@context[:source_dns_name], @context[:source_ssh_username], nil, @context[:source_ssh_keydata])
-      source_dir = "/mnt/tmp_#{@context[:source_volume_id]}/"
-      dest_dir = "/mnt/tmp_#{@context[:target_volume_id]}"
-      #XXX: fix the problem fo key name with white space
-      #remote_copy(@context[:source_ssh_username], @context[:target_key_name], source_dir, 
-      #  @context[:target_dns_name], @context[:target_ssh_username], dest_dir)
-      remote_copy(@context[:source_ssh_username], @context[:target_key_name].gsub(/\s+/, '_'), source_dir, 
-        @context[:target_dns_name], @context[:target_ssh_username], dest_dir)
-      disconnect()
-      #
-      connect(@context[:target_dns_name], @context[:target_ssh_username], nil, @context[:target_ssh_keydata])
-      enable_ssh_tty(@context[:target_dns_name])
-      unmount_fs(dest_dir)
-      disconnect()
-
-      DataCopiedState.new(@context)
-    end
-  end
-
-  # Data of snapshot now copied to the new volume. Create a snapshot of the
-  # new volume.
-  class DataCopiedState < CopyAmiTestState
-    def enter()
-      remote_region()
-      @context[:new_snapshot_id] = create_snapshot(@context[:target_volume_id], 
-        "Created by CloudyScripts - #{self.get_superclass_name()} from #{@context[:target_volume_id]}")
-
-      TargetSnapshotCreatedState.new(@context)
-    end
-  end
-
-  # Snapshot Operation done. Now this snapshot must be registered as AMI
-  class TargetSnapshotCreatedState < CopyAmiTestState
-    def enter()
-      remote_region()
-      # Get Amazon Kernel Image ID
-      aki = get_aws_kernel_image_aki(@context[:source_availability_zone], @context[:kernel_id],
-        @context[:target_availability_zone])
-      device = @context[:root_device_name]
-      if !(@context[:partition_table] == nil)
-        device.gsub!(/[0-9]/, '')
-        post_message("Using BlockDevice for snapshot registration rather than RootDevice '#{device}' due to a valid partition table on device...")
-      end
-      @context[:result][:image_id] = register_snapshot(@context[:new_snapshot_id], @context[:name],
-        device, @context[:description], aki, nil, @context[:architecture])
-
-      AmiRegisteredState.new(@context)
-    end
-  end
-
-  # AMI is registered. Now only cleanup is missing, i.e. shut down instances and
-  # remote the volumes that were created. Start with cleaning the ressources
-  # in the both regions.
-  class AmiRegisteredState < CopyAmiTestState
-    def enter()
-       post_message("Cleaning Source and Target Regions...")
-      error = []
-      local_region()
-      begin
-        shut_down_instance(@context[:source_instance_id])
-      rescue Exception => e
-        error << e
-        post_message("Unable to shutdown instance '#{@context[:source_instance_id]}' in source region: #{e.to_s}")
-      end
-      begin
-        delete_volume(@context[:source_volume_id])
-      rescue Exception => e
-        error << e
-        post_message("Unable to delete volume '#{@context[:source_volume_id]}' in source region: #{e.to_s}")
-      end
-      begin
-        delete_snapshot(@context[:snapshot_id])
-      rescue Exception => e
-        error << e
-        post_message("Unable to delete snapshot '#{@context[:snapshot_id]}' in source region: #{e.to_s}")
-      end
-      #XXX: delete Security Group according to its name
-      if @context[:source_security_group].eql?(Ec2Script::CS_SEC_GRP_NAME)
-        begin
-          delete_security_group(@context[:source_security_group])
-        rescue Exception => e
-          error << e
-          post_message("Unable to delete Security Group '#{@context[:source_security_group]}' in source region: #{e.to_s}")
-        end
-      end
-      #
-      remote_region()
-      begin
-        shut_down_instance(@context[:target_instance_id])
-      rescue Exception => e
-        error << e
-        post_message("Unable to shutdown instance '#{@context[:target_instance_id]}' in target region: #{e.to_s}")
-      end
-      begin
-        delete_volume(@context[:target_volume_id])
-      rescue Exception => e
-        error << e
-        post_message("Unable to delete volume '#{@context[:target_volume_id]}' in target region: #{e.to_s}")
-      end
-      #XXX: delete Security Group according to its name
-      if @context[:target_security_group].eql?(Ec2Script::CS_SEC_GRP_NAME)
-        begin
-          delete_security_group(@context[:target_security_group])
-        rescue
-          error << e
-          post_message("Unable to delete Security Group '#{@context[:target_security_group]}' in target region: #{e.to_s}")
-        end
-      end
-
-      if error.size() > 0
-        raise Exception.new("Cleanup error(s)")
-      end
-
-      Done.new(@context)
-    end
-  end
-
-end