ilorb 0.0.1

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,47 @@
+PATH
+  remote: .
+  specs:
+    ilorb (0.0.1)
+      nokogiri
+      nori
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.5)
+    coderay (1.0.9)
+    crack (0.4.1)
+      safe_yaml (~> 0.9.0)
+    diff-lcs (1.2.4)
+    method_source (0.8.1)
+    mini_portile (0.5.0)
+    nokogiri (1.6.0)
+      mini_portile (~> 0.5.0)
+    nori (2.2.0)
+    pry (0.9.12.2)
+      coderay (~> 1.0.5)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.3)
+    rspec-expectations (2.14.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.1)
+    safe_yaml (0.9.4)
+    slop (3.4.5)
+    webmock (1.13.0)
+      addressable (>= 2.2.7)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.2)
+  ilorb!
+  pry
+  rspec (~> 2.14)
+  webmock (~> 1.13)

data/README.md

@@ -0,0 +1,98 @@
+# ILORb
+
+ILORb is a library created to ease interaction with HP servers baseboard management cards (ILO), using their XML interface.
+
+It is primarily meant to integrate with Chef config management system, but it can of course be used standalone.
+
+It supports RIB, SERVER and USER commands for ILO 2, 3 and 4 (no other hardware to test on).
+
+ * By default, it will try to query the BMC through HTTP POST (available from ILO version 3)
+ * It will fall back to raw XML through TCP socket (SSL-wrapped) for earlier ILO versions
+
+Supported commands and parameters are defined using a little DSL, under [definitions](lib/ilorb/definitions), sorted by "context".
+
+
+HP, Integrated Lights Out and iLO are trademarks of HP, with whom the author of this software is not affiliated in any way other than using some of their hardware.
+
+## Examples
+
+```ruby
+require 'json'
+require 'ilorb'
+
+ilo = ILORb::ILO.new(
+  :hostname => "10.200.0.1",
+  :login => "Admin",
+  :password => "SECRET",
+#  :protocol => :raw, # for old ILOs, defaults to :http
+)
+
+result = ilo.get_network_settings
+puts JSON.pretty_generate(result)
+```
+generates and sends :
+
+```xml
+<?xml version="1.0"?>
+<ribcl version="2.0">
+  <login password="SECRET" user_login="Admin">
+    <rib_info mode="read">
+      <get_network_settings/>
+    </rib_info>
+  </login>
+</ribcl>
+```
+result:
+```json
+{
+  "status": {
+    "code": 0,
+    "message": "No error"
+  },
+  "get_network_settings": {
+    "enable_nic": {
+      "@value": "Y"
+    },
+    "shared_network_port": {
+      "@value": "N"
+    },
+    "vlan_enabled": {
+      "@value": "N"
+    },
+    "vlan_id": {
+      "@value": "0"
+    },
+    "speed_autoselect": {
+      "@value": "Y"
+    },
+    "dhcp_enable": {
+      "@value": "N"
+    },
+    { ... }
+  }
+}
+```
+
+## TODO
+
+  * Tests
+  * Use a custom parser instead of Nori, to avoid one-element-hashes and cast responses to actual objects (e.g Y/N to true/false)
+  * See for mandatory parameters
+  * Add a CLI tool
+
+## Setup
+
+Only tested with MRI >= 1.9.3
+
+Dependencies:
+ * nokogiri
+ * nori
+
+Install:
+ * git clone https://github.com/josqu4red/ilorb
+OR
+ * gem install ilorb (soon)
+
+## Credits
+
+ilorb is inspired by [python-hpilo](https://github.com/seveas/python-hpilo)

data/ilorb.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'ilorb/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "ilorb"
+  spec.version       = ILORb::VERSION
+  spec.authors       = ["Jonathan Amiez"]
+  spec.email         = ["jonathan.amiez@gmail.com"]
+  spec.description   = "HP ILO Ruby interface"
+  spec.summary       = "Configure and retrieve data from server's ILO management card"
+  spec.homepage      = "https://github.com/josqu4red/ilorb"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.2"
+  spec.add_development_dependency "rspec", "~> 2.14"
+  spec.add_development_dependency "webmock", "~> 1.13"
+  spec.add_development_dependency "pry"
+  spec.add_dependency "nokogiri"
+  spec.add_dependency "nori"
+end

data/lib/ilorb/definitions/rib.rb

@@ -0,0 +1,102 @@
+context :rib_info do
+  read_cmd :get_ahs_status
+  read_cmd :get_all_languages
+  read_cmd :get_all_licenses
+  read_cmd :get_asset_tag
+  read_cmd :get_ers_settings
+  read_cmd :get_event_log
+  read_cmd :get_fips_status
+  read_cmd :get_fw_version
+  read_cmd :get_global_settings
+  read_cmd :get_hotkey_config
+  read_cmd :get_language
+  read_cmd :get_all_languages
+  read_cmd :get_network_settings
+  read_cmd :get_security_msg
+  read_cmd :get_snmp_im_settings
+  read_cmd :get_spatial
+  read_cmd :get_vm_status do
+    attributes :device
+  end
+  read_cmd :profile_apply_get_results do
+    not_implemented
+  end
+  read_cmd :profile_list do
+    not_implemented
+  end
+
+  write_cmd :ahs_clear_data
+  write_cmd :brownout_recovery # > mod_global_settings
+  write_cmd :certificate_signing_request
+  write_cmd :clear_eventlog
+  write_cmd :computer_lock do
+    not_implemented
+  end
+  write_cmd :disable_ers
+  write_cmd :eject_virtual_media do
+    attributes :device
+  end
+  write_cmd :factory_defaults
+  write_cmd :fips_enable
+  write_cmd :hotkey_config do
+    not_implemented
+  end
+  write_cmd :import_certificate do #TODO
+    not_implemented
+    text :certificate
+  end
+  write_cmd :insert_virtual_media do
+    attributes :device, :image_url
+  end
+  write_cmd :license do
+    elements :activate => :key
+  end
+  write_cmd :mod_global_settings do #TODO
+    not_implemented
+  end
+  write_cmd :mod_network_settings do #TODO
+    not_implemented
+  end
+  write_cmd :mod_snmp_im_settings do #TODO
+    not_implemented
+  end
+  write_cmd :profile_apply do
+    not_implemented
+  end
+  write_cmd :profile_delete do
+    not_implemented
+  end
+  write_cmd :profile_desc_download do
+    not_implemented
+  end
+  write_cmd :reset_rib
+  write_cmd :set_ahs_status do
+    attributes :value
+  end
+  write_cmd :set_asset_tag do
+    attributes :value
+  end
+  write_cmd :set_ers_irs_connect do
+    elements :ers_destination_url, :ers_destination_port
+  end
+  write_cmd :set_language do
+    attributes :lang_id
+  end
+  write_cmd :set_security_msg do
+    not_implemented
+    elements :security_msg, :security_msg_text => :cdata
+  end
+  write_cmd :set_vm_status do
+    attributes :device
+    elements :vm_boot_option, :vm_write_protect
+  end
+  write_cmd :trigger_l2_collection do
+    not_implemented
+  end
+  write_cmd :trigger_test_event do
+    not_implemented
+  end
+  write_cmd :update_firmware do #TODO
+    not_implemented
+  end
+end

data/lib/ilorb/definitions/server.rb

@@ -0,0 +1,51 @@
+context :server_info do
+  read_cmd :get_embedded_health
+  read_cmd :get_host_power_saver_status
+  read_cmd :get_host_power_status
+  read_cmd :get_host_pwr_micro_ver
+  read_cmd :get_one_time_boot
+  read_cmd :get_persistent_boot
+  read_cmd :get_power_cap
+  read_cmd :get_power_readings
+  read_cmd :get_pwreg
+  read_cmd :get_server_auto_pwr
+  read_cmd :get_server_name
+  read_cmd :get_server_power_on_time
+  read_cmd :get_uid_status
+
+  write_cmd :clear_server_power_on_time
+  write_cmd :cold_boot_server
+  write_cmd :hold_pwr_btn do
+    attributes :toggle
+  end
+  write_cmd :press_power_btn
+  write_cmd :reset_server
+  write_cmd :server_auto_pwr do
+    attributes :value
+  end
+  write_cmd :server_name do
+    attributes :value
+  end
+  write_cmd :set_host_power do
+    attributes :host_power
+  end
+  write_cmd :set_host_power_saver do
+    attributes :host_power_saver
+  end
+  write_cmd :set_one_time_boot do
+    attributes :value
+  end
+  write_cmd :set_persistent_boot do
+    elements :device => [ :value ]
+  end
+  write_cmd :set_power_cap do
+    attributes :power_cap
+  end
+  write_cmd :set_pwreg do
+    elements :pwralert => :type, :pwralert_settings => [:threshold, :duration]
+  end
+  write_cmd :uid_control do
+    attributes :uid
+  end
+  write_cmd :warm_boot_server
+end

data/lib/ilorb/definitions/user.rb

@@ -0,0 +1,19 @@
+context :user_info do
+  read_cmd :get_user do
+    attributes :user_login
+  end
+  read_cmd :get_all_users
+  read_cmd :get_all_user_info
+
+  write_cmd :add_user do
+    attributes :user_name, :user_login, :password
+    elements :admin_priv, :remote_cons_priv, :reset_server_priv, :virtual_media_priv, :config_ilo_priv
+  end
+  write_cmd :delete_user do
+    attributes :user_login
+  end
+  write_cmd :mod_user do
+    attributes :user_login
+    elements :user_name, :user_login, :password, :admin_priv, :remote_cons_priv, :reset_server_priv, :virtual_media_priv, :config_ilo_priv, :del_users_ssh_key
+  end
+end

data/lib/ilorb/ilo.rb

@@ -0,0 +1,207 @@
+require 'logger'
+require 'socket'
+require 'openssl'
+require 'net/https'
+require 'nokogiri'
+require 'nori'
+
+module ILORb
+
+  class NotImplemented < StandardError; end
+
+  class ILO
+    def initialize(config = {})
+      @hostname = config[:hostname]
+      @login = config[:login] || "Administrator"
+      @password = config[:password]
+      @port = config[:port] || 443
+      @protocol = config[:protocol] || :http
+      @verify_ssl = config[:verify_ssl] || false
+      @ribcl_path = "/ribcl"
+
+      @log = Logger.new(STDOUT)
+      @log.level = config[:debug] ? Logger::DEBUG : Logger::WARN
+
+      @nori = Nori.new(:convert_tags_to => lambda{|tag| tag.downcase.to_sym})
+
+      setup_commands
+    end
+
+    # args should be empty or contain a hash anytime
+    def method_missing(name, *args, &block)
+      if @ribcl.has_command?(name)
+        command = @ribcl.command(name)
+
+        raise NotImplemented, "#{name} is not supported" unless command.supported?
+
+        params = args.first || {}
+        attributes = {}
+        element_map = nil
+
+        #TODO check for text
+
+        command.get_attributes.each do |attr|
+          # Attributes are mandatory
+          error("Attribute #{attr} missing in #{name} call") unless params.has_key?(attr)
+          attributes.store(attr, @ribcl.encode(params.delete(attr)))
+        end
+
+        element_map = command.map_elements
+
+        elements_array = []
+
+        [ params ].flatten.each do |params_hash|
+          elements = {}
+          params_hash.each do |key, value|
+            # Elements are not mandatory for now
+            elements.store(key, @ribcl.encode(params_hash.delete(key))) if element_map.has_key?(key)
+          end
+          elements_array << elements
+        end
+
+        #TODO check for CDATA
+
+        @log.info("Calling method #{name}")
+        request = ribcl_request(command, attributes) do |xml|
+          elements_array.each do |elements_hash|
+            elements_hash.each do |key, value|
+              elt = command.get_elements[element_map[key].first]
+              if elt.is_a?(Array)
+                attrs = Hash[elt.map{|x| [x, elements_hash.delete(element_map.invert[[element_map[key].first, x]])]}]
+              else
+                attrs = {element_map[key].last => value}
+              end
+              xml.send(element_map[key].first, attrs)
+            end
+          end
+        end
+
+        response = send_request(request)
+        parse_response(response, name)
+      else
+        super
+      end
+    end
+
+    def respond_to(name)
+      @ribcl.has_command?(name) ? true : super
+    end
+
+    def supported_commands
+      @ribcl.select{|name, command| command.supported?}.keys
+    end
+
+    private
+
+    def send_request(xml)
+      case @protocol
+      when :http
+        send_http_request(xml)
+      when :raw
+        send_raw_request(xml)
+      end
+    end
+
+    # ILO >= 3 speak HTTP
+    # Send XML request with HTTP POST and get back XML messages
+    def send_http_request(xml)
+      http = Net::HTTP.new(@hostname, @port)
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE unless @verify_ssl
+
+      @log.info("Sending POST request to #{@hostname}:#{@port}#{@ribcl_path}")
+      @log.debug("Request:\n#{xml}")
+      response = http.post(@ribcl_path, xml)
+      if response.is_a?(Net::HTTPNotFound)
+        @protocol = :raw
+        @log.info("Got 404, switching to RAW protocol")
+        send_raw_request(xml)
+      else
+        response.body
+      end
+    end
+
+    # Older ILO just eat raw XML
+    # Send XML over raw SSL-wrapped TCP socket and read XML stream
+    def send_raw_request(xml)
+      sock = TCPSocket.new(@hostname, @port)
+
+      ctx = OpenSSL::SSL::SSLContext.new(:TLSv1)
+      ctx.verify_mode = OpenSSL::SSL::VERIFY_NONE
+      ssl_sock = OpenSSL::SSL::SSLSocket.new(sock, ctx)
+      ssl_sock.sync_close = true
+
+      @log.info("Connecting to #{@hostname}:#{@port}")
+      ssl_sock.connect
+      @log.debug("Request:\n#{xml}")
+      ssl_sock.puts("#{xml}\r\n")
+      response = ""
+      while line = ssl_sock.gets
+        response += line
+      end
+      ssl_sock.close
+
+      response
+    end
+
+    def parse_response(xml, command)
+      @log.debug("Response:\n#{xml}")
+
+      # ILO sends back multiple XML documents, split by XML header and remove first (empty)
+      messages = xml.split(/<\?xml.*?\?>\r?\n/).drop(1)
+
+      output = {}
+
+      messages.each do |doc|
+        xml_doc = Nokogiri::XML(doc){|cfg| cfg.nonet.noblanks}
+
+        xml_doc.root.children.each do |node|
+          case node.name
+          when "RESPONSE"
+            code = node.attr("STATUS").to_i(16)
+            message = node.attr("MESSAGE")
+            if code == 0
+              output[:status] = { :code => code, :message => message }
+            else
+              output[:status] = { :code => code, :message => message }
+              @log.error("#{message} (#{code})")
+              break
+            end
+          when "INFORM"
+            # OSEF
+          else # actual result
+            output.merge!(@nori.parse(node.to_s))
+          end
+        end
+      end
+
+      output
+    end
+
+    def ribcl_request(command, args = {}, &block)
+      builder = Nokogiri::XML::Builder.new do |xml|
+        xml.ribcl(:version => "2.0") {
+          xml.login(:password => @password, :user_login => @login) {
+            xml.send(command.context, :mode => command.mode) {
+              xml.send(command.name, args) {
+                yield xml if block_given?
+              }
+            }
+          }
+        }
+      end
+
+      builder.to_xml
+    end
+
+    def setup_commands
+      @ribcl = ILORb::RIBCL.load(File.join(File.dirname(__FILE__), "definitions", "*.rb"))
+      nil
+    end
+
+    def error(message)
+      @log.error(message)
+      raise message
+    end
+  end
+end

data/lib/ilorb/ribcl.rb

@@ -0,0 +1,135 @@
+module ILORb
+  class RIBCL < Hash
+    def initialize
+      super
+    end
+
+    # meaningful aliases
+    alias_method :has_command?, :has_key?
+    alias_method :command, :fetch
+
+    # mapping between Ruby objects and api format
+    VALUES = {
+      true => "yes",
+      false => "no",
+    }
+
+    def self.load(path)
+      obj = new
+      Dir.glob(path).each do |file|
+        obj.instance_eval(File.read(file), file)
+      end
+      obj
+    end
+
+    def encode(value)
+      VALUES[value] ? VALUES[value] : value
+    end
+
+    private
+    # private methods are used by DSL
+
+    def context(name, &block)
+      context = Context.new(name)
+      context.instance_eval(&block)
+      merge!(context.commands)
+    end
+
+    class Context
+      attr_reader :commands
+
+      def initialize(name)
+        @name = name.to_sym
+        @commands = {}
+      end
+
+      private
+      # private methods are used by DSL
+
+      [:read, :write].each do |mode|
+        define_method "#{mode}_cmd" do |name, &block|
+          command = Command.new(name, @name, mode)
+          command.instance_eval(&block) if block
+          @commands[name] = command
+        end
+      end
+    end
+
+    class Command
+      attr_reader :name, :context, :mode
+
+      def initialize(name, context, mode)
+        @name, @context, @mode = name.to_sym, context, mode
+        @attributes = []
+        @elements = {}
+        @text = nil
+        @supported = true
+      end
+
+      [:attributes, :elements, :text].each do |key|
+        define_method "get_#{key}" do
+          instance_variable_get("@#{key}")
+        end
+      end
+
+      def supported?
+        @supported
+      end
+
+      def map_elements
+        map = {}
+        @elements.each do |name, type|
+          if type == :value
+            map.store(name, [name, type])
+          elsif type.is_a?(Array)
+            type.each do |elt|
+              map.store("#{name}_#{elt}".to_sym, [name, elt])
+            end
+          else
+            map.store("#{name}_#{type}".to_sym, [name, type])
+          end
+        end
+        map
+      end
+
+      def get_params
+        params = []
+        params += @attributes
+        params << @text if @text
+        params += map_elements.keys
+        params
+      end
+
+      private
+      # private methods are used by DSL
+
+      def attributes(*params)
+        @attributes += params
+      end
+
+      def elements(*params)
+        if @text.nil?
+          hash = {}
+          params.each do |param|
+            if param.is_a?(Hash)
+              hash.merge!(param)
+            else
+              hash.store(param, :value)
+            end
+          end
+          @elements.merge!(hash)
+        end
+      end
+
+      def text(param)
+        if @elements.empty?
+          @text = param
+        end
+      end
+
+      def not_implemented
+        @supported = false
+      end
+    end
+  end
+end

data/lib/ilorb/version.rb

@@ -0,0 +1,3 @@
+module ILORb
+  VERSION = "0.0.1"
+end

data/lib/ilorb.rb

@@ -0,0 +1,5 @@
+require 'ilorb/ribcl'
+require 'ilorb/ilo'
+
+module ILORb
+end

data/spec/assets/basic_response.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0"?>
+<RIBCL VERSION="2.22">
+  <RESPONSE
+    STATUS="0x0000"
+    MESSAGE='No error'
+    />
+</RIBCL>

data/spec/assets/get_network_settings_response.xml

@@ -0,0 +1,87 @@
+<?xml version="1.0"?>
+<RIBCL VERSION="2.22">
+  <RESPONSE
+    STATUS="0x0000"
+    MESSAGE='No error'
+    />
+  <GET_NETWORK_SETTINGS>
+    <ENABLE_NIC VALUE="Y"/>
+    <SHARED_NETWORK_PORT VALUE="N"/>
+    <VLAN_ENABLED VALUE="N"/>
+    <VLAN_ID VALUE="0"/>
+    <SPEED_AUTOSELECT VALUE="Y"/>
+    <NIC_SPEED VALUE="Automatic"/>
+    <FULL_DUPLEX VALUE="Automatic"/>
+    <DHCP_ENABLE VALUE="Y"/>
+    <DHCP_GATEWAY VALUE="N"/>
+    <DHCP_DNS_SERVER VALUE="Y"/>
+    <DHCP_WINS_SERVER VALUE="N"/>
+    <DHCP_STATIC_ROUTE VALUE="N"/>
+    <DHCP_DOMAIN_NAME VALUE="N"/>
+    <DHCP_SNTP_SETTINGS VALUE="Y"/>
+    <REG_WINS_SERVER VALUE="N"/>
+    <REG_DDNS_SERVER VALUE="N"/>
+    <PING_GATEWAY VALUE="N"/>
+    <MAC_ADDRESS VALUE="1c:c1:de:17:b3:90"/>
+    <IP_ADDRESS VALUE="192.168.1.13"/>
+    <SUBNET_MASK VALUE="255.255.255.0"/>
+    <GATEWAY_IP_ADDRESS VALUE="0.0.0.0"/>
+    <DNS_NAME VALUE="weezer"/>
+    <DOMAIN_NAME VALUE="ilotest.com."/>
+    <PRIM_DNS_SERVER VALUE="0.0.0.0"/>
+    <SEC_DNS_SERVER VALUE="0.0.0.0"/>
+    <TER_DNS_SERVER VALUE="0.0.0.0"/>
+    <PRIM_WINS_SERVER VALUE="0.0.0.0"/>
+    <SEC_WINS_SERVER VALUE="0.0.0.0"/>
+    <SNTP_SERVER1 VALUE="192.168.1.5"/>
+    <SNTP_SERVER2 VALUE=""/>
+    <TIMEZONE VALUE="CST6CDT"/>
+    <STATIC_ROUTE_1 DEST="0.0.0.0"
+                    MASK="0.0.0.0"
+                    GATEWAY="0.0.0.0"/>
+    <STATIC_ROUTE_2 DEST="0.0.0.0"
+                    MASK="0.0.0.0"
+                    GATEWAY="0.0.0.0"/>
+    <STATIC_ROUTE_3 DEST="0.0.0.0"
+                    MASK="0.0.0.0"
+                    GATEWAY="0.0.0.0"/>
+    <IPV6_ADDRESS   VALUE="2001:2:1::15"
+                    PREFIXLEN="64"
+                    ADDR_SOURCE="STATIC"
+                    ADDR_STATUS="ACTIVE"/>
+    <IPV6_ADDRESS   VALUE="2001:db8:1::50"
+                    PREFIXLEN="64"
+                    ADDR_SOURCE="STATIC"
+                    ADDR_STATUS="ACTIVE"/>
+    <IPV6_ADDRESS   VALUE="fe80::1ec1:deff:fe17:b390"
+                    PREFIXLEN="64"
+                    ADDR_SOURCE="SLAAC"
+                    ADDR_STATUS="ACTIVE"/>
+    <IPV6_ADDRESS   VALUE="2001:2:1:0:1ec1:deff:fe17:b390"
+                    PREFIXLEN="64"
+                    ADDR_SOURCE="SLAAC"
+                    ADDR_STATUS="ACTIVE"/>
+    <IPV6_STATIC_ROUTE_1
+      IPV6_DEST="2001:2:2::20"
+      PREFIXLEN="64"
+      IPV6_GATEWAY="fe80::1:2:3"
+      ADDR_STATUS="ACTIVE"/>
+    <IPV6_STATIC_ROUTE_2
+      IPV6_DEST="::"
+      PREFIXLEN="0"
+      IPV6_GATEWAY="::"
+      ADDR_STATUS="INACTIVE"/>
+    <IPV6_STATIC_ROUTE_3
+      IPV6_DEST="2001:1001:2002:3003::"
+      PREFIXLEN="64"
+      IPV6_GATEWAY="2001:db8:1::40"
+      ADDR_STATUS="ACTIVE"/>
+    <IPV6_PRIM_DNS_SERVER VALUE="2001:1:2::5"/>
+    <IPV6_SEC_DNS_SERVER VALUE="2001:1:2::6"/>
+    <IPV6_TER_DNS_SERVER VALUE="::"/>
+    <IPV6_DEFAULT_GATEWAY VALUE="fe80::21c:c4ff:fe18:9cbd"/>
+    <IPV6_PREFERRED_PROTOCOL VALUE="Y"/>
+    <IPV6_ADDR_AUTOCFG VALUE="Y"/>
+    <IPV6_REG_DDNS_SERVER VALUE="Y"/>
+  </GET_NETWORK_SETTINGS>
+</RIBCL>

data/spec/ilo_spec.rb

@@ -0,0 +1,79 @@
+require 'spec_helper'
+
+describe ILORb::ILO do
+  let(:hostname) { "10.200.0.1" }
+  let(:login) { "Admin" }
+  let(:password) { "SECRET" }
+  let(:ilo) { ILORb::ILO.new(hostname: hostname, login: login, password: password) }
+
+  describe "#get_network_settings" do
+    before do
+      stub_request(:post, "https://10.200.0.1/ribcl").
+        with(:body => "<?xml version=\"1.0\"?>\n<ribcl version=\"2.0\">\n  <login password=\"SECRET\" user_login=\"Admin\">\n    <rib_info mode=\"read\">\n      <get_network_settings/>\n    </rib_info>\n  </login>\n</ribcl>\n").
+        to_return(:status => 200, :body => asset_file('get_network_settings_response.xml'))
+    end
+
+    subject { ilo.get_network_settings }
+
+    its([:status]) { should include(code: 0, message: 'No error') }
+    its([:get_network_settings]) { should_not be_empty }
+  end
+
+  describe "#set_one_time_boot" do
+    before do
+      stub_request(:post, "https://10.200.0.1/ribcl").
+        with(:body => "<?xml version=\"1.0\"?>\n<ribcl version=\"2.0\">\n  <login password=\"SECRET\" user_login=\"Admin\">\n    <server_info mode=\"write\">\n      <set_one_time_boot value=\"FLOPPY\"/>\n    </server_info>\n  </login>\n</ribcl>\n").
+        to_return(:status => 200, :body => asset_file('basic_response.xml'))
+    end
+
+    subject { ilo.set_one_time_boot(value: "FLOPPY") }
+
+    its([:status]) { should include(code: 0, message: 'No error') }
+  end
+
+  describe "#set_pwreg" do
+    before do
+      stub_request(:post, "https://10.200.0.1/ribcl").
+        with(:body => "<?xml version=\"1.0\"?>\n<ribcl version=\"2.0\">\n  <login password=\"SECRET\" user_login=\"Admin\">\n    <server_info mode=\"write\">\n      <set_pwreg>\n        <pwralert type=\"PEAK\"/>\n        <pwralert_settings threshold=\"200\" duration=\"35\"/>\n      </set_pwreg>\n    </server_info>\n  </login>\n</ribcl>\n").
+        to_return(:status => 200, :body => asset_file('basic_response.xml'))
+    end
+
+    subject { ilo.set_pwreg pwralert_type: "PEAK",
+                            pwralert_settings_threshold: 200,
+                            pwralert_settings_duration: 35 }
+
+    its([:status]) { should include(code: 0, message: 'No error') }
+  end
+
+  describe "#set_one_time_boot" do
+    before do
+      stub_request(:post, "https://10.200.0.1/ribcl").
+        with(:body => "<?xml version=\"1.0\"?>\n<ribcl version=\"2.0\">\n  <login password=\"SECRET\" user_login=\"Admin\">\n    <server_info mode=\"write\">\n      <set_one_time_boot value=\"FLOPPY\"/>\n    </server_info>\n  </login>\n</ribcl>\n").
+        to_return(:status => 200, :body => asset_file('basic_response.xml'))
+    end
+
+    subject { ilo.set_one_time_boot(value: "FLOPPY") }
+
+    its([:status]) { should include(code: 0, message: 'No error') }
+  end
+
+  describe "#set_persistent_boot" do
+    before do
+      stub_request(:post, "https://10.200.0.1/ribcl").
+        with(:body => "<?xml version=\"1.0\"?>\n<ribcl version=\"2.0\">\n  <login password=\"SECRET\" user_login=\"Admin\">\n    <server_info mode=\"write\">\n      <set_persistent_boot>\n        <device value=\"FLOPPY\"/>\n        <device value=\"CDROM\"/>\n      </set_persistent_boot>\n    </server_info>\n  </login>\n</ribcl>\n").
+        to_return(:status => 200, :body => asset_file('basic_response.xml'))
+    end
+
+    subject { ilo.set_persistent_boot([{ device_value: "FLOPPY" },
+                                       { device_value: "CDROM" }]) }
+
+    its([:status]) { should include(code: 0, message: 'No error') }
+  end
+
+  private
+
+  def asset_file(asset)
+    path = File.join(File.dirname(__FILE__), 'assets', asset)
+    File.new(path)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'ilorb'
+require 'webmock/rspec'
+require 'pry'
+
+RSpec.configure do |config|
+  config.order = "random"
+end

metadata

@@ -0,0 +1,161 @@
+--- !ruby/object:Gem::Specification
+name: ilorb
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Jonathan Amiez
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: nori
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: HP ILO Ruby interface
+email:
+- jonathan.amiez@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- README.md
+- ilorb.gemspec
+- lib/ilorb.rb
+- lib/ilorb/definitions/rib.rb
+- lib/ilorb/definitions/server.rb
+- lib/ilorb/definitions/user.rb
+- lib/ilorb/ilo.rb
+- lib/ilorb/ribcl.rb
+- lib/ilorb/version.rb
+- spec/assets/basic_response.xml
+- spec/assets/get_network_settings_response.xml
+- spec/ilo_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/josqu4red/ilorb
+licenses:
+- MIT
+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
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Configure and retrieve data from server's ILO management card
+test_files:
+- spec/assets/basic_response.xml
+- spec/assets/get_network_settings_response.xml
+- spec/ilo_spec.rb
+- spec/spec_helper.rb