Remote agents are unable to validate the failover and connect to the server

Still need help?

The Atlassian Community is here for you.

Ask the community


Remote agent fails to connect to the server and the following errors show up in the logs:

2014-01-28 07:45:03,165 WARN [Thread-1] [BambooActiveMQConnectionFactory] Unable to validate failover:(tcp:// Illegal character in scheme name at index 0:
2014-01-28 07:49:18,822 ERROR [ActiveMQ Task-1] [FailoverTransport] Failed to connect to [tcp://] after: 10 attempt(s)
2014-01-28 07:49:18,824 WARN [Thread-1] [BambooJmsProxyFactoryBean] Exception when running afterPropertiesSet
javax.jms.JMSException: Connection refused
	at org.apache.activemq.util.JMSExceptionSupport.create(
	at org.apache.activemq.ActiveMQConnection.syncSendPacket(
	at org.apache.activemq.ActiveMQConnection.ensureConnectionInfoSent(
	at org.apache.activemq.ActiveMQConnection.start(
	at org.apache.activemq.pool.ConnectionPool.start(
	at org.apache.activemq.pool.PooledConnection.start(
	at org.logicblaze.lingo.jms.JmsProducerConfig.createConnection(
INFO   | jvm 10   | 2014/01/30 22:33:10 | 2014-01-30 22:32:56,575 WARN [Thread-1] [BambooActiveMQConnectionFactory] Unable to validate failover:(tcp:// Illegal character in scheme name at index 0:
INFO   | jvm 10   | 2014/01/30 22:33:10 | 2014-01-30 22:32:56,748 INFO [Thread-1] [BambooActiveMQConnectionFactory] Setting broker URL to 'failover:(tcp://'
INFO   | jvm 10   | 2014/01/30 22:33:10 | 2014-01-30 22:32:56,754 WARN [Thread-1] [BambooActiveMQConnectionFactory] Unable to validate failover:(tcp:// Illegal character in scheme name at index 0:
STATUS | wrapper  | 2014/01/30 22:36:15 | INT trapped.  Shutting down.


A new Bamboo instance is installed on the same machine as an existing instance. The existing instance is using TCP port 54663 for the broker port number.

The new Bamboo instance is configured to use a different port, in the example above 54671, for the broker where the remote agents connect. 

The old instance should stay alive until the new instance works correctly and has all the remote agents connected to it and can run builds successfully.


The remote agent cannot connect to the TCP port 54671 as configured for the broker port on the Bamboo server side.


Though it's not recommended to use a different port, if it's necessary to switch such as when running multiple Bamboo server instances on the same machine, only ONE port should be used for both "" and "". For example, for the new instance that would use TCP port 54671 for the broker:

<property name="">failover:(tcp://;maxReconnectAttempts=10</property>
<property name="">tcp://</property>

If modifying "" and "" from the UI (Bamboo Administration - > General Configuration), please note that they are in a different order than if you are editing them in the "bamboo.cfg.xml" file under <bamboo-home> directory:

Perform the following steps:

  1. Verify that one port used for "" and "" and the configuration in the UI or <bamboo-home>/bamboo.cfg.xml file is the expected one.
  2. Verify that the configured TCP port for the broker is open and accessible using a tools such as telnet or netcat from the remote agent. In the example above the TCP port number is 54671. If the port is closed then open it on the Bamboo server side for incoming connections from the remote agents.
  3. The property "" should generally be set to "" (which means listen on all interfaces) unless attempting to bind to a specific network interface.

  4. After checking the above, re-install or re-start the remote agent.
  • Remote agent on Bamboo version 5.3 and higher validates the client port during startup to make diagnosing such problems easier.

Last modified on Oct 7, 2019

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.