Creating Partial Clone for an MSI or a Cab File

You can create partial MSIs or cab files to generate new or updated report files for a cloned system, such as Reports cab files. The command line syntax of creating a partial clone is:

ManagePackage /P /BP <SourcePackageLocation> /DP <DPMGeneratedPackageLocation>
[/TP <TargetPackagePath>] [/PN <PackageName>] [/RN<ReportName>]
[/O <true|false]>] [/ ]

Parameters

Argument	Description
/P	Specifies whether you want to create partial MSI of a cloned MSI. *Notes:* This argument is mandatory. If you do not pass this argument, the error message "Mandatory Input missing or Invalid: /C /P /U", including the complete usage of the utility appears.
/BP <SourcePackageLocation>	Specifies the path to a builder generated package (.msi or .cab). You can specify the absolute path, relative file path, or network path (Uniform Naming Convention). *Note:* This argument is mandatory and allows the Windows installer to determine the original partial MSI file. If you do not pass any value with this argument, an error message specifying that the input is invalid, including the argument and the usage of the utility appears, for reference. For example: When you create a partial clone without specifying the path to the builder generated package, an error message appears. For instance, ManagerPackage /P /BP /DP C:\ClonedPackages\ SampleClone.msi If you pass empty quotes, "", or an incorrect path, the error message "Invalid builder generated package provided." appears. For instance, ManagePackage.exe /P /BP ""
/DP <DPMGeneratedPackageLocation>	Specifies the path to the DPM generated instance package. You can specify the absolute path, relative file path, or network path (Uniform Naming Convention). *Note:* This argument is mandatory and enables the Windows installer to determine the location of the DPM generated partial MSI file. If you do not pass any value with this argument, the error message "Mandatory Input Missing or Invalid: /P /BP /DP", including the usage of the utility appears, for reference. For example: To create a partial clone, type DPM /P /BP C:\GeneratedFiles\ BuilderGeneratedPackage.msi /DP C:\GeneratedFiles\DPMGeneratedPackage.msi If you pass empty quotes, "", or an incorrect path, the error message "Invalid instance generated package provided." appears. For instance, DPM.exe /P /BP "C:\TEMP\StagingArea \NGENSampDepClone.msi" /DP ""
/TP <TargetPackagePath>	Specifies the absolute path to the output package where the updated MSI package is copied. *Note:* The default path is My Documents
/PN <PackageName>	Specifies the name of the new .msi package file. *Note:* This argument allows you to set the output file name. The default value is the builder generated value appended with "ClonePartial" for Msi and <systemname><reportname> for .cab files For example: If the existing system name is "Sample", the name of the newly created MSI package and .cab files respectively are, "SampleClonePartial", by default. <systemname><reportname>, by default.
/RN <ReportName>	New name for a report in a single-report package (.cab). *Note:* This is mandatory if the target system is the same system which means creating a copy of an existing report with a new name within the same system.
/CFD <ConfigurationData>	Specifies the path to the location configuration data file. Configuration data file is an input file for reconfiguring design time objects such as LOG Pack Location, ROC Pack Location, REORG Pack Location, EXTRACT Pack Location, and System Pack Location. *Note:* The input file can be a text file which have multiple lines. Each line is separated by the object name and the desired location. For example: SegmentA.ReportA.AttributeA C:\ExtFileLocA SegmentA.Location3 C:\TempLocation
/O <true\|false>	You can set this argument to true to overwrite the OutPath package. The default value is false. *Notes:* If you do not specify any value for this argument or if the option is false and the target path is available, the warning message "Target Path is already available" appears. If a package with the same name exists in the target path, an error message specifying that the package already exists in the path appears.
/P /?	Displays the command line syntax and options of the utility for updating an instance. If specified, a usage message appears, and the utility exits without starting the update process.

Examples

The following command creates partial clone for an MSI.

ManagePackage /P /BP C:\TEMP\stagingarea\SampleReports.msi /DP 
C:\ClonedPackages\SAMPLEClone.msi /TP C:\ClonedPackages /PN SAMPLECloneReports /O TRUE

The following command creates partial clone for a CAB file.

ManagePackage /P /BP C:\TEMP\stagingarea\SAMPLE_Reports_AGEDSTOCK.cab /DP 
"C:\ClonedPackages\SAMPLEClone.msi" /TP C:\ClonedPackages /PN AGEDSTOCK /O True

Troubleshooting—Error Messages

If you provide an incorrect option for an argument, an error message specifying that the argument is invalid appears, along with the argument and the usage of the utility, for reference.
If you pass an incorrect command, the error message "Invalid input specified" appears.
If you pass an incorrect argument, an error message specifying that the input is invalid appears, along with the argument and the usage of the utility, for reference.
If you do not pass the mandatory arguments, an error message specifying that the mandatory input is missing or invalid appears, along with the mandatory arguments and the usage of the utility, for reference.
If you pass any incorrect values for the mandatory arguments, an error message specifying that the details are incorrect appears, along with the argument and the usage of the utility, for reference.
If you pass an empty value for a mandatory argument, an error message specifying that the input is invalid appears, along with the argument and the usage of the utility, for reference.
If you pass valid arguments to run the utility, the message "Create Package completed successfully" appears.