ucslib 0.1.7 → 0.1.8

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0172126a4b6154c64708a1484a9b2893d11344e6
+  data.tar.gz: 36511401b59e7332222d10a8fb92559438e49ad5
+SHA512:
+  metadata.gz: b9d31b08263cbb3e164445c7cf11b624f92d7ac11b799779ad848e765af88837768aaadf55611a46742a72b3e683457a8aba11b54014da97f4729c6b633e1cc0
+  data.tar.gz: e1ec6b08d119ac16266d80a67959af5308e28e23f433c8831e9480520cac479a17a2b0cf3564dcb84829c88dbeb977d3c294ed588aec81da96fcf1f26cad81b1

data/README.md

@@ -0,0 +1,151 @@
+##  ucslib (beta)
+
+Ruby Client Library for Cisco UCS Manager that could be used for Infrastructure Automation.
+
+To see an example of how ucslib is being used, checkout the ucs and ucs-solo Chef Cookbooks created by Velankani Information Systems, Inc here - https://github.com/velankanisys/chef-cookbooks
+
+In addition there is a knife plugin that use ucslib as well - https://github.com/velankanisys/knife-ucs
+
+** Version 0.1.8 has been released **
+
+0.1.8
+
+Namespace updates (clean up) and support for ruby 2.1.0
+
+0.1.7
+Multi-chassis server pool creation
+
+0.1.6:
+Set syslog server implemented in provisioner
+
+0.1.5:
+Moved update boot policy to Update instead of manage
+Disabled Parser code for now to allow ucslib to work on Debian Squeeze running Ruby1.9.1
+
+0.1.4:
+Bug fixes.
+
+0.1.3:
+Host firmware XML change for UCS 2.1.
+
+0.1.2:
+Bug fixes.
+
+0.1.1:
+
+1. Provision has set_ vs create_ methods. Please update your apps.
+2. Added Manage functions to associate service profiles to server pools
+
+## Install
+
+gem install ucslib
+
+## Usage (example pry session)
+
+  [1] pry(main)> require 'ucslib'
+  => true
+  [2] pry(main)> authjson = { :username => 'admin', :password => 'admin', :ip => '172.16.192.175' }.to_json
+  => "{\"username\":\"admin\",\"password\":\"admin\",\"ip\":\"172.16.192.175\"}"
+  [3] pry(main)> ucs = UCS.new(authjson)
+  Your credentials are username: admin password: admin ip: 172.16.192.175 url https://172.16.192.175/nuova
+  => #<UCS:0x007fd269d1eb18>
+  [4] pry(main)> token = ucs.get_token(authjson)
+  => "{\"cookie\":\"1398284131/87cdd12e-7cb4-4e0d-b39d-e39a827e3870\",\"username\":\"admin\",\"password\":\"admin\",\"ip\":\"172.16.192.175\"}"
+  [5] pry(main)> inventory = ucs.discover(token)
+
+  Hit q to quit
+
+  => #(Document:0x3fd4a6f99e70 {
+    name = "document",
+    children = [
+      #(Element:0x3fd4a6f9954c {
+        name = "configResolveClasses",
+        attributes = [
+          #(Attr:0x3fd4a6f99254 {
+            name = "cookie",
+            value = "1398284407/c298b159-0cee-434a-ae55-c116b8cd19fe"
+            }),
+          #(Attr:0x3fd4a6f99240 { name = "response", value = "yes" })],
+        children = [
+          #(Text " "),
+          #(Element:0x3fd4a6fa1b20 {
+            name = "outConfigs",
+            children = [
+              #(Text "  "),
+              #(Element:0x3fd4a6fa10d0 {
+                name = "topSystem",
+                attributes = [
+                  #(Attr:0x3fd4a6fa0e3c {
+                    name = "address",
+                    value = "172.16.192.175"
+                    }),
+                  #(Attr:0x3fd4a6fa0e28 {
+                    name = "currentTime",
+                    value = "2014-04-23T20:29:13.906"
+                    }),
+                  #(Attr:0x3fd4a6fa0e14 { name = "descr", value = "" }),
+                  #(Attr:0x3fd4a6fa0e00 { name = "dn", value = "sys" }),
+                  #(Attr:0x3fd4a6fa0dec { name = "ipv6Addr", value = "::" }),
+                  #(Attr:0x3fd4a6fa0dd8 { name = "mode", value = "cluster" }),
+                  #(Attr:0x3fd4a6fa0dc4 {
+                    name = "name",
+                    value = "UCSPE-172-16-192-175"
+                    }),
+                  #(Attr:0x3fd4a6fa0db0 { name = "owner", value = "" }),
+                  #(Attr:0x3fd4a6fa0d9c { name = "site", value = "" }),
+                  #(Attr:0x3fd4a6fa0d88 {
+                    name = "systemUpTime",
+                    value = "00:06:18:58"
+    [6] pry(main)>ucs.list_blades(inventory)
+    Blade : 1/1 model: N20-B6620-1 with serial: 3324 is powered: on
+    Blade : 1/2 model: N20-B6620-1 with serial: 3325 is powered: on
+    Blade : 1/5 model: UCSB-B200-M3 with serial: 3327 is powered: on
+    Blade : 1/6 model: N20-B6625-1 with serial: 3328 is powered: on
+    Blade : 1/3 model: N20-B6620-2 with serial: 3326 is powered: on
+    Blade : 1/7 model: N20-B6740-2 with serial: 3329 is powered: on
+    => 0
+    [7] pry(main)>vlan200 = { :vlan_id => '200', :vlan_name => 'OpenStack-Mgmt' }.to_json
+    => "{\"vlan_id\":\"200\",\"vlan_name\":\"OpenStack-Mgmt\"}"
+    [8] pry(main)> ucs.set_vlan(vlan200)
+    => " <configConfMos cookie=\"1398291606/fe13664b-b79d-4ac7-9d0f-98cedffd1c5e\" response=\"yes\"> <outConfigs> <pair key=\"fabric/lan/net-OpenStack-Mgmt\"> <fabricVlan childAction=\"deleteNonPresent\" cloud=\"ethlan\" compressionType=\"included\" configIssues=\"\" defaultNet=\"no\" dn=\"fabric/lan/net-OpenStack-Mgmt\" epDn=\"\" fltAggr=\"0\" global=\"0\" id=\"200\" ifRole=\"network\" ifType=\"virtual\" local=\"0\" locale=\"external\" mcastPolicyName=\"\" name=\"OpenStack-Mgmt\" operMcastPolicyName=\"\" operState=\"ok\" peerDn=\"\" policyOwner=\"local\" pubNwDn=\"\" pubNwId=\"1\" pubNwName=\"\" sharing=\"none\" status=\"created\" switchId=\"dual\" transport=\"ether\" type=\"lan\"/> </pair> </outConfigs> </configConfMos>"
+    [9] pry(main)> ucs.delete_vlan(vlan200)
+    => " <configConfMos cookie=\"1398291606/fe13664b-b79d-4ac7-9d0f-98cedffd1c5e\" response=\"yes\"> <outConfigs> <pair key=\"fabric/lan/net-OpenStack-Mgmt\"> <fabricVlan cloud=\"ethlan\" compressionType=\"included\" configIssues=\"\" defaultNet=\"no\" dn=\"fabric/lan/net-OpenStack-Mgmt\" epDn=\"\" fltAggr=\"0\" global=\"0\" id=\"200\" ifRole=\"network\" ifType=\"virtual\" local=\"0\" locale=\"external\" mcastPolicyName=\"\" name=\"OpenStack-Mgmt\" operMcastPolicyName=\"org-root/mc-policy-default\" operState=\"ok\" peerDn=\"\" policyOwner=\"local\" pubNwDn=\"\" pubNwId=\"1\" pubNwName=\"\" sharing=\"none\" status=\"deleted\" switchId=\"dual\" transport=\"ether\" type=\"lan\"/> </pair> </outConfigs> </configConfMos>"
+    [10] pry(main)>
+
+
+
+Just do "require ucslib" in your apps. Below is an IRB session to highlight some capabilities.
+
+
+## Features
+
+1. List inventory of UCS components
+2. Provision - turn up ports, create port channels, pools, service profiles
+3. Retrieve stats
+
+## Issues and Project Management
+
+Checkout [Pivotal Tracker][1]
+
+
+## ToDo
+
+Documentation, Documentation, Documentation!
+
+
+
+## Contributing to ucslib
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2012 - 2014 Murali Raju. See LICENSE.txt for further details.
+
+[1]: https://www.pivotaltracker.com/s/projects/1065870
+

