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.