opennebula 7.0.2 → 7.1.80.pre

data/lib/opennebula/grpc/zone_pb.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: zone.proto
+
+require 'google/protobuf'
+
+require 'shared_pb'
+
+
+descriptor_data = "\n\nzone.proto\x12\x08one.zone\x1a\x0cshared.proto\"7\n\x0f\x41llocateRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x10\n\x08template\x18\x02 \x01(\t\"0\n\rDeleteRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0b\n\x03oid\x18\x02 \x01(\x05\"?\n\x0bInfoRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0b\n\x03oid\x18\x02 \x01(\x05\x12\x0f\n\x07\x64\x65\x63rypt\x18\x03 \x01(\x08\"R\n\rUpdateRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0b\n\x03oid\x18\x02 \x01(\x05\x12\x10\n\x08template\x18\x03 \x01(\t\x12\x0e\n\x06\x61ppend\x18\x04 \x01(\x05\">\n\rRenameRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0b\n\x03oid\x18\x02 \x01(\x05\x12\x0c\n\x04name\x18\x03 \x01(\t\"C\n\x10\x41\x64\x64ServerRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0b\n\x03oid\x18\x02 \x01(\x05\x12\x0e\n\x06zs_str\x18\x03 \x01(\t\"B\n\x10\x44\x65lServerRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0b\n\x03oid\x18\x02 \x01(\x05\x12\r\n\x05zs_id\x18\x03 \x01(\x05\"D\n\x12ResetServerRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0b\n\x03oid\x18\x02 \x01(\x05\x12\r\n\x05zs_id\x18\x03 \x01(\x05\"@\n\rEnableRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0b\n\x03oid\x18\x02 \x01(\x05\x12\x0e\n\x06\x65nable\x18\x03 \x01(\x08\"\xcc\x01\n\x13ReplicateLogRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x11\n\tleader_id\x18\x02 \x01(\x05\x12\x15\n\rleader_commit\x18\x03 \x01(\x04\x12\x13\n\x0bleader_term\x18\x04 \x01(\r\x12\r\n\x05index\x18\x05 \x01(\x04\x12\x0c\n\x04term\x18\x06 \x01(\r\x12\x12\n\nprev_index\x18\x07 \x01(\x04\x12\x11\n\tprev_term\x18\x08 \x01(\r\x12\x11\n\tfed_index\x18\t \x01(\x04\x12\x0b\n\x03sql\x18\n \x01(\t\"5\n\x14ResponseReplicateLog\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0c\n\x04term\x18\x02 \x01(\r\"\x88\x01\n\x0bVoteRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x16\n\x0e\x63\x61ndidate_term\x18\x02 \x01(\r\x12\x14\n\x0c\x63\x61ndidate_id\x18\x03 \x01(\x05\x12\x1b\n\x13\x63\x61ndidate_log_index\x18\x04 \x01(\x04\x12\x1a\n\x12\x63\x61ndidate_log_term\x18\x05 \x01(\r\"-\n\x0cResponseVote\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\x0c\n\x04term\x18\x02 \x01(\r\"\'\n\x11RaftStatusRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\"V\n\x16ReplicateFedLogRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\r\n\x05index\x18\x02 \x01(\x04\x12\x0c\n\x04prev\x18\x03 \x01(\x04\x12\x0b\n\x03sql\x18\x04 \x01(\t\"9\n\x17ResponseReplicateFedLog\x12\x0f\n\x07success\x18\x01 \x01(\x08\x12\r\n\x05index\x18\x02 \x01(\x04\"?\n\x0fUpdateDBRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t\x12\x0b\n\x03oid\x18\x02 \x01(\x05\x12\x0b\n\x03xml\x18\x03 \x01(\t\"%\n\x0fPoolInfoRequest\x12\x12\n\nsession_id\x18\x01 \x01(\t2\x84\x07\n\x0bZoneService\x12\x36\n\x08\x41llocate\x12\x19.one.zone.AllocateRequest\x1a\x0f.one.ResponseID\x12\x32\n\x06\x44\x65lete\x12\x17.one.zone.DeleteRequest\x1a\x0f.one.ResponseID\x12/\n\x04Info\x12\x15.one.zone.InfoRequest\x1a\x10.one.ResponseXML\x12\x32\n\x06Update\x12\x17.one.zone.UpdateRequest\x1a\x0f.one.ResponseID\x12\x32\n\x06Rename\x12\x17.one.zone.RenameRequest\x1a\x0f.one.ResponseID\x12\x38\n\tAddServer\x12\x1a.one.zone.AddServerRequest\x1a\x0f.one.ResponseID\x12\x38\n\tDelServer\x12\x1a.one.zone.DelServerRequest\x1a\x0f.one.ResponseID\x12<\n\x0bResetServer\x12\x1c.one.zone.ResetServerRequest\x1a\x0f.one.ResponseID\x12\x32\n\x06\x45nable\x12\x17.one.zone.EnableRequest\x1a\x0f.one.ResponseID\x12M\n\x0cReplicateLog\x12\x1d.one.zone.ReplicateLogRequest\x1a\x1e.one.zone.ResponseReplicateLog\x12\x35\n\x04Vote\x12\x15.one.zone.VoteRequest\x1a\x16.one.zone.ResponseVote\x12;\n\nRaftStatus\x12\x1b.one.zone.RaftStatusRequest\x1a\x10.one.ResponseXML\x12V\n\x0fReplicateFedLog\x12 .one.zone.ReplicateFedLogRequest\x1a!.one.zone.ResponseReplicateFedLog\x12\x36\n\x08UpdateDB\x12\x19.one.zone.UpdateDBRequest\x1a\x0f.one.ResponseID\x12\x37\n\x08PoolInfo\x12\x19.one.zone.PoolInfoRequest\x1a\x10.one.ResponseXMLB8Z6github.com/OpenNebula/one/src/oca/go/src/goca/api/zoneb\x06proto3"
+
+pool = ::Google::Protobuf::DescriptorPool.generated_pool
+pool.add_serialized_file(descriptor_data)
+
+module One
+  module Zone
+    AllocateRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.AllocateRequest").msgclass
+    DeleteRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.DeleteRequest").msgclass
+    InfoRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.InfoRequest").msgclass
+    UpdateRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.UpdateRequest").msgclass
+    RenameRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.RenameRequest").msgclass
+    AddServerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.AddServerRequest").msgclass
+    DelServerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.DelServerRequest").msgclass
+    ResetServerRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.ResetServerRequest").msgclass
+    EnableRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.EnableRequest").msgclass
+    ReplicateLogRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.ReplicateLogRequest").msgclass
+    ResponseReplicateLog = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.ResponseReplicateLog").msgclass
+    VoteRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.VoteRequest").msgclass
+    ResponseVote = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.ResponseVote").msgclass
+    RaftStatusRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.RaftStatusRequest").msgclass
+    ReplicateFedLogRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.ReplicateFedLogRequest").msgclass
+    ResponseReplicateFedLog = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.ResponseReplicateFedLog").msgclass
+    UpdateDBRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.UpdateDBRequest").msgclass
+    PoolInfoRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("one.zone.PoolInfoRequest").msgclass
+  end
+end

