I would like to add a agent prompt command (or an option to the failover command) to tell the agent to switch over to another server.  I think if I do:

setconfig rhq.agent.server.bind-address=my-new-server

That will tell it to switch, but 1) its ugly and 2) if the ports/transports are different, you have to setconfig those too.

The use case that I needed this was somewhat artificial - I had an agent talking to a server that did not have a plugin deployed there (but other servers in my cloud did).  I want to tell the agent "switch over to server X" where server X is one that I know has the plugin.

I'm sure there are more valid reasons for asking an agent to explicitly switch over - I can see that as a way to temporarily reduce load on a server, or for testing a new server (I have an agent in foreground with a prompt and I want to test the connectivity of a server, I can ask that agent to go switch and talk to that server and test it).

The prompt command I would like is something like this:

failover -s locator-uri-of-new-server

or

failover -s hostname-of-new-server

if <locator-uri-of-new-server> is not a true locator URI (i.e. its just <hostname-of-new-server>), I can assume its just a hostname and default to the agent's current transport, port and transport params.