netscaler 0.2.0 → 0.3.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    NGQ5ZjU2M2IyYWI3NDM4YWIxYmU1NWI3YjFlYzlmMDE2ODFkYTBkMA==
+    YTM3NDRkODQzNmM4MzYyMDhkZmZhYzFkODYzM2M5ZDdiODI0Mzc4ZQ==
   data.tar.gz: !binary |-
-    YWRlNGI3N2JhZGY0NmM3MWZiMWE0MjAyNDgyMWUzYzkxZjRiNGQ3Mw==
+    ZmMxMWVjMzk2Yjc2ZTAyZTRmOTlhYzEzMWJlY2M2OTUwMTI5NTMxMw==
 SHA512:
   metadata.gz: !binary |-
-    ZDE4YTIyMTRiMjQ2Yzc3NmJjNTZiYTVjNGNjMmVhYmI5NzQ2N2M1ZTY5ZTY1
-    YzMwODE3YzVmNDgwOWEyMGQyM2QwNTQwYzkyZTU4NmVlMTcyNWMxNTRiYTMy
-    NjkwMThlNjVhOWJjMTlhYjhlYjhhOTIyZTZjMGYwZDllOTAzNTc=
+    ZGQ5YmJjOTkyNTE0ZjQxNTY0MWQ0MWMxOWE2ZDJmMjVkZTcwMWVkOWVmMWRh
+    Y2UwNDIyNDlkNWJmMjQ1ZWNmZWY3MWY0YjE4NDE0MmVlN2U1NTU3MzhhOWE3
+    YjlhM2ZiOTUxZjJlYTI0MjYzZWM3NmI1NWEwYmQxZWQ0NjhjZWU=
   data.tar.gz: !binary |-
-    NWM3NmNhOTJhMjY0M2ZjODJkNmJmYzhiMTViMmQ4MTg5ZjJiMmI0ODRkMmJl
-    Nzc3YjBjZGNhZjMyMzY5YTAyMjU1NzE4NjIzNjNjYWJmZTA5Y2U0MTYyZWUw
-    MTNmMjAzNjAyNWZiZWFmYmRjNDA0ZWYzMjU4MjZjNDFmMDc4Y2E=
+    ZDM0MmI5YzcxYzU4OTAxZDRmNzJiZWQ5ZGYyN2ZlZGZlOGNjN2NlNGUxYzc0
+    ZDYwY2RmZTAyYmFiMmVlNWQxNTM4OGY1MmY4M2JjZDM3OWIxYTA1NjA0ZGVi
+    NWJhYTNiNWUzM2QwNTcxM2MzZjdjNWMzMzFkMmMzODg2YTk1N2U=

data/README.rdoc