data/lib/opennebula/grpc/zone_services_pb.rb

@@ -0,0 +1,68 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: zone.proto for package 'one.zone'
+# Original file comments:
+# -------------------------------------------------------------------------- 
+#
+# Copyright 2002-2025, OpenNebula Project, OpenNebula Systems                
+#
+#                                                                            
+#
+# Licensed under the Apache License, Version 2.0 (the "License"); you may    
+#
+# not use this file except in compliance with the License. You may obtain    
+#
+# a copy of the License at                                                   
+#
+#                                                                            
+#
+# http://www.apache.org/licenses/LICENSE-2.0                                 
+#
+#                                                                            
+#
+# Unless required by applicable law or agreed to in writing, software        
+#
+# distributed under the License is distributed on an "AS IS" BASIS,          
+#
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   
+#
+# See the License for the specific language governing permissions and        
+#
+# limitations under the License.                                             
+#
+# -------------------------------------------------------------------------- 
+
+require 'grpc'
+require 'zone_pb'
+
+module One
+  module Zone
+    module ZoneService
+      class Service
+
+        include ::GRPC::GenericService
+
+        self.marshal_class_method = :encode
+        self.unmarshal_class_method = :decode
+        self.service_name = 'one.zone.ZoneService'
+
+        rpc :Allocate, ::One::Zone::AllocateRequest, ::One::ResponseID
+        rpc :Delete, ::One::Zone::DeleteRequest, ::One::ResponseID
+        rpc :Info, ::One::Zone::InfoRequest, ::One::ResponseXML
+        rpc :Update, ::One::Zone::UpdateRequest, ::One::ResponseID
+        rpc :Rename, ::One::Zone::RenameRequest, ::One::ResponseID
+        rpc :AddServer, ::One::Zone::AddServerRequest, ::One::ResponseID
+        rpc :DelServer, ::One::Zone::DelServerRequest, ::One::ResponseID
+        rpc :ResetServer, ::One::Zone::ResetServerRequest, ::One::ResponseID
+        rpc :Enable, ::One::Zone::EnableRequest, ::One::ResponseID
+        rpc :ReplicateLog, ::One::Zone::ReplicateLogRequest, ::One::Zone::ResponseReplicateLog
+        rpc :Vote, ::One::Zone::VoteRequest, ::One::Zone::ResponseVote
+        rpc :RaftStatus, ::One::Zone::RaftStatusRequest, ::One::ResponseXML
+        rpc :ReplicateFedLog, ::One::Zone::ReplicateFedLogRequest, ::One::Zone::ResponseReplicateFedLog
+        rpc :UpdateDB, ::One::Zone::UpdateDBRequest, ::One::ResponseID
+        rpc :PoolInfo, ::One::Zone::PoolInfoRequest, ::One::ResponseXML
+      end
+
+      Stub = Service.rpc_stub_class
+    end
+  end
+end