data/README.rdoc

@@ -1,12 +1,16 @@
-= ucslib (beta)
+==  ucslib (beta)
 
-Ruby Client Library for Cisco UCS Manager that could be used by DevOps toolchains - Puppet or Chef and other custom tools in order to provide MaaS (Metal-as-a-Service) for installing and running OpenStack, CloudStack or Hadoop, etc on Cisco UCS. ucslib accepts JSON as configuration.
+Ruby Client Library for Cisco UCS Manager that could be used for Infrastructure Automation.
 
 To see an example of how ucslib is being used, checkout the ucs and ucs-solo Chef Cookbooks created by Velankani Information Systems, Inc here - https://github.com/velankanisys/chef-cookbooks
 
 In addition there is a knife plugin that use ucslib as well - https://github.com/velankanisys/knife-ucs
 
-** Version 0.1.7 has been released **
+** Version 0.1.8 has been released **
+
+0.1.8
+
+Namespace updates (clean up) and support for ruby 2.1.0
 
 0.1.7
 Multi-chassis server pool creation
@@ -18,7 +22,7 @@ Set syslog server implemented in provisioner
 Moved update boot policy to Update instead of manage
 Disabled Parser code for now to allow ucslib to work on Debian Squeeze running Ruby1.9.1
 
-0.1.4: 
+0.1.4:
 Bug fixes.
 
 0.1.3:
