Using the Command Line Utilities › hrt Command-Restore

hrt Command-Restore

The CA Harvest SCM restore utility (hrt) lets administrators move archived data back to its original database.

Note: Administrators can use the archive (har) utility to move data from the CA Harvest SCM database tables to another location.

The following rules apply to the restore function:

• A CA Harvest SCM broker and server must be running on the CA Harvest SCM installation on which you want to run the restore.
• Only CA Harvest SCM administrators can run the restore utility.
• An archived project can only be restored to its original database.
• An archived project can only be restored to the same version of CA Harvest SCM that was used to archive it.

  Important! Projects archived prior to Version 12.0 need to be restored to the prior release before you upgrade to Version 12.0. However, this limitation will be removed after Version 12.0. Projects archived from Version 12.0 do not have to be restored prior to future upgrades/releases.

• In one restore execution, you can restore single or multiple projects from one archive file. You cannot restore multiple projects from different archives in one execution.
• The restoration will fail if the archive files (.arv, .dat) have been modified.
• The archive files (.arv, .dat) must reside together.
• You must specify the full path to the archived files.

After a successful restoration, the project status is automatically set to Inactive.

This command has the following format:

hrt {-b name} {-f} [-m computername -rport portnumber] [-musr username -mpw password] {-usr username -pw password} [-prompt] [-i inputfile.txt | -di inputfile.txt] [-eh filename] [-er filename] [-o filename | -oa filename] [-arg] [-v] [-wts] [-h] project_name

-b name

(Required) Specifies the CA Harvest SCM broker name.

-f

(Required) Specifies the archive file.

-m computername

(Optional) Specifies the name of the destination computer for the archive, if you are archiving to or restoring from a remote computer.

-rport portnumber

(Optional) Specifies the port number of the destination computer for the archive, if you are archiving to or restoring from a remote computer.

-musr username

(Optional) Specifies the username of the destination computer for the archive, if you are archiving to or restoring from a remote computer.

-mpw username

(Optional) Specifies the password of the destination computer for the archive, if you are archiving to or restoring from a remote computer.

-usr username

(Required, unless -prompt is specified) Specifies the user name for login to the broker. If -usr is defined without -pw, the user is prompted for the password at runtime.

-pw password

(Required, unless -prompt is specified) Specifies the password for login to the broker. To hide the password from being exposed in plain text on the command line, use the ‑prompt option.

-eh filename

(Optional) Specifies the encrypted CA Harvest SCM username-password file name. The file name used with this option contains encrypted username-password credentials and must be generated with the svrenc utility.

Note: -eh overrides -usr and -pw options. -prompt overrides -eh, -usr and -pw options.

-er filename

(Optional) Specifies the encrypted remote username-password file name. The file name used with this option contains encrypted username-password credentials and must be generated with the svrenc utility. ‑er overrides -musr and -mpw options.

More information:

har Command-Archive