When I try to use HRefresh to deploy the package, the messages in the Output Log make it appear that HRefresh executed normally, but no files were transferred. Here is an example scenario:
I checked out files for update from the \SampleRepository\SRC folder:
---------- Begin <Check Out for Update> Process ---------------
I00020110: File \SampleRepository\SRC\filea.txt;0 checked out to example-broker\\C:\Temp\filea.txt
I00020110: File \SampleRepository\SRC\fileb.txt;0 checked out to example-broker\\C:\Temp\fileb.txt
I00020110: File \SampleRepository\SRC\filec.txt;0 checked out to example-broker\\C:\Temp\filec.txt
I00060080: Check out summary: Total: 3; Success: 3; Failed: 0; Not Processed: 0.
---------- End <Check Out for Update> Process ---------------
Updated and checked them back into the package:
---------- Begin <Check In Items> Process ---------------
I00020100: File C:\Temp\filea.txt checked into \SampleRepository\SRC\filea.txt;1.
I00020100: File C:\Temp\fileb.txt checked into \SampleRepository\SRC\fileb.txt;1.
I00020100: File C:\Temp\filec.txt checked into \SampleRepository\SRC\filec.txt;1.
I00060079: Check in summary: Total: 3; Success: 3; Failed: 0; Not Processed: 0.
---------- End <Check In Items> Process ---------------
I then attempted to execute hrefresh to deploy these updated files to my example-agent server. The message in Workbench says Hrefresh execution was successful:
---------- Begin <Test Hrefresh> Process ---------------
I00020133: Processing SampleProject, Development, Check Out for Browse, \SampleRepository\DOCS, C:\Deployment\DOCS, Active, example-agent, 6000, harvest.dfo, agent.dfo.
I00020133: 1 jobs started/queued..
I00020133: HRefresh running asynchronously.HRefresh job -2320 initialized..
I00020133: HRefresh job -2320 locking semaphore file C:\Program Files\CA\SCM\SampleProject_Development_example-agent.lock....
I00020133: HRefresh job -2320 started..
I00020133: HRefresh job -2320 complete..
I00060052: Test Hrefresh execution was successful.
---------- End <Test Hrefresh> Process ---------------
Checking the end of the HRefresh log file (in the %CA_SCM_HOME%\log folder) we see:
I00060040: New connection with Broker example-broker established.
Selected Check Out process named Check Out for Browse.
Attempting to log into remote agent...
Connected
HSync has been executed successfully.
Yet, checking the example-agent server, no files were deployed:
Harvest Software Change Manager all versions and platforms
Hrefresh uses a comma-delimited configuration file called "hrefresh.cfg" (found in the broker machine in the %CA_SCM_HOME% folder) to determine where files are to be deployed for the projects and states in your Harvest repository. Each row in the file represents the instructions for a specific project and state.
Checking the "hrefresh.cfg" file we see this entry for the same project and state as the test scenario above:
# Project, State, Check-out process name, View path, Remote agent host path, Full/Active, Remote agent computer, Remote agent port, CA Harvest SCM user, Agent user
SampleProject, Development, Check Out for Browse, \SampleRepository\DOCS, C:\Deployment\DOCS, Active, example-agent, 6000, harvest.dfo, agent.dfo
This shows us that the "View path", the folder in the Harvest repository to by synchronized is "\SampleRepository\DOCS"
Looking at the above checkin to see the files in the package we notice:
---------- Begin <Check In Items> Process ---------------
I00020100: File C:\Temp\filea.txt checked into \SampleRepository\SRC\filea.txt;1.
I00020100: File C:\Temp\fileb.txt checked into \SampleRepository\SRC\fileb.txt;1.
I00020100: File C:\Temp\filec.txt checked into \SampleRepository\SRC\filec.txt;1.
I00060079: Check in summary: Total: 3; Success: 3; Failed: 0; Not Processed: 0.
---------- End <Check In Items> Process ---------------
The files in the package belong to a different folder, and not to the folder specified in the settings in hrefresh.cfg. Since HRefresh found no files from the \SampleRepository\DOCS folder in the package, no files were deployed to the example-agent server.
Options for resolution are:
# Project, State, Check-out process name, View path, Remote agent host path, Full/Active, Remote agent computer, Remote agent port, CA Harvest SCM user, Agent user
SampleProject, Development, Check Out for Browse, \SampleRepository, C:\Deployment, Active, example-agent, 6000, harvest.dfo, agent.dfo
# Project, State, Check-out process name, View path, Remote agent host path, Full/Active, Remote agent computer, Remote agent port, CA Harvest SCM user, Agent user
SampleProject, Development, Check Out for Browse, \SampleRepository\DOCS, C:\Deployment\DOCS, Active, example-agent, 6000, harvest.dfo, agent.dfo
SampleProject, Development, Check Out for Browse, \SampleRepository\SRC, C:\Deployment\SRC, Active, example-agent, 6000, harvest.dfo, agent.dfo
Details about how to configure Harvest to keep the Harvest repository and external server directories in synch (including setup and configuration for hrefresh) is found here: Synchronize Reference Directories