@@ -36,104 +40,82 @@ Bug fixes.
 
 gem install ucslib
 
-== Usage (example irb session)
+== Usage (example pry session)
+
+  [1] pry(main)> require 'ucslib'
+  => true
+  [2] pry(main)> authjson = { :username => 'admin', :password => 'admin', :ip => '172.16.192.175' }.to_json
+  => "{\"username\":\"admin\",\"password\":\"admin\",\"ip\":\"172.16.192.175\"}"
+  [3] pry(main)> ucs = UCS.new(authjson)
+  Your credentials are username: admin password: admin ip: 172.16.192.175 url https://172.16.192.175/nuova
+  => #<UCS:0x007fd269d1eb18>
+  [4] pry(main)> token = ucs.get_token(authjson)
+  => "{\"cookie\":\"1398284131/87cdd12e-7cb4-4e0d-b39d-e39a827e3870\",\"username\":\"admin\",\"password\":\"admin\",\"ip\":\"172.16.192.175\"}"
+  [5] pry(main)> inventory = ucs.discover(token)
+
+  Hit q to quit
+
+  => #(Document:0x3fd4a6f99e70 {
+    name = "document",
+    children = [
+      #(Element:0x3fd4a6f9954c {
+        name = "configResolveClasses",
+        attributes = [
+          #(Attr:0x3fd4a6f99254 {
+            name = "cookie",
+            value = "1398284407/c298b159-0cee-434a-ae55-c116b8cd19fe"
+            }),
+          #(Attr:0x3fd4a6f99240 { name = "response", value = "yes" })],
+        children = [
+          #(Text " "),
+          #(Element:0x3fd4a6fa1b20 {
+            name = "outConfigs",
+            children = [
+              #(Text "  "),
+              #(Element:0x3fd4a6fa10d0 {
+                name = "topSystem",
+                attributes = [
+                  #(Attr:0x3fd4a6fa0e3c {
+                    name = "address",
+                    value = "172.16.192.175"
+                    }),
+                  #(Attr:0x3fd4a6fa0e28 {
+                    name = "currentTime",
+                    value = "2014-04-23T20:29:13.906"
+                    }),
+                  #(Attr:0x3fd4a6fa0e14 { name = "descr", value = "" }),
+                  #(Attr:0x3fd4a6fa0e00 { name = "dn", value = "sys" }),
+                  #(Attr:0x3fd4a6fa0dec { name = "ipv6Addr", value = "::" }),
+                  #(Attr:0x3fd4a6fa0dd8 { name = "mode", value = "cluster" }),
+                  #(Attr:0x3fd4a6fa0dc4 {
+                    name = "name",
+                    value = "UCSPE-172-16-192-175"
+                    }),
+                  #(Attr:0x3fd4a6fa0db0 { name = "owner", value = "" }),
+                  #(Attr:0x3fd4a6fa0d9c { name = "site", value = "" }),
+                  #(Attr:0x3fd4a6fa0d88 {
+                    name = "systemUpTime",
+                    value = "00:06:18:58"
+    [6] pry(main)>ucs.list_blades(inventory)
+    Blade : 1/1 model: N20-B6620-1 with serial: 3324 is powered: on
+    Blade : 1/2 model: N20-B6620-1 with serial: 3325 is powered: on
+    Blade : 1/5 model: UCSB-B200-M3 with serial: 3327 is powered: on
+    Blade : 1/6 model: N20-B6625-1 with serial: 3328 is powered: on
+    Blade : 1/3 model: N20-B6620-2 with serial: 3326 is powered: on
+    Blade : 1/7 model: N20-B6740-2 with serial: 3329 is powered: on
+    => 0
+    [7] pry(main)>vlan200 = { :vlan_id => '200', :vlan_name => 'OpenStack-Mgmt' }.to_json
+    => "{\"vlan_id\":\"200\",\"vlan_name\":\"OpenStack-Mgmt\"}"
+    [8] pry(main)> ucs.set_vlan(vlan200)
+    => " <configConfMos cookie=\"1398291606/fe13664b-b79d-4ac7-9d0f-98cedffd1c5e\" response=\"yes\"> <outConfigs> <pair key=\"fabric/lan/net-OpenStack-Mgmt\"> <fabricVlan childAction=\"deleteNonPresent\" cloud=\"ethlan\" compressionType=\"included\" configIssues=\"\" defaultNet=\"no\" dn=\"fabric/lan/net-OpenStack-Mgmt\" epDn=\"\" fltAggr=\"0\" global=\"0\" id=\"200\" ifRole=\"network\" ifType=\"virtual\" local=\"0\" locale=\"external\" mcastPolicyName=\"\" name=\"OpenStack-Mgmt\" operMcastPolicyName=\"\" operState=\"ok\" peerDn=\"\" policyOwner=\"local\" pubNwDn=\"\" pubNwId=\"1\" pubNwName=\"\" sharing=\"none\" status=\"created\" switchId=\"dual\" transport=\"ether\" type=\"lan\"/> </pair> </outConfigs> </configConfMos>"
+    [9] pry(main)> ucs.delete_vlan(vlan200)
+    => " <configConfMos cookie=\"1398291606/fe13664b-b79d-4ac7-9d0f-98cedffd1c5e\" response=\"yes\"> <outConfigs> <pair key=\"fabric/lan/net-OpenStack-Mgmt\"> <fabricVlan cloud=\"ethlan\" compressionType=\"included\" configIssues=\"\" defaultNet=\"no\" dn=\"fabric/lan/net-OpenStack-Mgmt\" epDn=\"\" fltAggr=\"0\" global=\"0\" id=\"200\" ifRole=\"network\" ifType=\"virtual\" local=\"0\" locale=\"external\" mcastPolicyName=\"\" name=\"OpenStack-Mgmt\" operMcastPolicyName=\"org-root/mc-policy-default\" operState=\"ok\" peerDn=\"\" policyOwner=\"local\" pubNwDn=\"\" pubNwId=\"1\" pubNwName=\"\" sharing=\"none\" status=\"deleted\" switchId=\"dual\" transport=\"ether\" type=\"lan\"/> </pair> </outConfigs> </configConfMos>"
+    [10] pry(main)>
 
 
-Just do "require ucslib" in your apps. Below is an IRB session to highlight some capabilities.
 