data/lib/opennebula/host.rb

@@ -129,6 +129,8 @@ module OpenNebula
             rc = offline
             return rc if OpenNebula.is_error?(rc)
 
+            sleep 0.5
+
             enable
         end
 

data/lib/opennebula/host_pool.rb

@@ -41,6 +41,8 @@ module OpenNebula
 
         # Factory Method for the Host Pool
         def factory(element_xml)
+            require 'opennebula/host'
+
             OpenNebula::Host.new(element_xml,@client)
         end
 

data/lib/opennebula/ldap_auth.rb

@@ -16,7 +16,7 @@
 
 require 'rubygems'
 require 'opennebula/xml_utils'
-require 'opennebula/client'
+require 'opennebula/lib/client'
 require 'opennebula/group_pool'
 require 'net/ldap'
 require 'yaml'

data/lib/opennebula/lockable_ext.rb

@@ -16,17 +16,6 @@
 
 require 'date'
 
-require 'opennebula/document'
-require 'opennebula/hook'
-require 'opennebula/image'
-require 'opennebula/marketplaceapp'
-require 'opennebula/template'
-require 'opennebula/virtual_machine'
-require 'opennebula/virtual_network'
-require 'opennebula/virtual_router'
-require 'opennebula/vm_group'
-require 'opennebula/vntemplate'
-
 # Module to decorate Lockable classes with the following methods:
 #   - Lock
 #   - Unlock
