EC1111

Synopsis

ERROR EC1111: Agent protocol version mismatch: the protocol used by emake is newer than the newest version supported by agent [agent]. Upgrade the agent, or downgrade emake (emake has version [MM], agent has [NN]).

Description

Electric Make uses a custom network protocol to communicate with agents in the CloudBees Build Acceleration cluster. In order that the protocol may safely evolve over time to support new features or to fix defects, the protocol is versioned. This error indicates that your version of emake is newer than the agent indicated in the message.

The emake/agent protocol is versioned independently of the CloudBees Build Acceleration product version. It is common for the emake/agent protocol version to remain unchanged across multiple product versions of CloudBees Build Acceleration. In addition, the agent generally supports a wide range of emake/agent protocol versions, so that older versions of emake will work with newer agents, though the converse is not true.

Reasons

This error occurs when your version of Electric Make is incompatible with the version of CloudBees Build Acceleration agents installed on the named cluster. Some common causes of this error are:

  • The wrong cluster manager was specified when invoking emake.

  • The wrong build resource was specified when invoking emake, or the build resource is configured to include incompatible agents.

  • The wrong build class was specified when invoking emake, or the build class is configured to use a build resource which includes incompatible agents.

  • Your emake client has been upgraded but the agent software has not yet been upgraded.

  • You are testing a “hot patch” of emake which is incompatible with the agent software installed on the CloudBees Build Acceleration cluster.

Fixes

Verify your cluster manager, build resource and build class settings. If these are correct, then you must either upgrade the agents on the cluster, or downgrade to an earlier version of emake in order to avoid this error.