+Just do "require ucslib" in your apps. Below is an IRB session to highlight some capabilities.
 
-➜  ucslib git:(master) ✗ irb
-
-1.9.3p194 :001 > require 'ucslib'
- => true 
-1.9.3p194 :002 > auth_json = { :username => 'admin', :password => 'admin', :ip => '172.16.75.137' }.to_json
- => "{\"username\":\"admin\",\"password\":\"admin\",\"ip\":\"172.16.75.137\"}" 
-1.9.3p194 :003 > ucs_session = UCSToken.new
- => #<UCSToken:0x007ff4d92062c0> 
-1.9.3p194 :004 > token_json = ucs_session.get_token(auth_json)
- => "{\"cookie\":\"1336941096/ea496248-d200-4a10-8e46-c73b59971864\",\"username\":\"admin\",\"password\":\"admin\",\"ip\":\"172.16.75.137\"}" 
-1.9.3p194 :005 > ucs_inventory = UCSInventory.new
- => #<UCSInventory:0x007ff4d92cd8c0> 
-1.9.3p194 :006 > ucs_provision = UCSProvision.new(token_json)
- => #<UCSProvision:0x007ff4d92c0378 @cookie="1336941096/ea496248-d200-4a10-8e46-c73b59971864", @url="https://172.16.75.137/nuova"> 
-1.9.3p194 :007 > xml_dump = ucs_inventory.discover(token_json)
-
-1.9.3p194 :008 > ucs_inventory.methods
- => [:discover, :list_blades, :list_vsans, :list_vlans, :list_cpus, :list_memory, :list_service_profiles, :list_running_firmware, :to_json, :nil?, :===, :=~, :!~, :eql?, :hash, :<=>, :class, :singleton_class, :clone, :dup, :initialize_dup, :initialize_clone, :taint, :tainted?, :untaint, :untrust, :untrusted?, :trust, :freeze, :frozen?, :to_s, :inspect, :methods, :singleton_methods, :protected_methods, :private_methods, :public_methods, :instance_variables, :instance_variable_get, :instance_variable_set, :instance_variable_defined?, :instance_of?, :kind_of?, :is_a?, :tap, :send, :public_send, :respond_to?, :respond_to_missing?, :extend, :display, :method, :public_method, :define_singleton_method, :object_id, :to_enum, :enum_for, :==, :equal?, :!, :!=, :instance_eval, :instance_exec, :__send__, :__id__] 
-1.9.3p194 :009 >
-
-1.9.3p194 :009 > ucs_inventory.list_blades(xml_dump)
-Blade : 1/5 model: UCSB-B200-M3 with serial: 1049 is powered: off
-Blade : 1/6 model: N20-B6625-1 with serial: 1053 is powered: off
-Blade : 1/1 model: N20-B6620-1 with serial: 1045 is powered: on
-Blade : 1/7 model: N20-B6740-2 with serial: 1052 is powered: off
-Blade : 1/2 model: N20-B6620-1 with serial: 1054 is powered: off
-Blade : 1/4 model: N20-B6620-1 with serial: 1051 is powered: off
-Blade : 1/3 model: N20-B6620-1 with serial: 1055 is powered: off
- => 0 
-1.9.3p194 :010 >
-
-1.9.3p194 :010 > vlan_json = { :vlan_id => '200', :vlan_name => 'OpenStack-Mgmt' }.to_json
- => "{\"vlan_id\":\"200\",\"vlan_name\":\"OpenStack-Mgmt\"}"
-
-1.9.3p194 :011 > ucs_provision.methods
- => [:set_power_policy, :set_chassis_discovery_policy, :set_time_zone, :set_ntp, :create_server_port, :create_network_uplink_port, :create_fc_uplink_port, :create_port_channel, :create_org, :set_local_disk_policy, :create_local_boot_policy, :create_pxe_boot_policy, :create_san_boot_policy, :create_management_ip_pool, :create_vlan, :create_mac_pool, :create_vnic_template, :create_vsan, :create_wwnn_pool, :create_wwpn_pool, :create_vhba_template, :create_uuid_pool, :create_service_profile_template, :create_service_profiles_from_template, :create_service_profiles, :to_json, :nil?, :===, :=~, :!~, :eql?, :hash, :<=>, :class, :singleton_class, :clone, :dup, :initialize_dup, :initialize_clone, :taint, :tainted?, :untaint, :untrust, :untrusted?, :trust, :freeze, :frozen?, :to_s, :inspect, :methods, :singleton_methods, :protected_methods, :private_methods, :public_methods, :instance_variables, :instance_variable_get, :instance_variable_set, :instance_variable_defined?, :instance_of?, :kind_of?, :is_a?, :tap, :send, :public_send, :respond_to?, :respond_to_missing?, :extend, :display, :method, :public_method, :define_singleton_method, :object_id, :to_enum, :enum_for, :==, :equal?, :!, :!=, :instance_eval, :instance_exec, :__send__, :__id__] 
-1.9.3p194 :012 > 
-
-1.9.3p194 :012 > ucs_provision.create_vlan(vlan_json)
- => " <configConfMos cookie=\"1336941096/ea496248-d200-4a10-8e46-c73b59971864\" response=\"yes\"> <outConfigs> <pair key=\"fabric/lan/net-OpenStack-Mgmt\"> <fabricVlan childAction=\"deleteNonPresent\" defaultNet=\"no\" dn=\"fabric/lan/net-OpenStack-Mgmt\" epDn=\"\" id=\"200\" ifRole=\"network\" ifType=\"virtual\" locale=\"external\" name=\"OpenStack-Mgmt\" operState=\"ok\" peerDn=\"\" pubNwDn=\"\" pubNwId=\"0\" pubNwName=\"\"  sharing=\"none\" status=\"created\" switchId=\"dual\" transport=\"ether\" type=\"lan\"/> </pair> </outConfigs> </configConfMos>" 
-1.9.3p194 :013 > 
-
-1.9.3p194 :015 > xml_dump = ucs_inventory.discover(token_json)
-
-1.9.3p194 :015 > ucs_inventory.list_vlans(xml_dump)
-VLAN: 1 with name: default
-VLAN: 1 with name: default
-VLAN: 5 with name: human-resource
-VLAN: 1 with name: default
-VLAN: 3 with name: finance
-VLAN: 5 with name: human-resource
-VLAN: 1 with name: default
-VLAN: 3 with name: finance
-VLAN: 100 with name: Tenant-1
-VLAN: 200 with name: OpenStack-Mgmt
- => 0 
-1.9.3p194 :016 > 
-
-1.9.3p194 :016 > ucs_stats = UCSStats.new
-
-1.9.3p194 :017 > statsxml = ucs_stats.fetch(token_json)
-
-1.9.3p194 :017 > ucs.show_sample(statsml,'fcStats')
-
-  The attributes for fcStats for dn=sys/switch-B/slot-1/switch-fc/port-32/stats are:
-  bytesRx = 125283780333316
-  bytesRxDelta = 142669360
-  bytesRxDeltaAvg = 142706128
-  bytesRxDeltaMax = 146404048
-  bytesRxDeltaMin = 139044968
-  bytesTx = 42023875724480
-  bytesTxDelta = 29946840
-  bytesTxDeltaAvg = 29842170
-  bytesTxDeltaMax = 31907484
-  bytesTxDeltaMin = 27672184
-  intervals = 58982460
-  packetsRx = 67694612103
-  packetsRxDelta = 78357
-  packetsRxDeltaAvg = 78476
-  packetsRxDeltaMax = 80258
-  packetsRxDeltaMin = 76814
-  packetsTx = 22997688197
-  packetsTxDelta = 18346
-  packetsTxDeltaAvg = 18318
-  packetsTxDeltaMax = 19393
-  packetsTxDeltaMin = 17218
-  suspect = no
-  thresholded = 
-  timeCollected = 2012-11-16T13:40:32.362
-  update = 65539
-
-1.9.3p194 :018 > ucs.show_all(statsml,'fcStats') # output omitted 
 
 == Features
 
