dmacvicar / ruby-sfcc

ruby bindings for sblim client

ruby-sfcc¶ ↑

• github.com/dmacvicar/ruby-sfcc

INTRODUCTION¶ ↑

ruby-sfcc provides the SBLIM client API ( sblim.wiki.sourceforge.net/Sfcc ) for ruby.

You can use it to connect to any CIMOM talking CIM-XML, but it can take advantage of sfcb CIMOM by connecting using a native interface.

Requirements¶ ↑

Ruby interpreters¶ ↑

ruby-sfcc has been built and the testsuite ran against:

* ruby 1.8.7
* ruby 1.9.2
* rubinius HEAD (what will be 1.1 soon)

sblim¶ ↑

ruby-sfcc has been built and the testsuite ran against:

• sblim-sfcc 2.2.4

(Note: Earlier versions of sfcc don’t play well with ruby-sfcc+Rails)

Quick Start¶ ↑

You can create a gem by running rake gem.

See the testsuite for more examples. Or run rake docs.

require 'sfcc'

client = Sfcc::Cim::Client.connect('http://root@localhost:5988')
op = Sfcc::Cim::ObjectPath.new("root/cimv2", "")
result = client.query(op, "select * from CIM_OperatingSystem", "wql")
result.each do |instance|
  puts "query result: #{instance}"
end

FAQ¶ ↑

• Why not using SWIG?

  sfcc has a complex API based on function tables to simulate an object oriented environment in C which would make wrapping it complicated.

• Why the API?

  The motivation is to have the plain API available, and use it to access the CIMOM, gaining the footprint of SBLIM plus features like the local interface to talk with the CIMOM without overhead.

  So the API is pretty “raw”, and it is supposed to be consumed by

ActiveCim ( github.com/dmacvicar/activecim ) which is a more ruby-like API to do CIM based management.

• How to run the testsuite?

  You need a CIMOM with base providers (ie: Linux_OperatingSystem) running on localhost 5988 with no authentication

Known Issues¶ ↑

• If you call Instance#references without a filter class you may get an error. It seems sfcb can’t load a provider.

• ObjectPath qualifier methods crash

If you want to contribute:¶ ↑

• fork github.com/dmacvicar/ruby-sfcc

• make your changes along with tests (don’t touch version in changelog or lib/sfcc/version.rb)

• send me a pull request

Links¶ ↑

Documentation¶ ↑

• rdoc.info/projects/dmacvicar/ruby-sfcc

Code Metrics¶ ↑

• getcaliper.com/caliper/project?repo=git%3A%2F%2Fgithub.com%2Fdmacvicar%2Fruby-sfcc.git

Authors¶ ↑

• Duncan Mac-Vicar P. <[email protected]>

Thanks¶ ↑

The following people have contributed patches, fixes and enhancements:

• Klaus Kaempf <[email protected]>

ruby-sfcc's Issues

Install on osx

Hello all, i am trying to get this to install on osx 10.6.6

so far i have run the following commands

gem build sfcc.gemspec

this works ok, then i run, gem install sfcc-0.1.2.gem

this is where I get an error,

In file included from cim_class.h:5,
from cim_class.c:2:
sfcc.h:12:31: error: CimClientLib/cmci.h: No such file or directory
sfcc.h:13:33: error: CimClientLib/cmcidt.h: No such file or directory

I am not to sure where to get these files from ? Has anyone else got this to work on the mac ?
I am using rvm and ruby 1.9.2 and gem 1.3.7

Cheers

Richard

test_sfcc_cim_client.rb crashes with '*** buffer overflow detected ***: ruby terminated'

Ruby-sfcc testsuite runs fine on openSUSE 11.2 (i586) with packages from systemsmanagement:wbem. Except for test_sfcc_cim_client.rb.

The backtrace shows sfcc_rb_raise_if_error+0xbd

Installing -debug packages now ...