Nanite, Rails, Redis deployment gotchas

One of the problems (joys?) with new and exciting open source software is the relative scarcity of information available. Compound this with powerful/complex software and you get a real recipe for learning. This has been the case with getting a reliable Nanite deployment for Nanite is an incredibly powerful distributed background worker written in Ruby, which leverages the AMQP messaging protocol and the RabbitMQ server for fast, efficient and safe job creation and passing. I am not going to bother detailing what Nanite is, since that information is readily available on the GitHub page, but rather am going to talk about a few gotchas.

Nanite is fairly simple to get running, however there are a few caveats. If you plan on using it with a Rails application, you have some choices: you can either do a few things by hand (not too bad) or you can use the nanite-rails plugin. I started with the plugin, but decided less is better and stripped it out, and am now just running Nanite plain. The one thing I did keep was the nanite.rb initializer file for getting started with various servers. Since I test locally on thin and deploy on Passenger, using the nanite-rails provided script worked well.

The first issue I noticed, is that multiple agents were receiving the same message (job) from my rails mapper(s) when the job was pushed from within an agent itself, rather from code in the mappers eventmachine loop. Simply put: all agents were receiving the same job when the job was sent from within an agent. It turns out that this is due to each mapper having no idea what other mappers are doing. This is possibly considered a “feature” and may or may not be addressed by the Nanite developers. The reason they are non-committal is due to the fact the problem is solved when you couple Nanite with Redis. If you don’t know what Redis is, go ahead and readup, but basically it is a key/value storage similar to memcached, except it can persist data to disk and you can store simple data structures within, rather than plain strings. In any event, Nanite can use Redis to store state, which is central to all mappers. This way, every mapper knows about every other mapper, and duplicate requests are not assigned to agents.

Here is a direct link to the issue.

To use Redis with Nanite, simply include a configuration option when starting a mapper:

Nanite.start_mapper(:host => 'localhost', ...., :redis => "REDIS_HOST:REDIS_PORT")

If you don’t want to use Redis, the problem can be worked around with some massaging of the Nanite code. You can checkout how this is done by visiting nofxx’s fork of Nanite on GitHub and seeing what he did.

The next problem I encountered was my agents getting swamped with messages, timing out and freezing. The reason this happens, is that RabbitMQ stuffs data down a socket and keeps it full. The moment that socket is emptied, RabbitMQ shoves more down the socket. However on the receiving end the AMQP client utilizes EventMachine, which has a reactor loop that visits each socket within the loop in turn. It keeps a connection open to the socket corresponding to the queue it is subscribed to (queue for that agent), and blocks while that socket is full, meaning it is unable to move on to the next socket/queue. So, RabbitMQ keeps the socket full and EventMachine keeps emptying the socket as long as it is full, and we get a recipe for a headache.

RabbitMQ versions 1.6.0 and greated now have a configuration option called “prefetch”. This option limits the number of messages to stuff into that socket at any one time. So, where you would have 100+ messages in a socket by default, always causing that socket to be full, you can now tell RabbitMQ to give you one message at a time in the socket. This allows EventMachine to keep up with all the sockets. If you have longer running tasks (multiple seconds), setting prefetch to 1 will keep everything happy. If you can slam through tons of messages a second, larger prefetch values will avoid extra looping and can help speed things up.

Now this is where we have a problem!!! Nanite offers a prefetch configuration option, but it is only on the mapper! The problem we need to solve is the queues corresponding to the agents, so the prefetch configuration option needs to be set for agent queues, not the mapper queue (which can handle large numbe of messages, since they are just acks, pings and responses from agents). This is where we need to dive into the Nanite source and change some stuff. The less adventerous can just pull my Nanite fork on GitHub until these changes are accepted upstream, the more adventerous can look at how the prefetch option is passed to the mapper, and repeat it on the agent. You can see below my modified setup_queue() method, with the first three lines added.

def setup_queue
  if amq.respond_to?(:prefetch) && @options.has_key?(:prefetch)
  amq.queue(identity, :durable => true).subscribe(:ack => true) do |info, msg|
    rescue Exception => e
      Nanite::Log.error("RECV #{e.message}")

Finally, I was having problems with intermittently losing jobs spawned from my web interface, which is deployed on passenger. After a huge amount of struggling, I finally conceded that eventmachine and passenger are not compatible in passengers smart spawning mode. So, I set passengers spawning mode to conservative and enjoyed a much more robust deployment!

I am sure some more info will follow, but this should be enough to get you going.