openstudio-aws 0.3.1 → 0.3.2

data/lib/openstudio/aws/config.rb

@@ -1,38 +1,57 @@
 module OpenStudio
   module Aws
     class Config
+      include Logging
+
       attr_accessor :access_key
       attr_accessor :secret_key
 
       def initialize(yml_config_file = nil)
-        @yml_config_file = yml_config_file
-        @config = nil
+        # If the AWS keys are set in the env variable and the yml_config_file is nil, then use those keys
+        @access_key = ENV['AWS_ACCESS_KEY_ID'] if ENV['AWS_ACCESS_KEY_ID']
+        @secret_key = ENV['AWS_SECRET_ACCESS_KEY'] if ENV['AWS_SECRET_ACCESS_KEY']
+
+        if @access_key && @secret_key && yml_config_file.nil?
+          logger.info 'Using AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY from environment variables'
+        else
+          # Otherwise read the file
+          logger.info 'Reading AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY from aws config file'
+
+          @yml_config_file = yml_config_file
+          @config = nil
+
+          @yml_config_file = File.join(File.expand_path('~'), 'aws_config.yml') if @yml_config_file.nil?
 
-        if @yml_config_file.nil?
-          @yml_config_file = File.join(File.expand_path('~'), 'aws_config.yml')
           unless File.exist?(@yml_config_file)
             write_config_file
-            fail "No Config File in user home directory. A template has been added, please edit and save: #{@yml_config_file}"
+            fail "Config file not found. A template has been added, please edit and save: #{@yml_config_file}"
             exit 1
           end
-        end
 
-        begin
-          @config = YAML.load(File.read(@yml_config_file))
-          @access_key = @config['access_key_id']
-          @secret_key = @config['secret_access_key']
-        rescue
-          raise "Couldn't read config file #{@yml_config_file}. Delete file then recreate by rerunning script"
+          begin
+            @config = YAML.load(File.read(@yml_config_file))
+
+            # always convert to symbolized hash
+            @config = @config.inject({}) { |a, (k, v)| a[k.to_sym] = v; a }
+
+            @access_key = @config[:access_key_id]
+            @secret_key = @config[:secret_access_key]
+          rescue
+            raise "Couldn't read config file #{@yml_config_file}. Delete file then recreate by rerunning script"
+          end
         end
       end
 
       private
 
       def write_config_file
-        File.open(@yml_config_file, 'w') do |f|
-          f << "access_key_id: YOUR_ACCESS_KEY_ID\n"
-          f << "secret_access_key: YOUR_SECRET_ACCESS_KEY\n"
-        end
+        # create the file
+        data = {
+          access_key_id: 'YOUR_ACCESS_KEY_ID',
+          secret_access_key: 'YOUR_SECRET_ACCESS_KEY'
+        }
+
+        File.open(@yml_config_file, 'w') { |f| f << data.to_yaml }
       end
     end
   end

data/lib/openstudio/aws/version.rb

@@ -1,5 +1,5 @@
 module OpenStudio
   module Aws
-    VERSION = '0.3.1'
+    VERSION = '0.3.2'
   end
 end

data/lib/openstudio/lib/ami_list.rb

@@ -22,38 +22,61 @@
 
 class OpenStudioAmis
   VALID_OPTIONS = [
-    :openstudio_version, :openstudio_server_version, :host, :url
+    :openstudio_version, :openstudio_server_version, :host, :url, :stable
   ]
 
+  # Initializer for listing the AMIs and grabbing the correct version of the AMIs based on the OpenStudio version or
+  # OpenStudio Server version.
+  #
+  # @param version [Double] Version of the JSON to return. Currently only version 1 or 2
+  # @param options [Hash] Values to operate on
+  # @option options [String] :openstudio_version Version of OpenStudio to perform the AMI lookup
+  # @option options [String] :openstudio_server_version Version of the OpenStudio to perform the AMI lookup
   def initialize(version = 1, options = {})
     invalid_options = options.keys - VALID_OPTIONS
     if invalid_options.any?
       fail ArgumentError, "invalid option(s): #{invalid_options.join(', ')}"
     end
 
