How to rename a package or add and remove packages from package groups using the command line?

Document ID : KB000021739
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction: 

Advice about the usage of the hup command line tool.

Question: 

How to rename a package or add and remove packages from package groups using the command line?

Environment:  

CA Harvest SCM all versions, all platforms

Answer: 

Use the hup (Update Package) command to rename packages and add or remove packages from existing package groups.

The hup command has the following format:

hup {-b name -en name -p name} {-usr username -pw password} [-npn name] [-at name] [-pr number] [-af name] [-apg names...] [-rpg names...] [-des text] [-nt note] [-rf name] [-ft formtype] [-afo formid] [-rfo formid] [-del] [-cf] [-v] [-prompt] [-i inputfile.txt | -di inputfile.txt] [-eh filename] [-o filename | -oa filename] [-arg] [-wts] [-h]

To rename a package, at a minimum, you must supply the following parameters:

 -b [Broker Name] 
 -en [Project Name] - use quotes if the project name contains spaces    
 -p [Package Name] - the package to be renamed    
 -eh [filename] - encrypted credentials file    
 -or-    
 -usr [Broker login credentials]    
 -pw [Broker login password]    
 -npn [New Package Name]

To add the package to one or more existing package groups:

 -apg [comma separated list of package groups]

To remove the package from one or more existing package groups:

 -rpg [comma separated list of package groups]

For example, to rename "OldPackage" to "NewPackage" in the project "MyProject"

hup -b MyBroker -en MyProject -p OldPackage -usr harvest -pw harvest -npn NewPackage 

Additional Information:

A complete description of the update package command, hup, is documented in The CA Software Change Manager Reference Guide.

http://www.ca.com/us/support/ca-support-online/support-by-product/ca-harvest-software-change-manager.aspx