@@ -141,6 +123,11 @@ VLAN: 200 with name: OpenStack-Mgmt
 2. Provision - turn up ports, create port channels, pools, service profiles
 3. Retrieve stats
 
+== Issues and Project Management
+
+Checkout [Pivotal Tracker][1]
+
+
 == ToDo
 
 Documentation, Documentation, Documentation!
@@ -148,7 +135,7 @@ Documentation, Documentation, Documentation!
 
 
 == Contributing to ucslib
- 
+
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
 * Start a feature/bugfix branch.
@@ -158,7 +145,7 @@ Documentation, Documentation, Documentation!
 
 == Copyright
 
-Copyright (c) 2012 Murali Raju. See LICENSE.txt for further details.
-
+Copyright (c) 2012 - 2014 Murali Raju. See LICENSE.txt for further details.
 
+[1]: https://www.pivotaltracker.com/s/projects/1065870
 

data/lib/ucslib/Gemfile

@@ -0,0 +1,4 @@
+# A sample Gemfile
+source "https://rubygems.org"
+
+# gem "rails"

data/lib/ucslib/{destroy.rb → service/ucs/destroy.rb}

@@ -15,16 +15,7 @@
 # limitations under the License.
 #
 
-class UCSDestroy
-
-	def initialize(tokenjson)
-    
-	    @cookie  = "#{JSON.parse(tokenjson)['cookie']}"
-	    ip       = "#{JSON.parse(tokenjson)['ip']}"
-	    @url 	 = "https://#{ip}/nuova"
-
-	end
-
+module Destroy
 
   def delete_org(json)
 