@@ -1,3 +1,5 @@
+[![Build Status](https://travis-ci.org/GravityLabs/netscaler.svg?branch=master)](https://travis-ci.org/GravityLabs/netscaler)
+
 = Netscaler Gem
 
 A gem that uses the Netscaler {Nitro API}[http://support.citrix.com/proddocs/topic/netscaler-main-api-10-map/ns-nitro-wrapper-con.html] to access configs and stats.  This has been tested only on Netscaler 9.3.  Hoping to have Netscaler 10.0 support added in the near future.

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.3.0

data/lib/netscaler/connection.rb

@@ -10,6 +10,7 @@ require 'netscaler/load_balancing'
 require 'netscaler/http_adapter'
 require 'netscaler/adapter'
 require 'netscaler/policy'
+require 'netscaler/lb'
 
 module Netscaler
   class Connection
@@ -22,14 +23,16 @@ module Netscaler
 
       raise ArgumentError, "Required options are missing. #{missing_options.join(', ')}" if missing_options.length > 0
 
-      @username = options[:username]
-      @password = options[:password]
-      @adapter = HttpAdapter.new :hostname => "https://#{options[:hostname]}", :username => @username, :password => @password
+      @username   = options[:username]
+      @password   = options[:password]
+      @verify_ssl = options[:verify_ssl].nil? ? true : options[:verify_ssl]
+      @adapter = HttpAdapter.new :hostname => "https://#{options[:hostname]}", :username => @username, :password => @password, :verify_ssl => @verify_ssl
       @load_balancing = LoadBalancing.new self
       @service = Service.new self
       @servicegroups = ServiceGroup.new self
       @servers = Server.new self
       @policy = Policy.new self
+      @lb = Lb.new self
     end
 
     def adapter
@@ -56,6 +59,10 @@ module Netscaler
       @policy
     end
 
+    def lb
+      @lb
+    end
+
     def servers
       return @servers
     end
@@ -64,6 +71,10 @@ module Netscaler
       return @adapter.session
     end
 
+    def verify_ssl
+      return @verify_ssl
+    end
+
     def login()
       payload = {
         'username' => @username,

data/lib/netscaler/http_adapter.rb

@@ -5,7 +5,11 @@ require 'json'
 module Netscaler
   class HttpAdapter < Adapter
     def initialize(args)
-      @site=RestClient::Resource.new args[:hostname], args[:username], args[:password]
+      @site = RestClient::Resource.new(args[:hostname], {
+        :user       => args[:username],
+        :password   => args[:password],
+        :verify_ssl => args[:verify_ssl]
+      })
     end
 
     def post_no_body(part, data, args={})

data/lib/netscaler/lb.rb

@@ -0,0 +1,22 @@
+require 'netscaler/lb/monitor'
+require 'netscaler/lb/vserver'
+require 'netscaler/lb/vserver/bind'
+require 'netscaler/lb/vserver/unbind'
+
+module Netscaler
+  class Lb
+
+    def initialize(netscaler)
+      @netscaler = netscaler
+    end
+
+    def monitor
+      Monitor.new @netscaler
+    end
+
+    def vserver
+      Vserver.new @netscaler
+    end
+
+  end
+end

data/lib/netscaler/lb/monitor.rb

@@ -0,0 +1,37 @@
+require 'netscaler/netscaler_service'
+
+module Netscaler
+  class Lb
+    class Monitor < NetscalerService
+
+      def initialize(netscaler)
+        @netscaler = netscaler
+      end
+
+      def bind(payload) # :args: :monitorName => 'http', :entityName => 'foo' :entityType => '[service|servicegroup]'
+        raise ArgumentError, 'payload cannot be null' if payload.nil?
+        validate_payload(payload, [:monitorName, :entityName, :entityType])
+        valid_entityTypes = %w(service servicegroup)
+        raise ArgumentError, ":entityType does not equal one of the following: #{valid_entityTypes.flatten}" unless valid_entityTypes.include?(payload[:entityType])
+        new_payload = {:monitorName => payload[:monitorName],
+                       :"#{payload[:entityType]}Name" => payload[:entityName]}
+
+        return @netscaler.adapter.post_no_body("config/lbmonitor_#{payload[:entityType]}_binding/#{payload[:monitorName]}?action=bind",
+                                                {'params' => {'action' => 'bind'}, "lbmonitor_#{payload[:entityType]}_binding" => new_payload})
+      end
+
+      def unbind(payload) # :args: :monitorName => 'http', :entityName => 'foo' :entityType => '[service|servicegroup]'
+        raise ArgumentError, 'payload cannot be null' if payload.nil?
+        validate_payload(payload, [:monitorName, :entityName, :entityType])
+        valid_entityTypes = %w(service servicegroup)
+        raise ArgumentError, ":entityType does not equal one of the following: #{valid_entityTypes.flatten}" unless valid_entityTypes.include?(payload[:entityType])
+        new_payload = {:monitorName => payload[:monitorName],
+                       :"#{payload[:entityType]}Name" => payload[:entityName]}
+
+        return @netscaler.adapter.post_no_body("config/lbmonitor_servicegroup_binding/#{payload[:monitorName]}?action=unbind",
+                                               {'params' => {'action' => 'unbind'}, 'lbmonitor_servicegroup_binding' => new_payload})
+      end
+
+    end
+  end
+end

data/lib/netscaler/lb/vserver.rb

@@ -0,0 +1,52 @@
+require 'netscaler/netscaler_service'
+
+module Netscaler
+  class Lb
+    class Vserver < NetscalerService
+      def initialize(netscaler)
+        @netscaler=netscaler
+      end
+
+      def show(payload={})
+        if payload[:name] != nil then
+          validate_payload(payload, [:name])
+          return @netscaler.adapter.get("config/lbvserver/#{payload[:name]}")
+        elsif payload == {} then
+          return @netscaler.adapter.get('config/lbvserver/')
+        else
+          raise ArgumentError, 'payload supplied must have been missing :name'
+        end
+      end
+
+      def show_binding(payload)
+        raise ArgumentError, 'payload cannot be null' if payload.nil?
+        payload = Netscaler.hash_hack(payload)
+        validate_payload(payload, [:name])
+        return @netscaler.adapter.get("config/lbvserver_binding/#{payload[:name]}")
+      end
+
+      def remove(payload) # :args: :name
+        raise ArgumentError, 'payload cannot be null' if payload.nil?
+        payload = Netscaler.hash_hack(payload)
+        validate_payload(payload, [:name])
+        return @netscaler.adapter.delete("config/lbvserver/#{payload[:name]}")
+      end
+
+      def add(payload)
+        raise ArgumentError, 'payload cannot be null' if payload.nil?
+        payload = Netscaler.hash_hack(payload)
+        validate_payload(payload, [:name, :serviceType, :ipv46, :port])
+        return @netscaler.adapter.post_no_body('config/lbvserver/', {'lbvserver' => payload})
+      end
+
+      def bind
+        Bind.new @netscaler
+      end
+
+      def unbind
+        Unbind.new @netscaler
+      end
+
+    end
+  end
+end

data/lib/netscaler/lb/vserver/bind.rb

@@ -0,0 +1,27 @@
+module Netscaler
+  class Lb
+    class Vserver
+      class Bind < NetscalerService
+        def initialize(netscaler)
+          @netscaler=netscaler
+        end
+
+        def service(payload)
+          raise ArgumentError, 'payload cannot be null' if payload.nil?
+          validate_payload(payload, [:name, :serviceName])
+          return @netscaler.adapter.post_no_body("config/lbvserver_service_binding/#{payload['name']}?action=bind/", {'params' => {'action' => 'bind'}, 'lbvserver_service_binding' => payload})
+        end
+
+        def rewrite_policy(payload)
+          raise ArgumentError, 'payload cannot be null' if payload.nil?
+          validate_payload(payload, [:name, :policyName, :priority, :bindpoint])
+          return @netscaler.adapter.post_no_body("config/lbvserver_service_binding/#{payload['name']}?action=bind/", {'params' => {'action' => 'bind'}, 'lbvserver_rewritepolicy_binding' => payload})
+        end
+
+      end
+    end
+  end
+end
+
+
+

data/lib/netscaler/lb/vserver/unbind.rb

@@ -0,0 +1,29 @@
+#require 'netscaler/netscaler_service'
+module Netscaler
+  class Lb
+    class Vserver
+      class Unbind < NetscalerService
+        def initialize(netscaler)
+          @netscaler=netscaler
+        end
+
+        def service(payload)
+          raise ArgumentError, 'payload cannot be null' if payload.nil?
+          validate_payload(payload, [:name, :serviceName])
+          return @netscaler.adapter.post_no_body("config/lbvserver_service_binding/#{payload['name']}?action=unbind/", {'params' => {'action' => 'unbind'}, 'lbvserver_service_binding' => payload})
+        end
+
+        def rewrite_policy(payload)
+          raise ArgumentError, 'payload cannot be null' if payload.nil?
+          validate_payload(payload, [:name, :policyName])
+          return @netscaler.adapter.post_no_body("config/lbvserver_service_binding/#{payload['name']}?action=bind/", {'params' => {'action' => 'unbind'}, 'lbvserver_rewritepolicy_binding' => payload})
+        end
+
+
+      end
+    end
+  end
+end
+
+
+

data/lib/netscaler/mock_adapter.rb

@@ -53,5 +53,11 @@ module Netscaler
       return process_result(@result, @response)
     end
 
+    def delete(part, args={})
+      url = get_uri(part)
+      options = prepare_options(args)
+      return process_result(@result, @response)
+    end
+
   end
 end

data/lib/netscaler/monkey_patches.rb

@@ -1,5 +1,7 @@
 module Netscaler
-
+  # #hash_hack is mainly used in all the methods to provide backward compatibility for the older methods.
+  #  Prior to this the method argument keys were string.  We later made them to symbols.  This allows users
+  #  to use both but will eventually deprecate this.
   def self.hash_hack(hash)
     raise ArgumentError, 'payload must be a hash.' unless hash.is_a?(Hash)
     hash.default_proc = proc{|h, k| h.key?(k.to_s) ? h[k.to_s] : nil}

data/lib/netscaler/policy/stringmap.rb

@@ -7,9 +7,8 @@ module Netscaler
         @netscaler = netscaler
       end
 
-      def list(payload = nil)
+      def list(payload = nil) # :args: :name => 'foo'
         if payload !=nil then
-          payload = Netscaler.hash_hack(payload)
           validate_payload(payload, [:name])
           return @netscaler.adapter.get("config/policystringmap/#{payload[:name]}")
         else
@@ -17,23 +16,20 @@ module Netscaler
         end
       end
 
-      def add(payload)
+      def add(payload)  # :args: :name => 'foo'
         raise ArgumentError, 'payload cannot be null' if payload.nil?
-        payload = Netscaler.hash_hack(payload)
         validate_payload(payload, [:name])
         return @netscaler.adapter.post_no_body('config/policystringmap/', 'policystringmap' => payload)
       end
 
-      def get(payload)
+      def get(payload)  # :args: :name => 'foo'
         raise ArgumentError, 'arg must contain name of policystringmap! :name => "foo"' if payload.nil?
-        payload = Netscaler.hash_hack(payload)
         validate_payload(payload, [:name])
         return @netscaler.adapter.get("config/policystringmap_pattern_binding/#{payload[:name]}")
       end
 
-      def bind(payload)
+      def bind(payload)   # :args: :name => 'foo', :key => 'a', :value => '1'
         raise ArgumentError, 'payload cannot be null' if payload.nil?
-        payload = Netscaler.hash_hack(payload)
         validate_payload(payload, [:name, :key, :value])
         return @netscaler.adapter.post_no_body('config/policystringmap_pattern_binding/', 'policystringmap_pattern_binding' => payload)
       end

data/lib/netscaler/server.rb

@@ -6,16 +6,33 @@ module Netscaler
       @netscaler = netscaler
     end
 
-    def add_server(server)
+    ##
+    # method #add requires arg :name but :ipaddress and :domain are optional but requires one of them.
+    def add(server) # :args: :name => 'foo', :ipaddress => '192.168.1.10', :domain => 'bar.com'
       raise ArgumentError, 'server cannot be null' if server.nil?
       server = Netscaler.hash_hack(server)
-      if server[:ipaddress] != nil then
-        validate_payload(server, [:name, :ipaddress])
-      else
+      if server[:domain] != nil then
         validate_payload(server, [:name, :domain])
+      else
+        validate_payload(server, [:name, :ipaddress])
       end
 
       return @netscaler.adapter.post_no_body('config/server/', {'server' => server})
     end
+
+    def remove(payload) # :args: :server
+      raise ArgumentError, 'payload cannot be null' if payload.nil?
+      payload = Netscaler.hash_hack(payload)
+      validate_payload(payload, [:server])
+      return @netscaler.adapter.delete("config/server/#{payload[:server]}")
+    end
+
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #add instead=.
+    def add_server(server)
+      warn '[DEPRECATION] "add_server" is deprecated.  Please use "#add" instead.'
+      self.add server
+    end
   end
 end

data/lib/netscaler/service.rb

@@ -1,52 +1,104 @@
 require 'netscaler/netscaler_service'
 
 module Netscaler
+  ##
+  # Netscaler::Service handles all service entity calls.
+  # This includes #add, #enable, #disable and #show
   class Service < NetscalerService
     def initialize(netscaler)
       @netscaler=netscaler
     end
 
-    def add_service(payload)
+    ##
+    # This method require you already have a server created using Netscaler::Server#add
+    # or if it is already configured on the netscaler.
+    def add(payload)  # :args: :name, :serverName, :serviceType, :port
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:name, :serverName, :serviceType, :port])
       return @netscaler.adapter.post_no_body('config/service/', {'service' => payload})
     end
 
-    def get_service(payload)
-      raise ArgumentError, 'payload cannot be null' if payload.nil?
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #add instead=.
+    def add_service(payload)
+      warn '[DEPRECATION] "add_service" is deprecated.  Please use "#add" instead.'
+      self.add(payload)
+    end
+
+    ##
+    # :serverName is optional, if omitted it will return all services
+    # configured on the Netscaler.
+    def show(payload) # :args:  :serverName => 'foo'
+      return @netscaler.adapter.get('config/service/', args) if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:serviceName])
       return @netscaler.adapter.get("config/service/#{payload[:serviceName]}")
     end
 
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #show instead=.
+    def get_service(payload)
+      warn '[DEPRECATION] "get_service" is deprecated.  Please use "#show" instead.'
+      self.show(payload)
+    end
+
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #show instead=.
     def get_services(args={})
