Automatically Discovering DRb Services with Rinda

Credit: James Edward Gray II


You want to distribute Ruby code across your local network without hardcoding the clients with the addresses of the servers.


Using Rubys standard Rinda library, its easy to provide zero-configuration networking for clients and services. With Rinda, machines can discover DRb services without providing any addresses. All you need is a running RingServer on the local network:

	# rinda_server.rb

inda/ring # for RingServer
inda/tuplespace # for TupleSpace


	# Create a TupleSpace to hold named services, and start running.



The RingServer provides automatic service detection for DRb servers. Any machine on your local network can find the local RingServer without knowing its address. Once its found the server, a client can look up services and use them, not having to know the addresses of the DRb servers that host them.

To find the Rinda server, a client broadcasts a UDP packet asking for the location of a RingServer. All computers on the local network will get this packet, and if a computer is running a RingServer, it will respond with its address. A server can use the RingServer to register services; a client can use the RingServer to look up services.

A RingServer object keeps a service listing in a shared TupleSpace (see Recipe 16.12). Each service has a corresponding tuple with four members:

  • The literal symbol :name, which indicates that the tuple is an entry in the RingServer namespace.
  • The symbol of a Ruby class, indicating the type of the service.
  • The DRbObject shared by the service.
  • A string description of the service.

By retrieving this TupleSpace remotely, you can look up services as tuples and advertise your own services. Lets advertise an object (a simple TupleSpace) tHRough the RingServer under the name :TupleSpace:

	# share_a_tuplespace.rb

rinda/ring # for RingFinger and SimpleRenewer
rinda/tuplespace # for TupleSpace

	ring_server = Rinda::RingFinger.primary

	# Register our TupleSpace service with the RingServer
	ring_server.write( [:name, :TupleSpace,, Tuple Space], )

The SimpleRenewer sent in with the namespace listing lets the RingServer periodically check whether the service has expired.

Now we can write clients that find this service by querying the RingServer, without having to know which machine it lives on. All we need to know is the name of the service:

	# use_a_tuplespace.rb

inda/ring # for RingFinger
inda/tuplespace # for TupleSpaceProxy

	ring_server = Rinda::RingFinger.primary

	# Ask the RingServer for the advertised TupleSpace.
	ts_service =[:name, :TupleSpace, nil, nil])[2]
	tuplespace =

	# Now we can use the object normally:
	tuplespace.write([:data, rand(100)])
	puts "Data is #{[:data, nil]).last}."
	# Data is 91.

These two programs locate each other without needing hardcoded IP addresses. Addresses are still being used under the covers, but the address to the Rinda server is discovered automatically through UDP, and all the other addresses are kept in the Rinda server.

Rinda::RingFinger.primary stores the first RingServer to respond to your Ruby processs UDP packet. If your local network is running more than one RingServer, the first one to respond might not be the one with the service you want, so you should probably only run one RingServer on your network. If you do have more than one RingServer, you can iterate over them with Rinda::RingFinger#each.

See Also

  • Recipe 16.12, "Creating a Shared "Whiteboard"
  • Recipe 16.18, "A Remote-Controlled Jukebox"
  • Eric Hodel has a Rinda::RingServer tutorial at



Date and Time



Files and Directories

Code Blocks and Iteration

Objects and Classes8

Modules and Namespaces

Reflection and Metaprogramming


Graphics and Other File Formats

Databases and Persistence

Internet Services

Web Development Ruby on Rails

Web Services and Distributed Programming

Testing, Debugging, Optimizing, and Documenting

Packaging and Distributing Software

Automating Tasks with Rake

Multitasking and Multithreading

User Interface

Extending Ruby with Other Languages

System Administration

Ruby Cookbook
Ruby Cookbook (Cookbooks (OReilly))
ISBN: 0596523696
EAN: 2147483647
Year: N/A
Pages: 399 © 2008-2020.
If you may any questions please contact us: