Hrefresh did not deploy the files
search cancel

Hrefresh did not deploy the files

book

Article ID: 122762

calendar_today

Updated On:

Products

CA Harvest Software Change Manager - OpenMake Meister CA Harvest Software Change Manager CA Harvest Software Change Manager - OpenMake Meister

Issue/Introduction

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:

Environment

Harvest Software Change Manager all versions and platforms

Cause

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.

Resolution

Options for resolution are: 

  • Move the files to a folder found within the folder structure specified by the viewpath setting in the hrefresh.cfg file (found in the broker machine in the %CA_SCM_HOME% folder).

  • Modify the hrefresh.cfg file to change the viewpath for your project and state so that the viewpath listed there includes the files you want to deploy.  For example,
    # 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
  • Modify the hrefresh.cfg file to add a second row for your project and state specifying where to deploy the files from the viewpath that is missing.  For example,
    # 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

     

Additional Information

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