+      warn '[DEPRECATION] "get_services" is deprecated.  Please use "#show" instead.'
       return @netscaler.adapter.get('config/service/', args)
     end
 
-    def enable_service(payload)
+    def enable(payload) # :args:  :name => 'foo'
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:name])
       return @netscaler.adapter.post_no_body('config/service/', {'params' => {'action' => 'enable'}, 'service' => payload})
     end
 
-    def disable_service(payload)
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #enable instead=.
+    def enable_service(payload)
+      warn '[DEPRECATION] "enable_service" is deprecated.  Please use "#enable" instead.'
+      self.enable(payload)
+    end
+
+    def disable(payload) # :args:  :name => 'foo'
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:name])
       return @netscaler.adapter.post_no_body('config/service/', {'params' => {'action' => 'disable'}, 'service' => payload})
     end
 
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #disable instead=.
+    def disable_service(payload)
+      warn '[DEPRECATION] "disable_service" is deprecated.  Please use "#disable" instead.'
+      self.disable(payload)
+    end
 
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use Netscaler::Lb::Monitor.bind instead=.
     def lbmonitor_service_binding(payload)
+      warn '[DEPRECATION] "lbmonitor_service_binding" is deprecated.  Please use "Netscaler::Lb::Monitor.bind" instead.'
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:serviceName, :monitorName])
       return @netscaler.adapter.post_no_body("config/lbmonitor_service_binding/#{payload[:monitorName]}?action=bind", {'params' => {'action' => 'bind'}, 'lbmonitor_service_binding' => payload})
     end
 
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use Netscaler::Lb::Monitor.unbind instead=.
     def lbmonitor_service_unbinding(payload)