+    if options[:openstudio_version] && options[:openstudio_server_version]
+      fail 'Must pass only an openstudio_version or openstudio_server_version when looking up AMIs'
+    end
+
     # merge in some defaults
     defaults = {
       openstudio_version: 'default',
       openstudio_server_version: 'default',
-      host: 'developer.nrel.gov',
-      url: '/downloads/buildings/openstudio/api'
+      # host: 'developer.nrel.gov',
+      # url: '/downloads/buildings/openstudio/api'
+      host: 's3.amazonaws.com',
+      url: '/openstudio-resources/server/api'
     }
+
     @version = version
     @options = defaults.merge(options)
+
+    if @options[:openstudio_version] != 'default' && @options[:openstudio_server_version] != 'default'
+      fail 'Must pass either the openstudio_version or openstudio_server_version when looking up AMIs, not both'
+    end
   end
 
+  # List the AMIs based on the version and host. This method does catch old 'developer.nrel.gov' hosts and formats
+  # the endpoint using the old '<host>/<url>/amis_#{version}.json' instead of the new, more restful, syntax of
+  # <host>/<url>/v#{version}/amis.json
   def list
-    json = nil
-    command = "list_amis_version_#{@version}"
-    if OpenStudioAmis.method_defined?(command)
-      json = send(command)
+    endpoint = nil
+
+    # for backwards compatibility with developer
+    if @options[:host] =~ /developer.nrel/
+      endpoint = "#{@options[:url]}/amis_v#{@version}.json"
     else
-      fail "Unknown api version command #{command}"
+      endpoint = "#{@options[:url]}/v#{@version}/amis.json"
     end
 
-    json
+    retrieve_json(endpoint)
   end
 
+  # Return the AMIs for the specific openstudio_version or openstudio_server_version
   def get_amis
     amis = nil
     command = "get_ami_version_#{@version}"
@@ -70,43 +93,37 @@ class OpenStudioAmis
 
   protected
 
-  def list_amis_version_1
-    endpoint = "#{@options[:url]}/amis_v1.json"
-    json = retrieve_json(endpoint)
-
-    json
-  end
-
-  def list_amis_version_2
-    endpoint = "#{@options[:url]}/amis_v2.json"
-
-    json = retrieve_json(endpoint)
-    json
-  end
-
   def get_ami_version_1
-    json = list_amis_version_1
+    json = list
     version = json.key?(@options[:openstudio_version].to_sym) ? @options[:openstudio_version].to_sym : 'default'
 
     json[version]
   end
 
   def get_ami_version_2
-    json = list_amis_version_2
+    json = list
 
     amis = nil
-    if @options[:openstudio_server_version].to_sym == :default
-      # just grab the most recent server
-      # need to do a sort to get the most recent because we can't promise that they are in order
-      json[:openstudio].each do |_k, _v|
-      end
+    if @options[:openstudio_version].to_sym == :default && @options[:openstudio_server_version].to_sym == :default
+      # grab the most recent openstudio server version - this is not recommended
       key, value = json[:openstudio_server].first
-
       amis = value[:amis]
-      # puts json.inspect
-    else
+    elsif @options[:openstudio_server_version] != 'default'
       value = json[:openstudio_server][@options[:openstudio_server_version].to_sym]
       amis = value[:amis]
+    elsif @options[:openstudio_version] != 'default'
+      if @options[:stable]
+        stable = json[:openstudio][@options[:openstudio_version].to_sym][:stable]
+        fail "Could not find a stable version for openstudio version #{@options[:openstudio_version]}" unless stable
+        value = json[:openstudio][@options[:openstudio_version].to_sym][stable.to_sym]
+        amis = value[:amis]
+      else
+        # return the default version (which is the latest)
+        default = json[:openstudio][@options[:openstudio_version].to_sym][:default]
+        fail "Could not find a default version for openstudio version #{@options[:openstudio_version]}" unless default
+        value = json[:openstudio][@options[:openstudio_version].to_sym][default.to_sym]
+        amis = value[:amis]
+      end
     end
 
     amis

data/lib/openstudio/lib/ami_stable_version.json

@@ -0,0 +1,6 @@
+{
+  "openstudio": {
+    "1.7.1": "1.11.0-rc3",
+    "1.7.0": "1.10.0-rc2"
+  }
+}

data/lib/openstudio/lib/openstudio_aws_instance.rb

@@ -36,7 +36,7 @@ class OpenStudioAwsInstance
     @key_pair_name = key_pair_name
     @security_groups = security_groups
     @group_uuid = group_uuid.to_s
