To execute DPM from the command prompt, perform the following
Open Command Prompt.
Enter the path where DPM-Console.exe is located and execute it. The syntax to execute the DPM is:
<DPM-Console.exe location path> <arguments>
Where the arguments are:
Argument | Description |
---|---|
-N | Creates a new instance package for builder generated package. |
-U | Updates an existing instance package. |
-P | Creates a new partial instance for DPM generated package. |
-UP | Updates a partial instance package. |
-V | Validates environment for cloning. The exit code is a non-zero value in case of an error. |
-B | Complete path to the builder generated package (.msi or .cab). |
-I | Complete path to the DPM generated instance package (Valid with U, -P, and UP options). |
-O (optional) | Overwrites OutputPath Package. |
-OutputPath (optional) | Output package path. Default value is My Documents. |
-SchemaName (optional) | Database schema name. Valid with -N and -U options. |
-DatabaseName (optional) | Database name. Valid with -N and -U options. |
-ReportName (Optional) | New name for a report in a single-report package (.cab). Valid with -P option. This is mandatory if the target system is the same system; that is, you can create a copy of an existing report with a new name within the same system. |
-ServerReg (optional) | Database Server Registration name. Valid with -N and -U options. |
-InstanceName (optional) | Instance Name (New Package Name). Valid with -N options. |
-SystemName [Optional] | System name. Valid with -N option. |
-ConfigurationData [Optional] | 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. Notes:
For example: SegmentA.ReportA.AttributeA C:\ExtFileLocA SegmentA.Location3 C:\TempLocation |
-PackageName (optional) | Output package name. |
-PkgInstDir (optional) | Package Installation Directory. Valid with -N and -U options. |
-Wait (optional) | Waits after cloning. |
-WaitOnError (optional) | Waits only if errors occur. |
-help | Displays usage. |
Examples
To validate the environment for cloning.
DPM-Console.exe -V
To clone an instance, you need to provide the following arguments: the package path of the builder generated MSI, a unique database schema name, the output path where the cloned MSI is available, the database name, the database server registration name, a unique package and instance name, and a unique package installation directory.
DPM-Console.exe -N -B="C:\ABSuite\BuilderSAMPLEDeploy.msi" -SchemaName=CLONEDSAMPLESCHEMA -OutputPath=C:\ClonedPackages -DatabaseName=CLONESAMPLEDDB -ServerReg=SQLSERVER -InstanceName=SAMPLECLONE -PackageName=SAMPLECLONE -PkgInstDir="C:\ABSuite\Systems\SampleClone" -O
To update an instance, you need to provide the following arguments: the package path of the builder generated MSI, the package path of the cloned MSI, the database schema name for the cloned MSI, the output path where the cloned MSI is available, the output package file name, the database name, and the database server registration name.
DPM-Console.exe -U -B="C:\ABSuite\BuilderSAMPLEDeploy.msi" -I="C:\ClonedPackages\SAMPLECLONE.msi" -SchemaName=CLONEDSCHEMA -OutputPath=C:\ClonedPackages -PackageName=CLONESAMPLE -DatabaseName=CLONESAMPLEDDB -ServerReg=SQLSERVER -O
To create a partial clone for an MSI, you need to provide the following arguments: the package path of the builder generated MSI, the package path of the cloned MSI, the output path where the cloned MSI is available, and a unique package name.
DPM-Console.exe -P -B="C:\ABSuite\BuilderSAMPLEReports.msi" -I="C:\ClonedPackages\SAMPLECLONE.msi" -OutputPath=C:\ClonedPackages -PackageName=SAMPLECloneReports -O
To create a partial clone for a CAB file, you need to provide the following arguments: the package path of the builder generated CAB file, the package path of the cloned MSI, the output path where the cloned MSI is available, and a unique package instance name.
DPM-Console.exe -P -B="C:\ABSuite\SAMPLE_BuilderSAMPLEReports_AGEDSTOCK.cab" -I="C:\ClonedPackages\SAMPLECLONE.msi" -OutputPath=C:\ClonedPackages -ReportName=NEWAGEDSTOCK -PackageName=AGEDSTOCK -O
To create an updated partial clone for an MSI, you need to provide the following arguments: the package path of the builder generated MSI, the package path of the partial cloned MSI, the output path where the cloned MSI is available, and a unique package name.
DPM-Console.exe -UP -B="C:\ABSuite\BuilderSAMPLEReports.msi" -I="C:\ClonedPackages\SAMPLEPARTIALCLONE.msi" -OutputPath=C:\ClonedPackages -PackageName=SAMPLECloneReports -O
To reconfigure the location set at design time, to clone an MSI package and reset the location, you need to provide the following arguments: the package path of the builder generated MSI, the path of the text file that contains the reconfiguration parameters, a unique database schema name, the system name, the output path where the cloned MSI will be available, the database name, the database server registration name, a unique package and instance name, and a unique package installation directory.
DPM-Console.exe -N -B="C:\intermediate\SampleDeploy.msi" -ConfigurationData=C:\TFSDEVOPS\Reconfiguration\ReConfigSample.txt -SchemaName=SampleClone -SystemName=SampleSystemNewClone -OutputPath=C:\TFSDEVOPS\ClonedPackages -DatabaseName=SampleDatabase -ServerReg=first -PackageName=Sample1PkgClone -PkgInstDir="c:\TFSDEVOPS\installCloneSample" -O
Note: The ReConfigSample.txt file contain the modified path of the LOG Pack Location, ROC Pack Location, REORG Pack Location, EXTRACT Pack Location, System Pack Location.For example, the contents of ReConfigSample.txt will be as follows:Sample.Extract "c:\extract\clone\" Sample.Location1 "c:\clone\loc2\" AuditLogLocation "c:\auditlog" RocOutputLocation "C:\roc" Sample.Filegroups ABC