@@ -125,17 +114,17 @@ module OpenNebula::LockableExt
     def self.lockable?(obj)
         # Lockable classes
         lockable = [
-            OpenNebula::BackupJob,
-            OpenNebula::Document,
-            OpenNebula::Hook,
-            OpenNebula::Image,
-            OpenNebula::MarketPlaceApp,
-            OpenNebula::Template,
-            OpenNebula::VirtualMachine,
-            OpenNebula::VirtualNetwork,
-            OpenNebula::VirtualRouter,
-            OpenNebula::VMGroup,
-            OpenNebula::VNTemplate
+            'OpenNebula::BackupJob',
+            'OpenNebula::Document',
+            'OpenNebula::Hook',
+            'OpenNebula::Image',
+            'OpenNebula::MarketPlaceApp',
+            'OpenNebula::Template',
+            'OpenNebula::VirtualMachine',
+            'OpenNebula::VirtualNetwork',
+            'OpenNebula::VirtualRouter',
+            'OpenNebula::VMGroup',
+            'OpenNebula::VNTemplate'
         ]
 
         # Get obj class to find parents in lockable class
@@ -147,7 +136,7 @@ module OpenNebula::LockableExt
         i_class = o_class
 
         while i_class
-            if lockable.include?(i_class)
+            if lockable.include?(i_class.name)
                 found = true
                 break
             end

data/lib/opennebula/marketplaceapp_ext.rb

@@ -14,6 +14,9 @@
 # limitations under the License.                                             #
 #--------------------------------------------------------------------------- #
 
+require 'opennebula/template'
+require 'opennebula/image_pool'
+
 # Module to decorate MarketApp class with additional helpers not directly
 # exposed through the OpenNebula XMLRPC API. The extensions include
 #   - export helper that creates OpenNebula related objects from a given app.

data/lib/opennebula/oneform_client.rb