-    @init_timestamp = Time.now  # This is the timestamp and is typically just tracked for the server
+    @init_timestamp = Time.now # This is the timestamp and is typically just tracked for the server
     @private_key = private_key
     @private_key_file_name = private_key_file_name
     @proxy = proxy
@@ -270,8 +270,6 @@ class OpenStudioAwsInstance
     processors = 1
     if lookup.key?(instance)
       processors = lookup[instance]
-    else
-      # logger.warn "Could not find the number of processors for instance type of #{instance}" if logger
     end
 
     if @openstudio_instance_type == :server
@@ -393,7 +391,7 @@ class OpenStudioAwsInstance
   rescue SystemCallError, Timeout::Error => e
     # port 22 might not be available immediately after the instance finishes launching
     sleep 10
-    logger.info('Timeout.  Perhaps there is a communication error to EC2?  Will try again')
+    logger.info('Timeout.  Perhaps there is a communication error to EC2?  Will try again in 10 seconds')
     retry
   end
 

data/lib/openstudio/lib/openstudio_aws_wrapper.rb

@@ -54,7 +54,7 @@ class OpenStudioAwsWrapper
   VALID_OPTIONS = [:proxy, :credentials]
 
   def initialize(options = {}, group_uuid = nil)
-    @group_uuid = group_uuid || (SecureRandom.uuid).gsub('-', '')
+    @group_uuid = group_uuid || (SecureRandom.uuid).delete('-')
 
     @security_groups = []
     @key_pair_name = nil
@@ -449,7 +449,6 @@ class OpenStudioAwsWrapper
     amis = transform_ami_lists(existing_amis, available_amis)
 
     if version == 1
-      puts 'Creating version 1 of the AMI file'
       version1 = {}
 
       # now grab the good keys - they should be sorted newest to older... so go backwards
@@ -462,19 +461,31 @@ class OpenStudioAwsWrapper
       end
 
       # create the default version. First sort, then grab the first hash's values
-
       version1.sort_by
       default_v = nil
       version1 = Hash[version1.sort_by { |k, _| k.to_s.to_version }.reverse]
       default_v = version1.keys[0]
 
       version1[:default] = version1[default_v]
-      puts "Pretty version 1: #{JSON.pretty_generate(version1)}"
-
       amis = version1
     elsif version == 2
-      # don't need to transform anything right now
-      puts "Pretty version 2: #{JSON.pretty_generate(amis)}"
+      # don't need to transform anything right now, only flag which ones are stable version so that the uploaded ami JSON has the
+      # stable server for OpenStudio PAT to use.
+      stable = JSON.parse File.read(File.join(File.dirname(__FILE__), 'ami_stable_version.json')), symbolize_names: true
+      # go through and tag the versions of the openstudio instances that are stable
+
+      stable[:openstudio].each do |k, v|
+        if amis[:openstudio][k.to_s] && amis[:openstudio][k.to_s][v.to_sym]
+          amis[:openstudio][k.to_s][:stable] = v
+        end
+      end
+
+      k, v = stable[:openstudio].first
+      if k && v
+        if amis[:openstudio][k.to_s]
+          amis[:openstudio][:default] = v
+        end
+      end
     end
 
     amis

data/lib/openstudio/lib/server_script.sh.template

@@ -44,12 +44,28 @@ chmod 775 /usr/local/bin/ec2-metadata
 mkdir -p /etc/openstudio-server
 ec2-metadata -a -i -t -h -o -z -p -v > /etc/openstudio-server/instance.yml
 
+# make sure supervisor is running
+sudo service supervisor start
+
 # stop the various services that use mongo
 service delayed_job stop
+supervisorctl stop delayed_job
 service apache2 stop
 service mongodb stop
 service mongod stop
 
+# make sure the the /mnt directory exists if i2 instances.
+# For now this assumes that the volume is xvdb. In the future this
+# should be dynamic
+if ec2-metadata --instance-type | grep -q 'i2.'; then
+  mkfs.ext4 /dev/xvdb
+  mkdir -p /mnt
+  mount -t ext4 /dev/xvdb /mnt
+
+  echo "/dev/xvdb /mnt auto noatime 0 0" | sudo tee -a /etc/fstab
+  mount -a
+fi
+
 # remove mongo db & add it back
 mkdir -p /mnt/mongodb/data
 chown mongodb:nogroup /mnt/mongodb/data