+      warn '[DEPRECATION] "lbmonitor_service_binding" is deprecated.  Please use "Netscaler::Lb::Monitor.bind" instead.'
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:serviceName, :monitorName])

data/lib/netscaler/servicegroup.rb

@@ -6,60 +6,123 @@ module Netscaler
       @netscaler=netscaler
     end
 
-    def add_servicegroup(payload)
+    def add(payload)  # :args: :serviceGroupName => 'foo', :serviceType => 'HTTP'
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:serviceGroupName, :serviceType])
       return @netscaler.adapter.post_no_body("config/servicegroup/", "servicegroup" => payload)
     end
 
-    def remove_servicegroup(payload)
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #add instead=.
+    def add_servicegroup(payload)
+      warn '[DEPRECATION] "add_servicegroup" is deprecated.  Please use "#add" instead.'
+      self.add(payload)
+    end
+
+    def remove(payload) # :arg: serviceGroupName
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:serviceGroupName])
       return @netscaler.adapter.delete("config/servicegroup/#{payload[:serviceGroupName]}")
     end
 
-    def get_servicegroup(payload)
-      raise ArgumentError, 'arg must contain name of servicegroup!' if payload.nil?
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #remove instead=.
+    def remove_servicegroup(payload)
+      warn '[DEPRECATION] "remove_servicegroup" is deprecated.  Please use "#remove" instead.'
+      self.remove(payload)
+    end
+
+    ##
+    # argument is optional, if left empty it will return all servicegroups
+    def show(payload) # :arg: servicegroupname
+      return @netscaler.adapter.get("config/servicegroup/", args) if payload.nil?
       return @netscaler.adapter.get("config/servicegroup/#{payload}")
     end
 