@@ -49,7 +40,7 @@ class UCSDestroy
 		rescue Exception => e
 			raise "Error #{e}"
 		end
-  		
+
   end
 
   def delete_vlan(json)
@@ -78,6 +69,6 @@ class UCSDestroy
 			raise "Error #{e}"
 		end
 
-	end  
+	end
 
 end

data/lib/ucslib/{inventory.rb → service/ucs/inventory.rb}

@@ -16,17 +16,20 @@
 #
 
 
-class UCSInventory
-  
-  def discover(tokenjson)
-    
-    cookie 	 = "#{JSON.parse(tokenjson)['cookie']}"
-    ip       = "#{JSON.parse(tokenjson)['ip']}"
-    url 	   = "https://#{ip}/nuova"
+module Inventory
+
+  # Archive code. To be removed later #TODO
+  # def discover(tokenjson)
+
+  #   @cookie   = "#{JSON.parse(tokenjson)['cookie']}"
+  #   ip       = "#{JSON.parse(tokenjson)['ip']}"
+  #   @url      = "https://#{ip}/nuova"
+
+  def discover
 
     #Start Build the Multi-Class XML
     xml_builder = Nokogiri::XML::Builder.new do |xml|
-       xml.configResolveClasses('cookie' => cookie, 'inHierarchical' => 'false') {
+       xml.configResolveClasses('cookie' => @cookie, 'inHierarchical' => 'false') {
         xml.inIds{
           xml.classId("value" => "topSystem")
           xml.classId("value" => "equipmentChassis")
@@ -69,46 +72,46 @@ class UCSInventory
           xml.classId("value" => "vmVnicProfCl")
           xml.classId("value" => "vmVnicProfInst")
           xml.classId("value" => "vmVsan")
-        } 
+        }
        }
     end
 
     #End Build Multi-Class XML
 
     ucs_multi_class_XML = xml_builder.to_xml.to_s