@@ -118,9 +134,11 @@ find /mnt/openstudio -type f -print0 | xargs -0 chmod 664
 
 # restart rserve
 service Rserve restart
+supervisorctl restart Rserve
 
-# restart delayed jobs
+# start delayed jobs
 service delayed_job start
+supervisorctl start delayed_job
 
 #file flag the user_data has completed
 cat /dev/null > /home/ubuntu/user_data_done

data/lib/openstudio/lib/worker_script.sh.template

@@ -35,6 +35,18 @@ chmod 775 /usr/local/bin/ec2-metadata
 mkdir -p /etc/openstudio-server
 ec2-metadata -a -i -t -h -o -z -p -v > /etc/openstudio-server/instance.yml
 
+# make sure the the /mnt directory exists if i2 instances.
+# For now this assumes that the volume is xvdb. In the future this
+# should be dynamic
+if ec2-metadata --instance-type | grep -q 'i2.'; then
+  mkfs.ext4 /dev/xvdb
+  mkdir -p /mnt
+  mount -t ext4 /dev/xvdb /mnt
+
+  echo "/dev/xvdb /mnt auto noatime 0 0" | sudo tee -a /etc/fstab
+  mount -a
+fi
+
 ## Worker Data Configuration -- On Vagrant this is a separate file
 
 rm -f /tmp/snow.log
@@ -63,14 +75,11 @@ find /mnt/openstudio -type f -print0 | xargs -0 chmod 664
 
 ## End Worker Data Configuration
 
-#turn off hyperthreading
-# NL: do not turn off hyperthreading, rather, just limit the number of cores and see if it
-# makes a difference.
-#for cpunum in $(
-#  cat /sys/devices/system/cpu/cpu*/topology/thread_siblings_list |
-#  cut -s -d, -f2- | tr ',' '\n' | sort -un); do
-#    echo 0 > /sys/devices/system/cpu/cpu$cpunum/online
-#done
+# make sure supervisor is running
+sudo service supervisor start
+
+# Rserve is now on the worker nodes for use by measures
+supervisorctl restart Rserve
 
 #file flag the user_data has completed
 cat /dev/null > /home/ubuntu/user_data_done

data/lib/openstudio-aws.rb

@@ -1,6 +1,7 @@
 require 'json'
 require 'net/scp'
 require 'net/http'
+require 'net/ssh/proxy/http'
 require 'yaml'
 require 'logger'
 require 'securerandom'
@@ -8,6 +9,7 @@ require 'semantic'
 require 'semantic/core_ext'
 require 'fileutils'
 require 'sshkey'
+
 # AWS SDK CORE
 begin
   require 'aws-sdk-core'

data/openstudio-aws.gemspec

@@ -0,0 +1,32 @@
+lib = File.expand_path('../lib/', __FILE__)
+$LOAD_PATH.unshift lib unless $LOAD_PATH.include?(lib)
+
+require 'openstudio/aws/version'
+
+Gem::Specification.new do |s|
+  s.name = 'openstudio-aws'
+  s.version = OpenStudio::Aws::VERSION
+  s.platform = Gem::Platform::RUBY
+  s.authors = ['Nicholas Long']
+  s.email = ['Nicholas.Long@nrel.gov']
+  s.homepage = 'http://openstudio.nrel.gov'
+  s.summary = 'Start AWS EC2 instances for running distributed OpenStudio-based analyses'
+  s.description = 'Custom classes for configuring clusters for OpenStudio & EnergyPlus analyses'
+  s.license = 'LGPL'
+
+  s.required_ruby_version = '>= 1.9.1'
+  s.required_rubygems_version = '>= 1.3.6'
+
+  s.add_dependency 'net-scp', '~> 1.1'
+  s.add_dependency 'aws-sdk-core', '~> 2.0'
+  s.add_dependency 'semantic', '~> 1.3'
+  s.add_dependency 'sshkey', '~> 1.6'
+
+  s.add_development_dependency 'bundler', '~> 1.7'
+  s.add_development_dependency 'rake', '~> 10.4'
+
+  s.files         = `git ls-files -z`.split("\x0")
+  s.executables   = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  s.test_files    = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ['lib']
+end

data/spec/aws_instances/aws_spec_api.rb

