Parameter Element

This element allows the specification of parameters to be passed to the executable patch when it is called.

There should be no more than one parameter instance for the repair and non-repair calls. These elements are both optional. Below in this section is a list of placeholders that can be used to have patch-specific information inserted into the parameter string on execution of the patch.

The following attributes are supported:

XML Attribute

Required

Description

repair

false

If true, the setting only applies if the file is started in repair mode.

If false, the setting only applies if the file is started in non-repair mode.

If the attribute doesn't exit, the setting applies to both modes (repair and non-repair)

The following placeholders are supported:

Placeholder

Description

{FileName}

Full path and file name for the patch to be executed.

{LogFile}

Full path and file name for the log file of the patch.

{LogPath}

Full path to CRM.launcher's general log directory for patches.

{InstallationPath} V8.2 Feature Pack +

Full path to CRM.launcher's installation directory.
Note: All values for the placeholders are wrapped in double quotes by default.

Examples

In the following sample configuration, all files with the .bat patch are executed with '> { LogFile }' as argument.

In this case, the { LogFile } is replaced with the log file name and path.

For example, if the patch file name is testFile.bat, the argument is: > c:\offline\web.data\logs\PathLogs\testFile.201307191004.log.

...   
<Setting fileNameFilter="\.bat$">
    ...
    <Parameter><![CDATA[ > {LogFile}]]></Parameter>
    ...
</Setting>
...

In the following sample configuration, the repair attribute is set to false and has a placeholder {FileName}.

In this case, the first *. msi patch run is executed with '/ i { FileName } /QN / norestart REBOOT= ReallySuppress' as argument and { FileName } is replaced with the patch file name and path.

For example, if the patch file name is testFile.msi, the argument is: /i "c:\Users\UserA\AppData\Local\update.launcher\Download\testFile.msi" /QN /norestart REBOOT=ReallySuppress 
 ...   
<Setting fileNameFilter="\.msi$">
    ...
    <Parameter repair="false">/i {FileName} /QN /norestart REBOOT=ReallySuppress</Parameter>
    ...
</Setting>
...

In the following sample configuration, the repair attribute is set to false and has a placeholder { LogFolder }.

In this case, only if the previous run failed, the *test.msi patch is executed with --Log ={ LogPath } as argument and { LogPath } is replaced with the path to the global log directory.

For example, if the patch file name is test.msi, the argument is: --Log="c:\offline\web.data\logs\PathLogs".

...   
<Setting fileNameFilter="test\.msi$">
    ...
    <Parameter repair="true">--Log={LogPath}</Parameter>
    ...
</Setting>
...