ucslib 0.1.1 → 0.1.2

data/README.rdoc

@@ -1,8 +1,15 @@
-= ucslib (alpha)
+= ucslib (beta)
 
 Ruby Client Library for Cisco UCS Manager that could be used by DevOps toolchains - Puppet or Chef and other custom tools - to provide MaaS (Metal-as-a-Service) for installing and running OpenStack, Hadoop, etc. ucslib accepts JSON as configuration for provisioning.
 
 
+** Version 0.1.1 has been released **
+
+Major changes:
+
+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
@@ -71,14 +78,46 @@ 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
 
 1. List inventory of UCS components
 2. Provision - turn up ports, create port channels, pools, service profiles
-
+3. Retrieve stats
 
 == ToDo
 

data/lib/ucslib/inventory.rb

@@ -31,6 +31,7 @@ class UCSInventory
           xml.classId("value" => "topSystem")
           xml.classId("value" => "equipmentChassis")
           xml.classId("value" => "computeBlade")
+          xml.classId("value" => "networkElement")
           xml.classId("value" => "equipmentSwitchCard")
           xml.classId("value" => "equipmentIOCard")
           xml.classId("value" => "equipmentFanModule")
@@ -161,4 +162,4 @@ class UCSInventory
 
   end
   
-end
+end

data/lib/ucslib/manage.rb

@@ -25,45 +25,72 @@ class UCSManage
 
 	end
 
-	def associate_service_profile_template_to_server_pool(json)
 
-	service_profile_boot_policy        = JSON.parse(json)['service_profile_boot_policy']
-	service_profile_host_fw_policy     = JSON.parse(json)['service_profile_host_fw_policy']
-	service_profile_mgmt_fw_policy     = JSON.parse(json)['service_profile_mgmt_fw_policy']
-	service_profile_uuid_pool          = JSON.parse(json)['service_profile_uuid_pool']
-	service_profile_template_to_bind   = JSON.parse(json)['service_profile_template_to_bind']
-	service_profile_server_pool 	   = JSON.parse(json)['service_profile_server_pool']
-	org                				   = JSON.parse(json)['org']
-
-
-	xml_builder = Nokogiri::XML::Builder.new do |xml|
-	  xml.configConfMos('cookie' => "#{@cookie}", 'inHierarchical' => 'true'){
-	    xml.inConfigs{
-	      xml.pair('key' => "org-root/org-#{org}/ls-#{service_profile_template_to_bind}"){
-	        xml.lsServer('agentPolicyName' => '', 'biosProfileName' => '', 'bootPolicyName' => "#{service_profile_boot_policy}",
-	                     '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' => '', 
-	                     'statsPolicyName' => 'default', 'status' => 'created,modified', 'usrLbl' => '', 'uuid' => '0', 'vconProfileName' => ''){
-	                       xml.lsRequirement('name' => "#{service_profile_server_pool}", 'qualifier' => '', 'restrictMigration' => 'no', 'rn' => 'pn-req')
-	                     }
-	      }
-	    }
-	  }
+	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') {
+	        xml.inIds{
+	          xml.classId("value" => "macpoolPooled")
+	        } 
+	       }
+	    end
+
+	    #End Build Multi-Class XML
+
+	    ucs_multi_class_state_xml = xml_builder.to_xml.to_s
+	    ucs_response_multi_class_state = RestClient.post(@url, ucs_multi_class_state_xml, :content_type => 'text/xml').body
+
+		#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.close
+	     
+	    Nokogiri::XML(ucs_response_multi_class_state)		
+		
 	end
+		
+
+	def associate_service_profile_template_to_server_pool(json)
+
+		service_profile_boot_policy        = JSON.parse(json)['service_profile_boot_policy']
+		service_profile_host_fw_policy     = JSON.parse(json)['service_profile_host_fw_policy']
+		service_profile_mgmt_fw_policy     = JSON.parse(json)['service_profile_mgmt_fw_policy']
+		service_profile_uuid_pool          = JSON.parse(json)['service_profile_uuid_pool']
+		service_profile_template_to_bind   = JSON.parse(json)['service_profile_template_to_bind']
+		service_profile_server_pool 	   = JSON.parse(json)['service_profile_server_pool']
+		org                				   = JSON.parse(json)['org']
+
+
+		xml_builder = Nokogiri::XML::Builder.new do |xml|
+		  xml.configConfMos('cookie' => "#{@cookie}", 'inHierarchical' => 'true'){
+		    xml.inConfigs{
+		      xml.pair('key' => "org-root/org-#{org}/ls-#{service_profile_template_to_bind}"){
+		        xml.lsServer('agentPolicyName' => '', 'biosProfileName' => '', 'bootPolicyName' => "#{service_profile_boot_policy}",
+		                     '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' => '', 
+		                     'statsPolicyName' => 'default', 'status' => 'created,modified', 'usrLbl' => '', 'uuid' => '0', 'vconProfileName' => ''){
+		                       xml.lsRequirement('name' => "#{service_profile_server_pool}", 'qualifier' => '', 'restrictMigration' => 'no', 'rn' => 'pn-req')
+		                     }
+		      }
+		    }
+		  }
+		end
 