@@ -165,7 +165,7 @@ describe OpenStudio::Aws::Aws do
 
         @group_id = h[:group_id]
       ensure
-        @aws.terminate_instances_by_group_id(h[:group_id], :server)
+        @aws.terminate_instances_by_group_id(h[:group_id])
       end
     end
   end
@@ -206,9 +206,50 @@ describe OpenStudio::Aws::Aws do
           expect(h[:group_id]).to match /^[\d\S]{32}$/
           expect(h[:location]).to eq 'AWS'
         ensure
-          @aws.terminate_instances_by_group_id(h[:group_id], :server)
+          @aws.terminate_instances_by_group_id(h[:group_id])
         end
       end
     end
   end
+
+  context 'i2-instances' do
+    before :all do
+      @config = OpenStudio::Aws::Config.new
+      @aws = OpenStudio::Aws::Aws.new
+
+      @group_id = nil
+    end
+
+    it 'should create an i2 instance and mount the storage' do
+      begin
+        options = {
+          instance_type: 'i2.xlarge',
+          image_id: SERVER_AMI,
+          tags: [
+            'ci_tests=true',
+            'ServerOnly=true'
+          ]
+        }
+
+        expect { @aws.create_workers(0) }.to raise_error "Can't create workers without a server instance running"
+
+        test_pem_file = 'ec2_server_key.pem'
+        FileUtils.rm_f test_pem_file if File.exist? test_pem_file
+        FileUtils.rm_f 'server_data.json' if File.exist? 'server_data.json'
+
+        @aws.create_server(options)
+
+        # Still have to call "create workers" or the configuration won't happen.
+        @aws.create_workers(0, options)
+
+        h = @aws.os_aws.server.to_os_hash
+
+        shell = @aws.server.shell_command('df -h | grep /dev/xvdb.*/mnt')
+        expect(shell).not_to be_nil
+        expect(shell).to eq /\/dev\/xvdb.*\/mnt/
+      ensure
+        @aws.terminate_instances_by_group_id(h[:group_id])
+      end
+    end
+  end
 end

data/spec/openstudio-aws/ami_list_spec.rb

@@ -9,10 +9,8 @@ describe OpenStudioAmis do
       expect(amis[:server]).not_to be_nil
       expect(amis[:worker]).not_to be_nil
 
-      # From OpenStudio Version 1.5.0 expect cc2workers to be the same as the worker
-      expect(amis[:cc2worker]).not_to be_nil
-      expect(amis[:worker]).to eq amis[:cc2worker]
-      puts amis.inspect
+      # From OpenStudio Version 1.5.0 expect cc2workers to be null
+      expect(amis[:cc2worker]).to be_nil
     end
 
     it 'should return specific amis if passed a version' do
@@ -33,7 +31,7 @@ describe OpenStudioAmis do
   end
 
   context 'version 2' do
-    it 'should return 1.8.0 versions correctly' do
+    it 'should return openstudio server version 1.8.0 correctly' do
       a = OpenStudioAmis.new(2, openstudio_server_version: '1.8.0')
 
       amis = a.get_amis
@@ -43,4 +41,39 @@ describe OpenStudioAmis do
       expect(amis[:cc2worker]).to eq('ami-040ebe6c')
     end
   end
+
+  context 'version 2' do
+    it 'should return openstudio version 1.7.1 stable & default versions correctly' do
+      a = OpenStudioAmis.new(2, openstudio_version: '1.7.1')
+
+      amis = a.get_amis
+
+      expect(amis[:server]).to eq('ami-845a54ec')
+      expect(amis[:worker]).to eq('ami-3a5a5452')
+    end
+
+    it 'should return openstudio version 1.7.0 default version correctly' do
+      a = OpenStudioAmis.new(2, openstudio_version: '1.7.0')
+
+      amis = a.get_amis
+
+      expect(amis[:server]).to eq('ami-725b701a')
+      expect(amis[:worker]).to eq('ami-4a446f22')
+    end
+
+    it 'should return openstudio version 1.7.0 stable version correctly' do
+      a = OpenStudioAmis.new(2, openstudio_version: '1.7.0', stable: true)
+
+      amis = a.get_amis
+
+      expect(amis[:server]).to eq('ami-c06b40a8')
+      expect(amis[:worker]).to eq('ami-9a97bff2')
+    end
+
+    it 'should fail when trying to find a stable version for older releases' do
+      a = OpenStudioAmis.new(2, openstudio_version: '1.5.0', stable: true)
+
+      expect { a.get_amis }.to raise_error(/Could not find a stable version for openstudio version 1.5.0/)
+    end
+  end
 end

