Updating an Instance

You can upgrade a cloned MSI by updating a few parameters. The command line syntax for updating an Instance is:

ManagePackage /U /BP <SourcePackageLocation> /DP <DPMGeneratedPackage> [/TP <TargetPackagePath>] [/DB <DBName>]
[/DBS <DBSchema>] [/DBR <DBServerRegistration>] [/PN <PackageName>]
[/PD <PackageDir>] [/O <true|false]>] [/ ]

Parameters

Argument

Description

/U

Specifies whether you want to update the package parameters 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 <SourcePackage Location>

Specifies the path to 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 existing MSI file. If you do not pass any value with this argument, an error message appears specifying that the input is invalid, including the argument and the usage of the utility, appears for reference.

For example:

  • When you update an instance without specifying the path to the builder generated package, the error message "Mandatory Input Missing or Invalid: /U /BP /DP", including the usage of the utility appears, for reference. For instance,

    ManagePackage /U /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 /U /BP "" /DP C:\GeneratedFiles\
DPMGeneratedPackage.msi

/DP <DPMGenerated Package>

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 cloned MSI. If you do not pass any value with this argument, the error message Mandatory Input Missing or Invalid: /U /BP /DP", including the usage of the utility appears, for reference.

For example:

  • To update a cloned MSI package, type

    ManagePackage /U /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,

    ManagePackage.exe /U /BP "C:\TEMP\StagingArea
\NGENSampDepClone.msi" /DP ""

/TP<TragetPackagePath>

Specifies the absolute path to the output package where the updated MSI package is copied.

Note: The default path is “My Documents”.

/DB<DBName>

Specifies the updated database name.

For example: to update the DBName for the DPM generated package, type

ManagePackage /U /BP C:\TEMP\stagingarea\Sample.msi /DP 
C:\ClonedPackages\SampleClone.msi /TP C:\ClonedPackages 
/DB CLONESAMPLEDDB

/DBS<DBSchema>

Specifies the updated Database schema name.

/DBR<DBServerRegistration>

Specifies the updated Database server registration name.

/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 "Clone".

For example: If the existing instance name is "Sample", the name of the newly created MSI package is "SampleClone".

/PD<PackageDir>

Specifies the updated Package installation directory, which is the absolute path to the builder generated instance package.

/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 target path package. The default value is false.

Notes:

  • If you do not specify any value for this argument or if the option is false and 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.

/U /?

Displays the command syntax and options of the utility for updating an instance. If specified, a usage message appears, and utility exits without starting the update process.

Example

The following command updates an existing instance.

ManagePackage /U /BP C:\TEMP\stagingarea\Sample.msi /DP C:\ClonedPackages\SampleClone.msi /TP C:\ClonedPackages /DB CLONESAMPLEDDB /DBR SQLSERVER /DBS CLONEDSAMPLESCHEMA /PD C:\ABSuite\Systems\SampleClone /O True