-    def get_servicegroups(args={})
-      return @netscaler.adapter.get("config/servicegroup/", args)
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #show instead=.
+    def get_servicegroup(payload)
+      warn '[DEPRECATION] "get_servicegroup" is deprecated.  Please use "#show" instead.'
+      self.show(payload)
+    end
+
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #show instead=.
+    def get_servicegroups(payload)
+      warn '[DEPRECATION] "get_servicegroup" is deprecated.  Please use "#show" instead.'
+      self.show(payload)
     end
 
-    def get_servicegroup_servicegroupmember_bindings(payload)
+    def show_bindings(payload)  # :args: servicegroupname
       return @netscaler.adapter.get("config/servicegroup_servicegroupmember_binding/#{payload}")
     end
 
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #show_bindings instead=.
+    def get_servicegroup_servicegroupmember_bindings(payload)
+      warn '[DEPRECATION] "get_servicegroup_servicegroupmember_bindings" is deprecated.  Please use "#show_bindings" instead.'
+      self.show_bindings(payload)
+    end
+
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use Netscaler::Lb::Monitor.bind instead=.
     def lbmonitor_servicegroup_binding(payload)
+      warn '[DEPRECATION] "lbmonitor_servicegroup_binding" is deprecated.  Please use "Netscaler::Lb::Monitor.bind" instead.'
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:serviceGroupName, :monitorName])
       return @netscaler.adapter.post_no_body("config/lbmonitor_servicegroup_binding/#{payload[:monitorName]}?action=bind",  {'params' => {'action' => 'bind'}, 'lbmonitor_servicegroup_binding' => payload})
     end
 
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use Netscaler::Lb::Monitor.unbind instead=.
     def lbmonitor_servicegroup_unbinding(payload)
+      warn '[DEPRECATION] "lbmonitor_servicegroup_unbinding" is deprecated.  Please use "Netscaler::Lb::Monitor.unbind" instead.'
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:serviceGroupName, :monitorName])
       return @netscaler.adapter.post_no_body("config/lbmonitor_servicegroup_binding/#{payload[:monitorName]}?action=unbind", {'params' => {'action' => 'unbind'}, 'lbmonitor_servicegroup_binding' => payload})
     end
 
