Netscaler Gem

A gem that uses the Netscaler Nitro API 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.

THIS IS PRE-ALPHA!!!

It is currently Pre-Alpha hence the 0-dot version and is susceptible to methods, classes and modules being renamed, added or deleted. I will try my best to back support as much as I can but will provide release notes of changes. Would love to get community support, I have access to a Netscaler and will add this to the spec as well down the road.

How it works

Connecting to a Netscaler

All params are hash keys. So to create a new connection to a netscaler:

conn = Netscaler::Connection :hostname => 'netscaler01', :username => 'foo', :password => 'bar'

If you want to disable ssl verification provide the optional param :verify_ssl => false

conn = Netscaler::Connection :hostname => 'netscaler01', :username => 'foo', :password => 'bar', :verify_ssl => false

Disabling and Enabling a Service

We try to keep the classes and methods match the command groups that are in the netscaler cli. So if you are familiar with this then it should be pretty easy to guess what the methods will look like. Such as:

disable service service01

conn.service.disable(:name => 'service01')

enable service service01

conn.service.enable(:name => 'service01')

TODO

Classes and methods for Rewrite policies and actions
Classes and methods for Responder policies and actions
Classes and methods for Content Switching policies
Add new definitions for deleting netscaler object entities
Add stats
Add support for Nitro 10.0, 10.1

Contributing to Netscaler Gem

When writing a new class or method we want to try to follow the same names as the command(s) that is in the NSCLI. For instance:

NSCLI

add server <name> (<IPAddress> | (<domain>)

RUBY

conn.server.add :name => 'foo', :domain => '1.1.1.1'

Here is another example, adding an lb vserver. We created a sub class of Lb called Netscaler::Lb::Vserver. So it would look something like: