netconf 0.2.1

data/examples/jnpr/edit-config-jnpr-set.rb

@@ -0,0 +1,55 @@
+require 'net/netconf/jnpr'
+
+puts "NETCONF v.#{Netconf::VERSION}"
+
+login = { :target => 'vsrx', :username => "jeremy", :password => "jeremy1" }
+  
+new_host_name = "vsrx"
+
+puts "Connecting to device: #{login[:target]}" 
+
+Netconf::SSH.new( login ){ |dev|
+  puts "Connected!"
+  
+  location = []
+  location << 'set system location building "Main Campus, C"'
+  location << "set system location floor 15"
+  location << "set system location rack 1117"
+  
+  begin
+    
+    rsp = dev.rpc.lock_configuration
+
+    # --------------------------------------------------------------------    
+    # configuration as BLOCK
+    
+    rsp = dev.rpc.load_configuration( :format => 'set' ) {
+      "set system host-name #{new_host_name}"
+    }
+    
+    # --------------------------------------------------------------------
+    # configuration as PARAM
+    
+    rsp = dev.rpc.load_configuration( location, :format => 'set' )
+    
+    rpc = dev.rpc.check_configuration
+    rpc = dev.rpc.commit_configuration
+    rpc = dev.rpc.unlock_configuration
+    
+  rescue Netconf::LockError => e
+    puts "Lock error"
+  rescue Netconf::EditError => e
+    puts "Edit error"    
+  rescue Netconf::ValidateError => e
+    puts "Validate error"
+  rescue Netconf::CommitError => e
+    puts "Commit error"
+  rescue Netconf::RpcError => e
+    puts "General RPC error"
+  else
+    puts "Configuration Committed."
+  end  
+}
+
+
+

data/examples/jnpr/edit-config-jnpr-text.rb

@@ -0,0 +1,64 @@
+require 'net/netconf/jnpr'
+
+puts "NETCONF v.#{Netconf::VERSION}"
+
+login = { :target => 'vsrx', :username => "jeremy", :password => "jeremy1" }
+  
+new_host_name = "vsrx-gizmo"
+
+puts "Connecting to device: #{login[:target]}" 
+
+Netconf::SSH.new( login ){ |dev|
+  puts "Connected!"
+  
+  location = <<EOCONF
+system {
+   location {
+      building "Main Campus, E"
+      floor 15
+      rack 1117
+   }
+}
+EOCONF
+  
+  begin
+    
+    rsp = dev.rpc.lock_configuration
+
+    # --------------------------------------------------------------------    
+    # configuration as BLOCK
+    
+    rsp = dev.rpc.load_configuration( :format => 'text' ) {
+      <<-EOCONF
+      system {
+        host-name #{new_host_name}
+      }
+EOCONF
+    }
+    
+    # --------------------------------------------------------------------
+    # configuration as PARAM
+    
+    rsp = dev.rpc.load_configuration( location, :format => 'text' )
+    
+    rpc = dev.rpc.check_configuration
+    rpc = dev.rpc.commit_configuration
+    rpc = dev.rpc.unlock_configuration
+    
+  rescue Netconf::LockError => e
+    puts "Lock error"
+  rescue Netconf::EditError => e
+    puts "Edit error"    
+  rescue Netconf::ValidateError => e
+    puts "Validate error"
+  rescue Netconf::CommitError => e
+    puts "Commit error"
+  rescue Netconf::RpcError => e
+    puts "General RPC error"
+  else
+    puts "Configuration Committed."
+  end  
+}
+
+
+

data/examples/jnpr/edit-config-jnpr.rb

@@ -0,0 +1,62 @@
+require 'net/netconf/jnpr'
+
+puts "NETCONF v.#{Netconf::VERSION}"
+
+login = { :target => 'vsrx', :username => "jeremy", :password => "jeremy1" }
+  
+new_host_name = "vsrx-jjj"
+
+puts "Connecting to device: #{login[:target]}" 
+
+Netconf::SSH.new( login ){ |dev|
+  puts "Connected!"
+  
+  location = Nokogiri::XML::Builder.new{ |x| 
+    x.system {
+      x.location {
+        x.building "Main Campus, C"
+        x.floor 15
+        x.rack 37
+      }
+    }
+  }
+  
+  begin
+    
+    rsp = dev.rpc.lock_configuration
+
+    # --------------------------------------------------------------------    
+    # configuration as BLOCK
+    
+    rsp = dev.rpc.load_configuration{ |x| 
+      x.system {
+        x.send(:'host-name', new_host_name )
+      }
+    }
+    
+    # --------------------------------------------------------------------
+    # configuration as PARAM
+    
+    rsp = dev.rpc.load_configuration( location )
+    rpc = dev.rpc.check_configuration
+    rpc = dev.rpc.commit_configuration
+    rpc = dev.rpc.unlock_configuration
+    
+  rescue Netconf::LockError => e
+    puts "Lock error"
+  rescue Netconf::EditError => e
+    puts "Edit error"    
+  rescue Netconf::ValidateError => e
+    puts "Validate error"
+  rescue Netconf::CommitError => e
+    puts "Commit error"
+  rescue Netconf::RpcError => e
+    puts "General RPC error"
+    binding.pry
+  else
+    puts "Configuration Committed."
+  end  
+}
+
+
+