-    def bind_servicegroup_servicegroupmember(payload)
+    def bind(payload) # :args:  :serviceGroupName => 'foo', :port => '80', :serverName => 'bar'
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:serviceGroupName, :port, :serverName])
       return @netscaler.adapter.post_no_body("config/servicegroup_servicegroupmember_binding/#{payload['serviceGroupName']}?action=bind", {'params' => {'action' => 'bind'}, 'servicegroup_servicegroupmember_binding' => payload})
     end
 
-    def unbind_servicegroup_servicegroupmember(payload)
+
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #bind instead=.
+    def bind_servicegroup_servicegroupmember(payload)
+      warn '[DEPRECATION] "bind_servicegroup_servicegroupmember" is deprecated.  Please use #bind instead.'
+      self.bind(payload)
+    end
+
+    def unbind(payload) # :args:  :serviceGroupName => 'foo', :port => '80', :serverName => 'bar'
       raise ArgumentError, 'payload cannot be null' if payload.nil?
       payload = Netscaler.hash_hack(payload)
       validate_payload(payload, [:serviceGroupName, :port, :serverName])
       return @netscaler.adapter.post_no_body("config/servicegroup_servicegroupmember_binding/#{payload['serviceGroupName']}?action=unbind", {'params' => {'action' => 'unbind'}, 'servicegroup_servicegroupmember_binding' => payload})
     end
 
+    ##
+    # :category: Deprecated Methods
+    # DEPRECATED: Please use #unbind instead=.
+    def unbind_servicegroup_servicegroupmember(payload)
+      warn '[DEPRECATION] "unbind_servicegroup_servicegroupmember" is deprecated.  Please use #unbind instead.'
+      self.unbind(payload)
+    end
+
   end
 end

data/netscaler.gemspec

@@ -2,16 +2,16 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: netscaler 0.2.0 ruby lib
+# stub: netscaler 0.3.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "netscaler"
-  s.version = "0.2.0"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib"]
   s.authors = ["Jeremy Custenborder", "David Andrew", "Jarrett Irons"]
