KBEA-00103 - Installing the backward-compatible eMake package on agents

Article ID:360032826332
2 minute readKnowledge base

Summary

You want to install the backward-compatible eMake package on agents. There may be different reasons why you want to install the backward-compatibility package:

  • You have new agents in the cluster that have only the most recent version of ElectricAccelerator, and you have old agents that were upgraded to the most recent version. To allow old eMakes to use the new agent machines, you must install the backward-compatibility package on the new agents.

  • You encountered incompatibility error messages, indicating the eMake and agent software versions are not compatible:

    • ERROR EC1050: 049300C4:
      The protocol version of Electric Make (45) is incompatible with the software installed on the Electric Cloud cluster 192.168.6.8 (55).
      You need to upgrade your copy of Electric Make; aborting build

    • ERROR EC1050: 049300C4:
      The protocol version of this application (45) is incompatible with the software installed on the Electric Accelerator cluster 192.168.6.8 (55).
      You need to upgrade your client application; aborting build

Solution

Electric Cloud provides archives of eMake versions on the Electric Cloud Sharefile site.

For a single agent machine

  1. Open https://downloads.cloudbees.com/cloudbees-build-acceleration/

  2. Download the appropriate set of archive files (for example, i686_win32_bcp.zip [all previous eMake versions] or i686_win32_5.2.5_bcp.zip [a single eMake version]) from the Electric Cloud Sharefile site:
    products/accelerator/emake_archive//<platform>.

  3. Unpack the archive in the current directory (<`installDir>`). For Windows, make sure the extraction destination is <`installDir>` without any sub-directories, such as c:/ECloud.

  4. Repeat the process for each new agent machine.

For multiple agent machines

  1. Open https://downloads.cloudbees.com/cloudbees-build-acceleration/

  2. Change to a temporary directory (such as /var/tmp, or c:/Windows/Temp).

  3. Download the appropriate set of archive files (for example, i686_win32_bcp.zip [all previous eMake versions] or i686_win32_5.2.5_bcp.zip [a single eMake version]) from the Electric Cloud Sharefile site:
    products/accelerator/emake_archive/<platform>.

  4. Unpack the archive in the current directory. For Windows, make sure the extraction destination is the temporary directory (or the directory from step 2) without any sub-directories, such as c:/Windows/Temp.

  5. Run (as an example): clusterupload --cm <`cmname> i686_win32 c:/ECloud`.

For additional information about how to indicate a range/group of hostnames/IPs for the clusterexec command, see the online help system in the Cluster Manager GUI.

Protocol changes

Occasionally, ElectricAccelerator may contain protocol changes that make it necessary to update the eMake version on the build machines. Starting with ElectricAccelerator 6.0 an eMake-only installer is available for this type of update.

Customizing the version mismatch warning

On the Cluster Manager, modify file <installDir >/<arch>/conf/version_mismatch.txt. It may be necessary to bounce the Cluster Manager after changing the warning message.

Applies to

  • Product versions: All

  • OS versions: All