Using the Command Line Utilities › har Command-Archive

har Command-Archive

The CA Harvest SCM archive utility lets administrators move data from the CA Harvest SCM database tables to another location for archive purposes.

The following rules apply to the archive function:

• A CA Harvest SCM broker and server must be running on the CA Harvest SCM installation on which you want to run the archive.
• The archive function stores files at the project level. You can specify one or more projects to archive in one execution.
• Only inactive projects can be archived.
• Only CA Harvest SCM administrators can run the archive utility.
• Life cycle templates cannot be archived.
• If you archive to the same destination and file name as an existing archived project, the existing archive is overwritten; the new archive will not be appended to the existing one.

After a successful archive execution, two files are created in the archive destination location:

• The .arv file is a text file that stores the logical records: harVersions, harBranch, harItemRelationship, harVersionInView, harVersionData.
• The .dat file is a binary file that stores the physical data.

Important! Do not delete or modify the .arv or .dat files if you plan to restore the project. Deletion or modification of these files will result in restoration failure.

After archiving a project, the project status is automatically set to Archive.

Note: Administrators can use the restore (hrt) utility to move data back to the original database.

This command has the following format:

har {-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) Defines the archive file.

-m computername

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

-rport portnumber

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

-musr

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

-mpw

(Optional) Specifies the password of the destination computer for the archive, if you are archiving to 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.

project_name

Specifies the name of the project to archive.

More information:

hrt Command-Restore