F5::Icontrol

This is the F5-control gem. If you have an F5, it can use the iControl SOAP interface to automate things

This is not the official library. That one is here. This copy is without warranty. Heck, it probably doesn't even work.

I originally set out to improve the official one:

But given the original one was pretty bare-bones, I started over.

Installation

Add this line to your application's Gemfile:

gem 'f5-icontrol'

And then execute:

$ bundle

Or install it yourself as:

$ gem install f5-icontrol

First, configure the gem:

F5::Icontrol.configure do |f|
  f.host = "hostname.of.bigip"
  f.username = "username"
  f.password = "password"
end

Then use it:

api = F5::Icontrol::API.new
response = api.LocalLB.Pool.get_list

See specs subdir for more examples, especially as it pertains to passing parameters.

There's a command line version that's still being roughed out. You'll need a ~/.f5.yml file containing your login information:

host: foo.bar.com
username: admin
password: abc123

Then run f5 and it'll provide help