Integration with Harvest for launching hrefresh on Promote

Document ID : KB000115917
Last Modified Date : 26/09/2018
Show Technical Document Details
Issue:
When changing the status from "In Development" to "Test" in an ALC work item "Project" the promote executes in Harvest however the post linked udp in Harvest, "hrefresh" does not fire. When launching the promote from the process menu the following error message is found.
 
Environment:
ALC v 3.0.0.3
SCM v13+
all platforms
Cause:
ALC’s server_launcher.log shows:

I00020133: HRefresh error: Broker Name must be specified. .
I00020133: Exiting... .
E03020516: Execution of server UDP program hrefresh -b "" -pr "SampleProject" -st "Test" -nst "Development"  has failed. Exit code: 1 .
E03060019: Process Execute failed. Process Name: hrefresh .
S10060051: The PostLinked process(es) failed for parent process: Demote to Development .
I0009002e: Information: harvest  has successfully logged out from Harvest broker scm-broker .
I0009002d: Information: harvest  has successfully logged into Harvest broker scm-broker .
I0009002e: Information: harvest  has successfully logged out from Harvest broker scm-broker .

It appears that when your ALC project initiates a promote process in SCM, the "broker" parameter is not sent and is left blank.
Resolution:
In Harvest Admin tool, went to Promote process’s postlink UDP definition and replaced “[broker]” with actual name of the broker.  

This fixed the problem.