-  s.date = "2014-07-21"
+  s.date = "2014-10-26"
   s.description = "Netscaler api working against the Citrix Nitro api.  Currently supports Nitro 9.3.  Hope to add support for 10.X.  Currently has support for som basics such as adding servers/services/servicegroups."
   s.email = ["jeremy@scarcemedia.com", "david.andrew@webtrends.com", "jarrett.irons@gmail.com"]
   s.extra_rdoc_files = [
@@ -31,6 +31,11 @@ Gem::Specification.new do |s|
     "lib/netscaler/adapter.rb",
     "lib/netscaler/connection.rb",
     "lib/netscaler/http_adapter.rb",
+    "lib/netscaler/lb.rb",
+    "lib/netscaler/lb/monitor.rb",
+    "lib/netscaler/lb/vserver.rb",
+    "lib/netscaler/lb/vserver/bind.rb",
+    "lib/netscaler/lb/vserver/unbind.rb",
     "lib/netscaler/load_balancing.rb",
     "lib/netscaler/mock_adapter.rb",
     "lib/netscaler/monkey_patches.rb",
@@ -41,6 +46,7 @@ Gem::Specification.new do |s|
     "lib/netscaler/service.rb",
     "lib/netscaler/servicegroup.rb",
     "netscaler.gemspec",
+    "spec/lbvserver_spec.rb",
     "spec/netscaler_spec.rb",
     "spec/policy_stringmap_spec.rb",
     "spec/server_spec.rb",

data/spec/lbvserver_spec.rb

@@ -0,0 +1,175 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+require 'netscaler'
+require 'netscaler/mock_adapter'
+
+describe Netscaler::Lb::Vserver do
+
+  connection = Netscaler::Connection.new 'hostname' => 'foo', 'password' => 'bar', 'username' => 'bar'
+  connection.adapter = Netscaler::MockAdapter.new :body => '{ "errorcode": 0, "message": "Done" }'
+
+  context 'when adding a new lbvserver' do
+    it 'a name is required' do
+      expect {
+        connection.lb.vserver.add(:serviceType => 'HTTP', :port => '80', :ipv46 => '1.1.1.1')
+      }.should raise_error(ArgumentError, /name/)
+    end
+
+    it 'a service type is required' do
+      expect {
+        connection.lb.vserver.add(:name => 'foo', :port => '80', :ipv46 => '1.1.1.1')
+      }.should raise_error(ArgumentError, /serviceType/)
+    end
+
+    it 'a port is required' do
+      expect {
+        connection.lb.vserver.add(:name => 'foo', :serviceType => 'HTTP', :ipv46 => '1.1.1.1')
+      }.should raise_error(ArgumentError, /port/)
+    end
+
+    it 'a ipv46 is required' do
+      expect {
+        connection.lb.vserver.add(:name => 'foo', :serviceType => 'HTTP', :port => '80')
+      }.should raise_error(ArgumentError, /ipv46/)
+    end
+
+    it 'return hash when supplied all required params' do
+      result = connection.lb.vserver.add(:name => 'foo', :serviceType => 'HTTP', :port => '80', :ipv46 => '1.1.1.1')
+      result.should be_kind_of(Hash)
+    end
+  end
+
+  context 'when using the show method in Lb::Vserver' do
+    it 'with no param used it will return all vservers' do
+      result = connection.lb.vserver.show
+      result.should be_kind_of(Hash)
+    end
+
+    it 'supplying the name parameter will return Hash' do
+      result = connection.lb.vserver.show :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+
+    it 'when showing a particular lb vserver string is invalid' do
+      expect {
+        connection.lb.vserver.show('asdf')
+      }.should raise_error(TypeError, /convert/)
+    end
+
+    it 'when showing a particular lb vserver :name is required' do
+      expect {
+        connection.lb.vserver.show(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+  end
+
+  context 'when removing an lb vserver' do
+    it 'a name is required' do
+      expect {
+        connection.lb.vserver.remove()
+      }.should raise_error(ArgumentError, /wrong number/)
+    end
+
+    it 'throw an arg error if :name arg is missing' do
+      expect {
+        connection.lb.vserver.remove(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+
+    it 'should return a hash if :name is supplied' do
+      result = connection.lb.vserver.remove :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+  end
+
+  context 'when showing lbvserver bindings' do
+    it 'should throw an error if there is no arg' do
+      expect {
+        connection.lb.vserver.show_binding()
+      }.should raise_error(ArgumentError, /wrong number/)
+    end
+
+    it 'throw an arg error if :name arg is missing' do
+      expect {
+        connection.lb.vserver.show_binding(:foo => 'bar')
+      }.should raise_error(ArgumentError, /name/)
+    end
+
+    it 'should return a hash if :name is supplied' do
+      result = connection.lb.vserver.show_binding :name => 'foo'
+      result.should be_kind_of(Hash)
+    end
+  end
+
+  context 'when [un]binding services to lb vserver' do
+    it 'should throw an error if :name arg is not given' do
+      expect {
+        connection.lb.vserver.bind.service :serviceName => 'foo'
+      }.should raise_error(ArgumentError, /name/)
+      expect {
+        connection.lb.vserver.unbind.service :serviceName => 'foo'
+      }.should raise_error(ArgumentError, /name/)
+    end
+
+    it 'should throw an error if :serviceName arg is not given' do
+      expect {
+        connection.lb.vserver.bind.service :name => 'foo'
+      }.should raise_error(ArgumentError, /serviceName/)
+
+      expect {
+        connection.lb.vserver.unbind.service :name => 'foo'
+      }.should raise_error(ArgumentError, /serviceName/)
+
+    end
+
+    it 'should return a Hash if all require arguments are supplied' do
+      result = connection.lb.vserver.bind.service :name => 'foo', :serviceName => ''
+      result.should be_kind_of(Hash)
+      unbind_result = connection.lb.vserver.unbind.service :name => 'foo', :serviceName => ''
+      unbind_result.should be_kind_of(Hash)
+
+    end
+  end
+
+  context 'when [un]binding rewritepolicies to lb vserver' do
+    it 'should throw an error if :name arg is not given' do
+      expect {
+        connection.lb.vserver.bind.rewrite_policy :policyName => 'bar', :priority => '10', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /name/)
+
+      expect {
+        connection.lb.vserver.unbind.rewrite_policy :policyName => 'bar', :priority => '10', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /name/)
+
+    end
+
+    it 'should throw an error if :policyName arg is not given' do
+      expect {
+        connection.lb.vserver.bind.rewrite_policy :name => 'foo', :priority => '10', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /policyName/)
+
+      expect {
+        connection.lb.vserver.unbind.rewrite_policy :name => 'foo', :priority => '10', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /policyName/)
+    end
+
+    it 'should throw an error if :priority arg is not given' do
+      expect {
+        connection.lb.vserver.bind.rewrite_policy :name => 'foo', :policyName => 'bar', :bindpoint => 'request'
+      }.should raise_error(ArgumentError, /priority/)
+    end
+
+    it 'should throw an error if :bindpoint arg is not given' do
+      expect {
+        connection.lb.vserver.bind.rewrite_policy :name => 'foo', :policyName => 'bar', :priority => '10'
+      }.should raise_error(ArgumentError, /bindpoint/)
+    end
+
+    it 'should return a Hash if all require arguments are supplied' do
+      result = connection.lb.vserver.bind.rewrite_policy :name => 'foo', :policyName => 'bar', :priority => '10', :bindpoint => 'request'
+      result.should be_kind_of(Hash)
+      unbind_result = connection.lb.vserver.unbind.rewrite_policy :name => 'foo', :policyName => 'bar'
+      unbind_result.should be_kind_of(Hash)
+    end
+  end
+
+end

data/spec/netscaler_spec.rb

@@ -19,6 +19,16 @@ describe Netscaler do
         netscaler = Netscaler::Connection.new 'username'=> 'foo', 'hostname' => 'bar'
       }.should raise_error(ArgumentError, /password/)
     end
+    it 'verify_ssl should be true' do
+      netscaler = Netscaler::Connection.new 'username'=> 'foo', 'hostname' => 'bar', 'password' => 'baz'
+      netscaler.verify_ssl == true
+    end
+    context 'if setting verify_ssl to false' do
+      it 'verify_ssl should be false' do
+        netscaler = Netscaler::Connection.new 'username'=> 'foo', 'hostname' => 'bar', 'password' => 'baz', 'verify_ssl' => false
+        netscaler.verify_ssl == false
+      end
+    end
   end
 
   context 'when logging in' do

data/spec/server_spec.rb

@@ -3,21 +3,47 @@ require 'netscaler'
 require 'netscaler/mock_adapter'
 
 describe Netscaler::Server do
-  context 'when adding a new server' do
-    connection = Netscaler::Connection.new 'hostname'=> 'foo', 'password' => 'bar', 'username'=> 'bar'
+  connection = Netscaler::Connection.new 'hostname'=> 'foo', 'password' => 'bar', 'username'=> 'bar'
+  connection.adapter = Netscaler::MockAdapter.new :body => '{ "errorcode": 0, "message": "Done" }'
 
+  context 'when adding a new server' do
     it 'a name is required' do
-      #netscaler.adapter = Netscaler::MockAdapter.new :status_code=>400, :body => '{ "errorcode": 1095, "message": "Required argument missing [name]", "severity": "ERROR" }',
-
       expect {
         connection.servers.add_server({'ipaddress'=>'123.123.123.123'})
       }.should raise_error(ArgumentError, /name/)
+
+      expect {
+        connection.servers.add({'ipaddress'=>'123.123.123.123'})
+      }.should raise_error(ArgumentError, /name/)
     end
 
-    it 'a domain is required' do
+    it 'an ipaddress is required' do
       expect {
         connection.servers.add_server({'name'=>'hostname'})
-      }.should raise_error(ArgumentError, /domain/)
+      }.should raise_error(ArgumentError, /ipaddress/)
+
+      expect {
+        connection.servers.add({'name'=>'hostname'})
+      }.should raise_error(ArgumentError, /ipaddress/)
+    end
+
+    it 'returns a Hash object if all necessary args are supplied' do
+      result = connection.servers.add :name => 'foo', :domain => 'foo.bar.com'
+      result.should be_kind_of(Hash)
+    end
+  end
+
+  context 'when removing a server' do
+    it ':server is required' do
+      expect {
+        connection.servers.remove({'ipaddress'=>'123.123.123.123'})
+      }.should raise_error(ArgumentError, /server/)
+    end
+
+    it 'returns a Hash object if all necessary args are supplied' do
+      result = connection.servers.remove :server => 'foo'
+      result.should be_kind_of(Hash)
     end
   end
+
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: netscaler
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Jeremy Custenborder
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-21 00:00:00.000000000 Z
+date: 2014-10-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
@@ -149,6 +149,11 @@ files:
 - lib/netscaler/adapter.rb
 - lib/netscaler/connection.rb
 - lib/netscaler/http_adapter.rb
+- lib/netscaler/lb.rb
+- lib/netscaler/lb/monitor.rb
+- lib/netscaler/lb/vserver.rb
+- lib/netscaler/lb/vserver/bind.rb
+- lib/netscaler/lb/vserver/unbind.rb
 - lib/netscaler/load_balancing.rb
 - lib/netscaler/mock_adapter.rb
 - lib/netscaler/monkey_patches.rb
@@ -159,6 +164,7 @@ files:
 - lib/netscaler/service.rb
 - lib/netscaler/servicegroup.rb
 - netscaler.gemspec
+- spec/lbvserver_spec.rb
 - spec/netscaler_spec.rb
 - spec/policy_stringmap_spec.rb
 - spec/server_spec.rb