data/examples/jnpr/edit-config-std.rb

@@ -0,0 +1,65 @@
+require 'net/netconf'
+
+puts "NETCONF v.#{Netconf::VERSION}"
+
+login = { :target => 'vsrx', :username => "jeremy", :password => "jeremy1" }
+  
+new_host_name = "vsrx-abc"
+
+puts "Connecting to device: #{login[:target]}" 
+
+Netconf::SSH.new( login ){ |dev|
+  puts "Connected!"
+  
+  target = 'candidate'
+  
+  location = Nokogiri::XML::Builder.new{ |x| x.configuration {
+    x.system {
+      x.location {
+        x.building "Main Campus, A"
+        x.floor 5
+        x.rack 27
+      }
+    }
+  }}
+  
+  begin
+    
+    rsp = dev.rpc.lock target
+
+    # --------------------------------------------------------------------    
+    # configuration as BLOCK
+    
+    rsp = dev.rpc.edit_config{ |x| x.configuration {
+      x.system {
+        x.send(:'host-name', new_host_name )
+      }
+    }}
+    
+    # --------------------------------------------------------------------
+    # configuration as PARAM
+    
+    rsp = dev.rpc.edit_config( location )
+    
+    rsp = dev.rpc.validate target
+    rpc = dev.rpc.commit
+    rpc = dev.rpc.unlock target
+    
+  rescue Netconf::LockError => e
+    puts "Lock error"
+  rescue Netconf::EditError => e
+    puts "Edit error"    
+  rescue Netconf::ValidateError => e
+    puts "Validate error"
+  rescue Netconf::CommitError => e
+    puts "Commit error"
+  rescue Netconf::RpcError => e
+    puts "General RPC error"
+    binding.pry
+  else
+    puts "Configuration Committed."
+  end  
+}
+
+
+

data/examples/jnpr/edit-config-text-std.rb

@@ -0,0 +1,69 @@
+require 'net/netconf'
+
+puts "NETCONF v.#{Netconf::VERSION}"
+
+login = { :target => 'vsrx', :username => "jeremy", :password => "jeremy1" }
+  
+new_host_name = "vsrx"
+
+puts "Connecting to device: #{login[:target]}" 
+
+Netconf::SSH.new( login ){ |dev|
+  puts "Connected!"
+  
+  target = 'candidate'
+  
+  location = Nokogiri::XML::Builder.new{ |x| x.send(:'configuration-text', <<-EOCONF
+    system {
+      location {
+        building "Main Campus, ABC123"
+        floor 5
+        rack 27
+      }
+    }
+EOCONF
+  )}
+  
+  
+  begin
+    
+    rsp = dev.rpc.lock target
+
+    # --------------------------------------------------------------------    
+    # configuration as BLOCK
+    
+    rsp = dev.rpc.edit_config(:toplevel => 'config-text'){ 
+      |x| x.send(:'configuration-text', <<EOCONF
+      system {
+        host-name #{new_host_name};
+      }
+EOCONF
+    )}
+    
+    # --------------------------------------------------------------------
+    # configuration as PARAM
+    
+    rsp = dev.rpc.edit_config( location, :toplevel => 'config-text' )
+    
+    rsp = dev.rpc.validate target
+    rpc = dev.rpc.commit
+    rpc = dev.rpc.unlock target
+    
+  rescue Netconf::LockError => e
+    puts "Lock error"
+  rescue Netconf::EditError => e
+    puts "Edit error"    
+  rescue Netconf::ValidateError => e
+    puts "Validate error"
+  rescue Netconf::CommitError => e
+    puts "Commit error"
+  rescue Netconf::RpcError => e
+    puts "General RPC error"
+    binding.pry
+  else
+    puts "Configuration Committed."
+  end  
+}
+
+
+

data/examples/jnpr/get-config-jnpr.rb

