By default, AccuRev Plug-in for Jenkins checks out the latest changes without using a reference tree. When not
using a reference tree, AccuRev Plug-in for Jenkins uses the
accurev pop -R
command to extract all the files. However, there may be situations when the use of a
reference tree is preferred, such as when you want to use
the latest versions of files that you do not intend to modify. You can think of a reference tree as a read-only
portal to the AccuRev data repository.
If the Use Reference Tree check box is marked, AccuRev Plug-in for Jenkins attempts to use the reference tree specified in the Reference Tree text box. (You must create a reference tree in AccuRev before you can specify it here.) AccuRev Plug-in for Jenkins manages the process of migrating the reference tree to the appropriate build machine and relocating the reference tree to use the correct location. Note that these changes are recorded in the AccuRrev repository.
When using a reference tree, the following Accurev commands are used:
accurev show refs
confirms that the reference tree is valid and has the correct parent stream.
accurev chref
is run if the reference tree is in the wrong directory or on the wrong machine.
(Optional)
accurev update
refreshes the reference tree. If the update fails, AccuRev Plug-in for Jenkins
uses the accurev update -9
command to update the
reference tree.
accurev pop -O -R
ensures that all files are populated and that the reference tree always
contains the fresh update.