My reason for OSS

I have spent close to 6 hours today trying to figure out why Netscaler nitro api’s login won’t work… Finally someone from irc pointed out this blog and i realized i was sending the credentials without the “object ” part… Damn… you Documentations…This is one of the main reasons i am a huge supporter of open-source… Now the documentation did not say not to send object as part of data, neither did it say it needs to be sent.. From the way it was given and my pythonized brain, i just assumed it to be a dictionary object and “object ” just being a variable….

If i had access to the source, i would have read it instead… agreed familiarity with the language matters, but …

Again, NetScaler proves they don’t have a technical writing department or it sucks. Take a look at this.
The part where they tell you how to use the configuration utility has more options. i am sure they assumed it’s common knowledge for shell experts, but then, they don’t provide any POSIX standard shell, but a customized one. (atleast that’s how it looks to me.) So WTF? why can’t you guys document??

Update 05-Jan-2012:
Oh they definitely need some writing skills.. they are making a lot of assumptions about the reader.. As far as the nitro api goes it seems servicegroup and service interchangeable when creating a binding…F.U..F.U..

And if i try to pass in the servicegroupname instead of servicename it errors out saying “Operation not permitted”. That’s the problem, but the fact that if i login to the LB and say bind lbvserver that works fine for the same values.. Clearly netscaler is doing some magic behind the scenes.. i.e: creating a default service or something like that when i run the bind command from the shell…
I understand why these were designed this way.. nitro api is just too much work to do all of this, and also a security risk… But the real wtf is not mentioning it in the Nitro documentation or may be i should look for different Nitro documentation than Getting started one??

Update 12-01-2012:
And WTF with capitalizing some variable letters when throwing mandatory arguments error?? trying to mislead the developer?? or just you don’t care about how the message looks to the developer????????

Boastless, shameless, Just neutral Self-Plug: There’s an existing nsnitro repo i forked it here.

2 thoughts on “My reason for OSS

  1. You do have the source by the way :) Check out downloads section of netscaler’s GUI, you will find the API doc and 2 SDKs, Java and C#, both with sources. How do you think I forked off the Python version? :)


    1. I saw those API clients indeed.. I did not look at them, since i seem to have biases against both of those languages*…Anyway, i was thinking of the server side source to look at … but in retrospect it doesn’t make sense to look at that either, since i would have trudge through the apache/webserver’s source (likely to be humongous)……
      Anyway, thanks for the nsnitro it simplifies a lot of stuff. let me know if you need help with that…

      *– Time to get rid of bias(perhaps just laziness??) against programming languages.


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.