@@ -0,0 +1,59 @@
+require 'net/netconf/jnpr'      # note: including Juniper specific extension
+
+puts "NETCONF v.#{Netconf::VERSION}"
+
+login = { :target => 'vsrx', :username => "jeremy", :password => "jeremy1" }
+  
+puts "Connecting to device: #{login[:target]}" 
+
+Netconf::SSH.new( login ){ |dev|
+  puts "Connected."
+  
+  puts "Retrieving full config, please wait ... "
+  cfgall = dev.rpc.get_configuration                   # Junos specific RPC
+  puts "Showing 'system' hierarchy ..."
+  puts cfgall.xpath('system')                          # Root is <configuration>, so don't need to include it in XPath  
+
+  # ----------------------------------------------------------------------  
+  # specifying a filter as a block to get_configuration
+  # Junos extension does the proper toplevel wrapping
+
+  puts "Retrieved services from BLOCK, as XML:"
+  
+  cfgsvc1_1 = dev.rpc.get_configuration{ |x|
+    x.system { x.services }
+  }
+  
+  cfgsvc1_1.xpath('system/services/*').each{|s| puts s.name }
+
+  puts "Retrieved services from BLOCK, as TEXT:"
+  
+  cfgsvc1_2 = dev.rpc.get_configuration( :format => 'text' ){ |x|
+    x.system { x.services }
+  }
+  
+  puts cfgsvc1_2.text
+  
+  # ----------------------------------------------------------------------
+  # specifying a filter as a parameter to get_configuration
+  
+  filter = Nokogiri::XML::Builder.new{ |x|
+    x.system { x.services }
+  }
+
+  puts "Retrieved services by PARAM, as XML"  
+  
+  cfgsvc2 = dev.rpc.get_configuration( filter )
+  cfgsvc2.xpath('system/services/*').each{|s| puts s.name }
+
+  # ----------------------------------------------------------------------
+  # specifying a filter as a parameter to get_configuration,
+  # get response back in "text" format
+
+  puts "Retrieved services by PARAM, as TEXT:"    
+  cfgsvc3 = dev.rpc.get_configuration( filter, :format => 'text' )
+  puts cfgsvc3.text
+}
+
+
+

data/examples/jnpr/get-config-matching.rb

@@ -0,0 +1,20 @@
+require 'net/netconf/jnpr'
+
+puts "NETCONF v.#{Netconf::VERSION}"
+
+login = { :target => 'vsrx', :username => "jeremy", :password => "jeremy1" }
+
+Netconf::SSH.new( login ){ |dev|
+  
+  configs = dev.rpc.get_configuration{ |x|
+    x.interfaces( :matching => 'interface[name="ge-*"]' )
+  }
+  
+  ge_cfgs = configs.xpath('interfaces/interface')
+  
+  puts "There are #{ge_cfgs.count} GE interfaces:"
+  ge_cfgs.each{|ifd|     
+    units = ifd.xpath('unit').count    
+    puts "   " + ifd.xpath('name')[0].text  + " with #{units} unit" + ((units>1) ? "s" : '')    
+  }  
+}

data/examples/jnpr/get-config-std.rb

@@ -0,0 +1,49 @@
+require 'net/netconf'
+
+puts "NETCONF v.#{Netconf::VERSION}"
+
+login = { :target => 'vsrx', :username => "jeremy", :password => "jeremy1" }
+  
+puts "Connecting to device: #{login[:target]}" 
+
+Netconf::SSH.new( login ){ |dev|
+  puts "Connected."
+
+  # ----------------------------------------------------------------------  
+  # retrieve the full config.  Default source is 'running'
+  # Alternatively you can pass the source name as a string parameter 
+  # to #get_config
+  
+  puts "Retrieving full config, please wait ... "
+  cfgall = dev.rpc.get_config                   
+  puts "Showing 'system' hierarchy ..."
+  puts cfgall.xpath('configuration/system')     # JUNOS toplevel config element is <configuration> 
+
+  # ----------------------------------------------------------------------  
+  # specifying a filter as a block to get_config
+  
+  cfgsvc1 = dev.rpc.get_config{ |x|
+    x.configuration { x.system { x.services }}
+  }
+  
+  puts "Retrieved services as BLOCK:"
+  cfgsvc1.xpath('//services/*').each{|s| puts s.name }
+  
+  # ----------------------------------------------------------------------
+  # specifying a filter as a parameter to get_config
+  
+  filter = Nokogiri::XML::Builder.new{ |x|
+    x.configuration { x.system { x.services }}
+  }
+  
+  cfgsvc2 = dev.rpc.get_config( filter )
+  puts "Retrieved services as PARAM:"  
+  cfgsvc2.xpath('//services/*').each{|s| puts s.name }
+  
+  cfgsvc3 = dev.rpc.get_config( filter )
+  puts "Retrieved services as PARAM, re-used filter"  
+  cfgsvc3.xpath('//services/*').each{|s| puts s.name }        
+}
+
+
+