data/spec/openstudio-aws/aws_spec.rb

@@ -15,7 +15,11 @@ describe OpenStudio::Aws::Aws do
 
     it 'should allow a different region' do
       options = {
-        ami_lookup_version: 2
+        ami_lookup_version: 2,
+        credentials: {
+          access_key_id: 'some_random_access_key_id',
+          secret_access_key: 'some_super_secret_access_key'
+        }
       }
       aws = OpenStudio::Aws::Aws.new(options)
 
@@ -64,7 +68,7 @@ describe OpenStudio::Aws::Aws do
       }
       aws = OpenStudio::Aws::Aws.new
 
-      expect { aws.create_server(options) }.to raise_error /Private key was not found.*/
+      expect { aws.create_server(options) }.to raise_error(/Private key was not found.*/)
     end
 
     it 'should require a private key' do
@@ -125,4 +129,15 @@ describe OpenStudio::Aws::Aws do
       expect(@aws.os_aws.proxy).to eq(options[:proxy])
     end
   end
+
+  context 'availability zones' do
+    it 'should describe the availability zones' do
+      options = {}
+      aws = OpenStudio::Aws::Aws.new(options)
+      az = aws.describe_availability_zones
+
+      expect(az[:availability_zone_info]).to be_an Array
+      expect(az[:availability_zone_info].first[:zone_name]).to eq 'us-east-1a'
+    end
+  end
 end

data/spec/openstudio-aws/aws_wrapper_spec.rb

@@ -1,10 +1,11 @@
+# This spec file contains the testing of OpenStudio specific tests (for AMI listing) which require an AWS account and authentication
 require 'spec_helper'
 
 describe OpenStudioAwsWrapper do
   context 'unauthenticated session' do
     it 'should fail to authenticate' do
       options = {
-        credentials:             {
+        credentials: {
           access_key_id: 'some_random_access_key_id',
           secret_access_key: 'some_super_secret_access_key',
           region: 'us-east-1',
@@ -102,7 +103,6 @@ describe OpenStudioAwsWrapper do
 
     it 'should create security group' do
       sg = @aws.os_aws.create_or_retrieve_default_security_group
-      pp sg
       expect(sg).to_not be nil
     end
   end

data/spec/openstudio-aws/config_spec.rb

@@ -6,5 +6,49 @@ describe OpenStudio::Aws::Config do
       @config = OpenStudio::Aws::Config.new
       expect(@config).not_to be_nil
     end
+
+    it 'should create a new file' do
+      local_file = 'test.config'
+      File.delete local_file if File.exist? local_file
+
+      expect { OpenStudio::Aws::Config.new local_file }.to raise_error /Config file not found. A template has been added, please edit and save: test.config/
+      expect(File.exist?(local_file)).to eq true
+
+      # read the file and make sure that the template is there
+      config = YAML.load(File.read(local_file))
+      expect(config[:access_key_id]).to eq 'YOUR_ACCESS_KEY_ID'
+      expect(config[:secret_access_key]).to eq 'YOUR_SECRET_ACCESS_KEY'
+    end
+
+    it 'should read old format' do
+      # make sure that we can read the old format which has non-symoblized keys
+      local_file = 'test_custom_old.config'
+
+      data = {
+        'access_key_id' =>  'abcd',
+        'secret_access_key' => 'efgh'
+      }
+
+      File.open(local_file, 'w') { |f| f << data.to_yaml }
+      config = OpenStudio::Aws::Config.new local_file
+      expect(config.access_key).to eq 'abcd'
+      expect(config.secret_key).to eq 'efgh'
+    end
+
+    it 'should read a custom file' do
+      local_file = 'test_custom.config'
+
+      # create the file
+      data = {
+        access_key_id: 'random_key',
+        secret_access_key: 'random_secret_key'
+      }
+
+      File.open(local_file, 'w') { |f| f << data.to_yaml }
+
+      config = OpenStudio::Aws::Config.new local_file
+      expect(config.access_key).to eq 'random_key'
+      expect(config.secret_key).to eq 'random_secret_key'
+    end
   end
 end