Ucsimc

Ucsimc implements the Cisco XML API for Cisco UCS Central in Ruby. It wraps the Cisco XML API methods into easy to use ruby methods with the necessary parameters to handle low level queries against UCS Central. IMC implements additional logic on top of the API methods allowing the extension of the base API methods into more useful tools.

After establishing a valid connection Ucsimc will allow the following methods:

• resolve_class
• resolve_children
• resolve_dn
• config_mo

resolve_class

Takes @in_class as a string. Outputs to @out_dn

resolve_children

Takes @in_class and @in_dn. Resolves the @in_class children of @in_dn. Outputs to @out_dn

resolve_dn

Takes @in_dn and outputs @out_dn

config_mo

Takes @in_dn as a hash of dn => {values}. The dn gets set as the dn in the top level of the xml sent to the api while {value} gets passed to the inner part of the xml doc that sets the options. The class to configure specification is still set statically and needs to be moved to allow it to be set externally.

Example output:

<configConfMo
    dn=""  
    cookie="<real_cookie>" 
    inHierarchical="false">
    <inConfig>
       <aaaLdapEp
          attribute="CiscoAvPair"
          basedn="dc=pasadena,dc=cisco,dc=com"   
          descr=""
          dn="sys/ldap-ext"
          filter="sAMAccountName=$userid"
          retries="1"   
          status="modified"
          timeout="30"/>
    </inConfig>
</configConfMo>

Notes: This is a really early build. Basic querying of the api functionality is implemented. Further validation and error handling need to be done still. You'll need to know the dn or class you're wanting to query. Configuration support is implemented and working. Again you'll need to know the dn and class and provide a hash for configuration. Will work well with yaml file configuration as a source (not implemented).

Connection now handles requests/responses more sanely which allows watching for error codes/descriptions and reacting to them. First example of this is if a request gets an auth failed response indication session is no longer authenticated. This means the session has expired and can be refreshed. If do_post_extended sees this error message it'll refresh the session and rerun the request, post, and response, returning the managed_object hash.

Verify_ssl is currently broken, it doesn't verify right now.

Installation

Add this line to your application's Gemfile:

gem 'ucsimc'

And then execute:

$ bundle

Or install it yourself as:

$ gem install ucsimc

Usage

Pry instructions for now

These can be run without building if you have the nokogiri and rest-client gems installed already. Change the @LOAD_Path value replacing if you want to clone and test without building.

Resolve children of parent object

$LOAD_PATH.unshift("<your path here>/git/ucsimc/lib")

require 'ucsimc'
ucs = Ucsimc::IMC.connect({:user => "user", :pass => "pass", :host => "ipaddress", :verify_ssl => '"false"' })
ucs.in_dn = "domaingroup-root/fabric/lan"
ucs.in_class = "fabricVlan"
ucs.resolve_children
ucs.out_dn

Development

After checking out the repo, run bin/setup to install dependencies. Then, run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release to create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

1. Fork it ( https://github.com/[my-github-username]/ucsimc/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request