-    ucs_response_multi_class = RestClient.post(url, ucs_multi_class_XML, :content_type => 'text/xml').body
+    ucs_response_multi_class = RestClient.post(@url, ucs_multi_class_XML, :content_type => 'text/xml').body
 
      #Uncomment the following to create a dump to review and debug elements
      # fh = File.new("ucs_response_multiclass.xml", "w")
-     # fh.puts ucs_response_multi_class.inspect 
+     # fh.puts ucs_response_multi_class.inspect
      # fh.close
-     
+
      return Nokogiri::XML(ucs_response_multi_class)
-     
+
   end
-  
-  
+
+
   def list_blades(ucs_multi_class_xml)
-    
+
     ucs_multi_class_xml.xpath("configResolveClasses/outConfigs/computeBlade").each do |blade|
-             
+
         puts "Blade : #{blade.attributes["serverId"]} model: #{blade.attributes["model"]}" \
              " with serial: #{blade.attributes["serial"]} is powered: #{blade.attributes["operPower"]}"
-        
+
     end
-    
+
   end
-  
+
   def list_vsans(ucs_multi_class_xml)
 
      ucs_multi_class_xml.xpath("configResolveClasses/outConfigs/fabricVsan").each do |fabricvsan|
-       
+
        puts "VSAN: #{fabricvsan.attributes["fcoeVlan"]} with FCoE ID: #{fabricvsan.attributes["id"]}" \
             " status: #{fabricvsan.attributes["operState"]}"
     end
 
   end
-  
+
   def list_vlans(ucs_multi_class_xml)
 
     ucs_multi_class_xml.xpath("configResolveClasses/outConfigs/fabricVlan").each do |fabricvlan|
@@ -116,9 +119,9 @@ class UCSInventory
       puts "VLAN: #{fabricvlan.attributes["id"]} with name: #{fabricvlan.attributes["name"]}"
 
     end
-    
+
   end
-  
+
   def list_cpus(ucs_multi_class_xml)
 
     ucs_multi_class_xml.xpath("configResolveClasses/outConfigs/processorUnit").each do |processorunit|
@@ -130,7 +133,7 @@ class UCSInventory
     end
 
   end
-  
+
   def list_memory(ucs_multi_class_xml)
 
     ucs_multi_class_xml.xpath("configResolveClasses/outConfigs/computeBlade").each do |blade|
@@ -138,20 +141,20 @@ class UCSInventory
       puts "Available Memory: #{blade.attributes["availableMemory"]} Total Memory: #{blade.attributes["totalMemory"]} Speed: #{blade.attributes["memorySpeed"]}"
 
     end