-	#Create XML
+		#Create XML
 
-	associate_service_profile_template_to_server_pool_xml = xml_builder.to_xml.to_s
+		associate_service_profile_template_to_server_pool_xml = xml_builder.to_xml.to_s
 
-	#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 
+		#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

data/lib/ucslib/stats.rb

@@ -0,0 +1,83 @@
+class UCSStats
+    def fetch(tokenjson)
+        cookie 	 = "#{JSON.parse(tokenjson)['cookie']}"
+        ip       = "#{JSON.parse(tokenjson)['ip']}"
+        url 	   = "https://#{ip}/nuova"
+
+        #Start Build the Multi-Class XML
+
+        # Note, the list of stats was gathered by changing hierarchical to "true" in
+        # inventory.rb, pointing at UCS and then searching the 10M XML for 'Stats' :)
+        #
+        # Like this:
+        # tr '>' '\n' < /tmp/ucs-play.xml | grep Stats | grep -v Policy | awk '{print $1}' | sort -u | grep -v / | tr -d '<' | grep -v Hist
+        xml_builder = Nokogiri::XML::Builder.new do |xml|
+            xml.configResolveClasses('cookie' => cookie, 'inHierarchical' => 'false') {
+                xml.inIds{
+                    xml.classId("value" => "adaptorEthPortStats")
+                    xml.classId("value" => "adaptorEthPortErrStats")
+                    xml.classId("value" => "adaptorEthPortMcastStats")
+                    xml.classId("value" => "adaptorVnicStats")
+                    xml.classId("value" => "computeMbPowerStats")
+                    xml.classId("value" => "computeMbTempStats")
+                    xml.classId("value" => "computePCIeFatalStats")
+                    xml.classId("value" => "computePCIeFatalCompletionStats")
+                    xml.classId("value" => "computePCIeFatalProtocolStats")
+                    xml.classId("value" => "computePCIeFatalReceiveStats")
+                    xml.classId("value" => "equipmentChassisStats")
+                    xml.classId("value" => "equipmentFanStats")
+                    xml.classId("value" => "equipmentFanModuleStats")
+                    xml.classId("value" => "equipmentIOCardStats")
+                    xml.classId("value" => "equipmentNetworkElementFanStats")
+                    xml.classId("value" => "equipmentPsuStats")
+                    xml.classId("value" => "equipmentPsuInputStats")
+                    xml.classId("value" => "etherErrStats")
+                    xml.classId("value" => "etherLossStats")
+                    xml.classId("value" => "etherPauseStats")
+                    xml.classId("value" => "etherRxStats")
+                    xml.classId("value" => "etherTxStats")
+                    xml.classId("value" => "fcStats")
+                    xml.classId("value" => "fcErrStats")
+                    xml.classId("value" => "memoryArrayEnvStats")
+                    xml.classId("value" => "memoryErrorStats")
+                    xml.classId("value" => "memoryUnitEnvStats")
+                    xml.classId("value" => "processorEnvStats")
+                    xml.classId("value" => "processorErrorStats")
+                    xml.classId("value" => "swEnvStats")
+                    xml.classId("value" => "swSystemStats")
+                }
+            }
+        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
+
+        #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.close
+        return Nokogiri::XML(ucs_response_multi_class)
+    end
+
+    def show_sample(xml,statname,all=false)
+        list = xml.xpath("configResolveClasses/outConfigs/#{statname}")
+        list = [list.first] unless all
+        list.each do |i|
+            show_attributes(i)
+        end
+    end
+
+    def show_all(xml,statname)
+        show_sample(xml,statname,true)
+    end
+
+    private
+    def show_attributes(item)
+        print "The attributes for #{item.name} for dn=#{item.attributes['dn']} are:\n"
+        item.attributes.keys.each do |attr|
+            next if attr == 'dn'
+            print "  #{attr} = #{item.attributes[attr]}\n"
+        end
+    end
+end

data/lib/ucslib/version.rb

@@ -16,5 +16,5 @@
 #
 
 module Ucslib
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/lib/ucslib.rb

@@ -23,6 +23,7 @@ require "ucslib/update"
 require "ucslib/inventory"
 require 'ucslib/destroy'
 require 'ucslib/manage'
+require 'ucslib/stats'
 
 require 'nokogiri'
 require 'rest-client'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ucslib
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-09 00:00:00.000000000 Z
+date: 2012-11-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri
@@ -116,6 +116,7 @@ files:
 - lib/ucslib/parser.rb
 - lib/ucslib/provision.rb
 - lib/ucslib/session.rb
+- lib/ucslib/stats.rb
 - lib/ucslib/update.rb
 - lib/ucslib/version.rb
 - ucslib.gemspec