@@ -0,0 +1,320 @@
+# -------------------------------------------------------------------------- #
+# Copyright 2002-2025, OpenNebula Project, OpenNebula Systems                #
+#                                                                            #
+# Licensed under the Apache License, Version 2.0 (the "License"); you may    #
+# not use this file except in compliance with the License. You may obtain    #
+# a copy of the License at                                                   #
+#                                                                            #
+# http://www.apache.org/licenses/LICENSE-2.0                                 #
+#                                                                            #
+# Unless required by applicable law or agreed to in writing, software        #
+# distributed under the License is distributed on an "AS IS" BASIS,          #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   #
+# See the License for the specific language governing permissions and        #
+# limitations under the License.                                             #
+#--------------------------------------------------------------------------- #
+
+require 'uri'
+require 'base64'
+require 'json'
+
+require 'opennebula/form/helpers'
+require 'opennebula/form/drivers'
+require 'opennebula/form/providers'
+require 'opennebula/form/provisions'
+require 'cloud/CloudClient'
+
+include CloudCLI
+
+module OneForm
+
+    # OneForm API client
+    class Client
+
+        DEFAULT_OPTIONS = [
+            ENDPOINT = {
+                :name => 'server',
+                :short => '-s url',
+                :large => '--server url',
+                :format => String,
+                :description => 'OneForm endpoint'
+            },
+            USERNAME={
+                :name => 'username',
+                :short => '-u name',
+                :large => '--username name',
+                :format => String,
+                :description => 'User name'
+            },
+            PASSWORD={
+                :name => 'password',
+                :short => '-p pass',
+                :large => '--password pass',
+                :format => String,
+                :description => 'User password'
+            },
+            API_VERSION={
+                :name => 'api_version',
+                :large => '--api-version version',
+                :format => String,
+                :description => 'OneForm API Version to use'
+            }
+        ]
+
+        include OneForm::Drivers
+        include OneForm::Providers
+        include OneForm::Provisions
+
+        def initialize(opts = {})
+            endpoint  = '/.one/oneform_endpoint'
+            @username = opts[:username] || ENV['ONEFORM_USER']
+            @password = opts[:password] || ENV['ONEFORM_PASSWORD']
+
+            # By default oneform uses JSON as content type
+            @content_type = opts[:content_type] || 'application/json'
+
+            # Set API version
+            @version = opts[:api_version] || ENV['ONEFORM_VERSION'] || 'v1'
+
+            if opts[:url]
+                url = opts[:url]
+            elsif ENV['ONEFORM_URL']
+                url = ENV['ONEFORM_URL']
+            elsif Dir.home && File.exist?(Dir.home + endpoint)
+                url = File.read(Dir.home + endpoint).strip
+            elsif File.exist?('/var/lib/one/.one/oneform_endpoint')
+                url = File.read('/var/lib/one/.one/oneform_endpoint').strip
+            else
+                url = 'http://localhost:13013'
+            end
+
+            url = url.chomp('/') + "/api/#{@version}"
+
+            if @username.nil? && @password.nil?
+                if Dir.home && !Dir.home.empty? && ENV['ONE_AUTH'] && File.file?(ENV['ONE_AUTH'])
+                    one_auth = File.read(ENV['ONE_AUTH'])
+                elsif Dir.home && File.file?(Dir.home + '/.one/one_auth')
+                    one_auth = File.read(Dir.home + '/.one/one_auth')
+                elsif File.file?('/var/lib/one/.one/one_auth')
+                    one_auth = File.read('/var/lib/one/.one/one_auth')
+                else
+                    raise 'ONE_AUTH file not present'
+                end
+
+                one_auth = one_auth.rstrip
+                @username, @password = one_auth.split(':')
+            end
+
+            @uri = URI.parse(url)
+
+            @user_agent = "OpenNebula #{CloudClient::VERSION} " <<
+                "(#{opts[:user_agent]||'Ruby'})"
+
+            @host = nil
+            @port = nil
+
+            return unless ENV['http_proxy']
+
+            uri_proxy = URI.parse(ENV['http_proxy'])
+            flag = false
+
+            #  Check if we need to bypass the proxy
+            if ENV['no_proxy']
+                ENV['no_proxy'].split(',').each do |item|
+                    item = item.strip
+
+                    if (IPAddress @uri.host rescue nil).nil?
+                        if (IPAddress(item) rescue nil).nil?
+                            flag |= (item == @uri.host)
+                        end
+                    else
+                        unless (IPAddress item rescue nil).nil?
+                            flag |= IPAddress(item).include? IPAddress(@uri.host)
+                        end
+                    end
+                end
+            end
+
+            return if flag
+
+            @host = uri_proxy.host
+            @port = uri_proxy.port
+        end
+
+        private
+
+        def get(path, params = {})
+            uri = build_uri(path, params)
+            request = Net::HTTP::Proxy(@host, @port)::Get.new(uri, default_headers)
+            perform_request(uri, request)
+        end
+
+        def post(path, body = {})
+            uri = build_uri(path)
+            request = Net::HTTP::Proxy(@host, @port)::Post.new(uri, default_headers)
+            request.body = body.is_a?(String) ? body : body.to_json
+            perform_request(uri, request)
+        end
+
+        def put(path, body = {})
+            uri = build_uri(path)
+            request = Net::HTTP::Proxy(@host, @port)::Put.new(uri, default_headers)
+            request.body = body.is_a?(String) ? body : body.to_json
+            perform_request(uri, request)
+        end
+
+        def patch(path, body = {})
+            uri = build_uri(path)
+            request = Net::HTTP::Proxy(@host, @port)::Patch.new(uri, default_headers)
+            request.body = body.is_a?(String) ? body : body.to_json
+            perform_request(uri, request)
+        end
+
+        def delete(path, params = {})
+            uri = build_uri(path, params)
+            request = Net::HTTP::Proxy(@host, @port)::Delete.new(uri, default_headers)
+            perform_request(uri, request)
+        end
+
+        def poll_logs(path, params = {})
+            uri     = build_uri(path, params)
+            request = Net::HTTP::Proxy(@host, @port)::Get.new(uri, default_headers)
+
+            raw_body = nil
+
+            Net::HTTP.start(
+                uri.host,
+                uri.port,
+                :use_ssl => (uri.scheme == 'https')
+            ) do |http|
+                response = http.request(request)
+
+                raise "Request failed: #{response.code} #{response.message}" \
+                unless response.is_a?(Net::HTTPSuccess)
+
+                raw_body = response.body
+            end
+
+            json =
+                begin
+                    JSON.parse(raw_body)
+                rescue JSON::ParserError => e
+                    raise "Invalid JSON response: #{e.message}"
+                end
+
+            {
+                :pos   => json['pos'],
+                :meta  => json['meta'],
+                :lines => json['lines'] || []
+            }
+        end
+
+        def follow_logs(path, params = {})
+            pos      = params[:all] ? 0 : nil
+            interval = params[:interval] || 1.0
+
+            loop do
+                begin
+                    response = poll_logs(path, { :pos => pos })
+
+                    response[:lines].each do |entry|
+                        level = entry['level'] || 'info'
+                        text  = entry['text']  || ''
+                        puts "[#{level}] #{text}"
+                    end
+
+                    pos = response[:pos] || pos
+                    sleep interval
+                rescue Interrupt
+                    break
+                rescue StandardError => e
+                    warn "Polling error: #{e.class}: #{e.message}"
+                    sleep interval
+                end
+            end
+        end
+
+        def build_uri(path, params = {})
+            uri = @uri.dup
+            path = path.sub(%r{^/}, '')
+            uri.path = [@uri.path, path].join('/').gsub(%r{/{2,}}, '/')
+            uri.query = URI.encode_www_form(params) unless params.empty?
+            uri
+        end
+
+        def default_headers
+            auth = Base64.strict_encode64("#{@username}:#{@password}")
+            {
+                'Authorization' => "Basic #{auth}",
+                'Content-Type'  => @content_type,
+                'Accept'        => @content_type,
+                'User-Agent'    => @user_agent
+            }
+        end
+
+        def perform_request(uri, request)
+            Net::HTTP.start(uri.host, uri.port, :use_ssl => uri.scheme == 'https') do |http|
+                response = http.request(request)
+                handle_response(response)
+            end
+        end
+
+        def handle_response(response)
+            json = nil
+
+            begin
+                body = response.body && !response.body.strip.empty? ? response.body : '{}'
+                json = JSON.parse(body, :symbolize_names => true)
+            rescue JSON::ParserError
+                raise "OneForm Error: #{body.inspect}"
+            end
+
+            case response
+            when Net::HTTPSuccess
+                if json.is_a?(Array)
+                    json.map do |item|
+                        item.is_a?(Hash) && item.key?(:DOCUMENT) ? item[:DOCUMENT] : item
+                    end
+                elsif json.is_a?(Hash) && json.key?(:DOCUMENT)
+                    json[:DOCUMENT]
+                else
+                    json
+                end
+            else
+                err_code      = json[:err_code] || 'UNKNOWN'
+                error_message = json[:message]  || 'No message provided'
+                err_ctx       = json[:context]  || {}
+
+                if err_ctx && !err_ctx.empty?
+                    context_str = format_context(err_ctx)
+
+                    msg = <<~MSG
+                        OneForm Error (#{err_code}): #{error_message}
+                        #{context_str}
+                    MSG
+                else
+                    msg = "OneForm Error (#{err_code}): #{error_message}"
+                end
+
+                raise msg
+            end
+        end
+
+        def format_context(hash, indent = 0, top_level = true)
+            prefix = ' ' * indent
+
+            hash.map do |key, value|
+                line_prefix = top_level ? "#{prefix}- " : "#{prefix}  "
+
+                if value.is_a?(Hash)
+                    nested = format_context(value, indent + 2, false)
+                    "#{line_prefix}#{key}:\n#{nested}"
+                else
+                    "#{line_prefix}#{key}: #{value}"
+                end
+            end.join("\n")
+        end
+
+    end
+
+end

data/lib/opennebula/pool.rb

@@ -15,6 +15,7 @@
 #--------------------------------------------------------------------------- #
 
 require 'opennebula/xml_utils'
+require 'opennebula/error'
 
 module OpenNebula
 
@@ -259,7 +260,7 @@ module OpenNebula
                 end
 
                 size = OpenNebula.pool_page_size if (!size || size == 0)
-                rc   = @client.call(method, @user_id, current, -size, state)
+                rc   = @client.call(method, @user_id, current, -size, state, "")
 
                 return rc if OpenNebula.is_error?(rc)
 

data/lib/opennebula/pool_element.rb

@@ -39,21 +39,21 @@ module OpenNebula
         end
 
         #######################################################################
-        # Common XML-RPC Methods for all the Pool Element Types
+        # Common RPC Methods for all the Pool Element Types
         #######################################################################
 
         # Common client call wrapper. Checks that @pe_id is defined, and
         # returns nil instead of the response if it is successful
         #
-        # @param [String] xml_method xml-rpc method
+        # @param [String] rpc_method the name of the RPC method
         # @param [Array] args any arguments for the xml-rpc method
         #
         # @return [nil, OpenNebula::Error] nil in case of success, Error
         #   otherwise
-        def call(xml_method, *args)
+        def call(rpc_method, *args)
             return Error.new('ID not defined') unless @pe_id
 
-            rc = @client.call(xml_method, *args)
+            rc = @client.call(rpc_method, *args)
             rc = nil unless OpenNebula.is_error?(rc)
 
             rc
@@ -86,13 +86,13 @@ module OpenNebula
         # Calls to the corresponding allocate method to create a new element
         # in the OpenNebula core
         #
-        # @param [String] xml_method the name of the XML-RPC method
-        # @param [Array] args any extra arguments for the xml-rpc method
+        # @param [String] rpc_method the name of the RPC method
+        # @param [Array] args any extra arguments for the RPC method
         #
         # @return [nil, OpenNebula::Error] nil in case of success, Error
         #   otherwise
-        def allocate(xml_method, *args)
-            rc = @client.call(xml_method, *args)
+        def allocate(rpc_method, *args)
+            rc = @client.call(rpc_method, *args)
 
             if !OpenNebula.is_error?(rc)
                 @pe_id = rc

data/lib/opennebula/saml_auth.rb

@@ -16,7 +16,7 @@
 
 require 'rubygems'
 require 'opennebula/xml_utils'
-require 'opennebula/client'
+require 'opennebula/lib/client'
 require 'opennebula/group_pool'
 require 'yaml'
 require 'onelogin/ruby-saml'

data/lib/opennebula/user_pool.rb

@@ -38,6 +38,7 @@ module OpenNebula
 
         # Factory method to create User objects
         def factory(element_xml)
+            require 'opennebula/user'
             OpenNebula::User.new(element_xml,@client)
         end
 

data/lib/opennebula/version.rb

@@ -0,0 +1,22 @@
+# -------------------------------------------------------------------------- #
+# Copyright 2002-2025, OpenNebula Project, OpenNebula Systems                #
+#                                                                            #
+# Licensed under the Apache License, Version 2.0 (the "License"); you may    #
+# not use this file except in compliance with the License. You may obtain    #
+# a copy of the License at                                                   #
+#                                                                            #
+# http://www.apache.org/licenses/LICENSE-2.0                                 #
+#                                                                            #
+# Unless required by applicable law or agreed to in writing, software        #
+# distributed under the License is distributed on an "AS IS" BASIS,          #
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.   #
+# See the License for the specific language governing permissions and        #
+# limitations under the License.                                             #
+#--------------------------------------------------------------------------- #
+
+module OpenNebula
+
+    # OpenNebula version
+    VERSION = '7.1.80'
+
+end