-    
+
   end
-  
+
   def list_service_profiles(ucs_multi_class_xml)
-    
+
     ucs_multi_class_xml.xpath("configResolveClasses/outConfigs/lsServer").each do |serviceprofile|
 
        puts "Service Profile: #{serviceprofile.attributes["name"]} in #{serviceprofile.attributes["dn"]} with UUID #{serviceprofile.attributes["uuid"]}" \
             " is: #{serviceprofile.attributes["assocState"]}"
 
     end
-    
+
   end
-  
+
   def list_running_firmware(ucs_multi_class_xml)
 
     ucs_multi_class_xml.xpath("configResolveClasses/outConfigs/firmwareRunning").each do |firmware|
@@ -162,5 +165,5 @@ class UCSInventory
     end
 
   end
-  
+
 end

data/lib/ucslib/{manage.rb → service/ucs/manage.rb}

@@ -15,19 +15,11 @@
 # limitations under the License.
 #
 
-class UCSManage
-
-	def initialize(tokenjson)
-
-	@cookie  = "#{JSON.parse(tokenjson)['cookie']}"
-	ip       = "#{JSON.parse(tokenjson)['ip']}"
-	@url 	 = "https://#{ip}/nuova"
-
-	end
+module Manage
 
 
 	def discover_state
-	    
+
 	    #Start Build of the Multi-Class XML for interogating state
 	    xml_builder = Nokogiri::XML::Builder.new do |xml|
 	       xml.configResolveClasses('cookie' => @cookie, 'inHierarchical' => 'false') {
@@ -35,7 +27,7 @@ class UCSManage
 	          xml.classId("value" => "macpoolPooled")
 	          xml.classId("value" => "uuidpoolPooled")
 	          xml.classId("value" => "fcpoolInitiator")
-	        } 
+	        }
 	       }
 	    end
 
@@ -46,13 +38,13 @@ class UCSManage
 
       #Uncomment the following to create a dump to review and debug elements
       # fh = File.new("ucs_response_multiclass_state.xml", "w")
-      # fh.puts ucs_response_multi_class_state.inspect 
+      # fh.puts ucs_response_multi_class_state.inspect
       # fh.close
-       
-	    Nokogiri::XML(ucs_response_multi_class_state)	
-	    		
+
+	    Nokogiri::XML(ucs_response_multi_class_state)
+
 	end
-		
+
 
 	def associate_service_profile_template_to_server_pool(json)
 
@@ -73,8 +65,8 @@ class UCSManage
 		                     'descr' => '', 'dn' => "org-root/org-#{org}/ls-#{service_profile_template_to_bind}",
 		                     'dynamicConPolicyName' => '', 'extIPState' => 'none', 'hostFwPolicyName' => "#{service_profile_host_fw_policy}",
 		                     'identPoolName' => "#{service_profile_uuid_pool}", 'localDiskPolicyName' => 'default', 'maintPolicyName' => 'default',
-		                     'mgmtAccessPolicyName' => '', 'mgmtFwPolicyName' => "#{service_profile_mgmt_fw_policy}", 'powerPolicyName' => 'default', 
-		                     'scrubPolicyName' => '', 'solPolicyName' => 'default', 'srcTemplName' => '', 
+		                     'mgmtAccessPolicyName' => '', 'mgmtFwPolicyName' => "#{service_profile_mgmt_fw_policy}", 'powerPolicyName' => 'default',
+		                     'scrubPolicyName' => '', 'solPolicyName' => 'default', 'srcTemplName' => '',
 		                     'statsPolicyName' => 'default', 'status' => 'created,modified', 'usrLbl' => '', 'uuid' => '0', 'vconProfileName' => ''){
 		                       xml.lsRequirement('name' => "#{service_profile_server_pool}", 'qualifier' => '', 'restrictMigration' => 'no', 'rn' => 'pn-req')
 		                     }
@@ -87,13 +79,13 @@ class UCSManage
 
 		associate_service_profile_template_to_server_pool_xml = xml_builder.to_xml.to_s
 
-		#Post 
+		#Post
 		begin
 			RestClient.post(@url, associate_service_profile_template_to_server_pool_xml, :content_type => 'text/xml').body
 		rescue Exception => e
 			raise "Error #{e}"
-		end 
-	
+		end
+
 	end
-	
+
 end