InstallFileList

Install list of files

Definition

Use this command to install a list of source files in the same target path. As parameter, the source files and the common target path are entered.

In case an error occurs when running this command, you can specify the option Stop script on error in the Script Editor. If the error actually occurs, the script stops, thus preventing subsequent errors, and the associated policy is shown as not compliant.
This also applies if you set the package property Error handling to Always terminate script on error (a default setting for new packages).

Settings

Source files

The source files to be installed are specified in the form of a list. Wildcards (? *) and variables can be used.

This command's dialog box contains the following buttons to specify the source files:

New
Allows you to add a new source file specification.

Edit
Allows you to change the selected source file specification.

Delete
Allows you to delete the selected source file specification.

Select
Displays a standard Windows dialog box for opening or finding files. You can select one or more files as source files.

Target path

The specified source files are installed in the common target path. An installation in subdirectories is not possible.

Disable file direction on x64 computers
For reasons of compatibilty, Ivanti DSM maps file and registry access to the default storage location for 32 bit applications (provided that the storage location differs from that of 64-bit applications). File access: whenever a 32-bit application attempts to access %windir%\System32, the access is redirected to %windir%\SysWOW64. Registry commands: when accessing HKEY_LOCAL_MACHINE\SOFTWARE the calls are redirected to HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node. The x64-switch stops this redirection of file and registry accesses when running the script command on a x64 computer; the eScript command runs on the specified path. CallScript command: the script runs in a 64-bit process.

Replacement options

The command dialog box contains four options for replacing files:

Always replace
Files with identical names in the target directory will always be replaced.

Replace only older versions
This option allows you to compare file versions (of existing files).
First, the Installer compares the internal versions of the files (if maintained). If the internal versions have not been maintained, the Installer compares the date and time of files having identical names.
If an older file version exists it will be replaced with the newer version.

Never replace
Files with identical names in the target directory will not be replaced.

Confirm replace
Files with identical names in the target directory will replaced only if the user confirms.

If you select the options Always replace or Replace older versions only, you additionally switch to the unattended mode. In this mode, the DSM automatically checks whether the files to be installed are currently in use (and therefore cannot be installed while Windows is running). The respective files are listed; Windows is automatically restarted and the files are installed. Use the ClearRestartFlags command to avoid the automatic restart.

File lock

Break file lock, if file is locked by the server service is used in order to update files locked by the Server Service during Windows runtime without causing a reboot. This option is valid for the selected object and can be specified in the configuration table in the General Package Properties > Server Service File Lock Settings.

By using this option, the managed computer's system may crash when server applications are active!

If you select Abort execution if file is locked, the script execution is stopped if the file you want to update is locked. If you do not select this option, DSM attempts to update the file after restarting the computer (see above).

If you chose this option the script is stopped only if there is a locked file. To ensure that the script stops for all other kinds of errors, select Stop script on error (see above).

Backup

Create backup files
Creates backup files of all files updated by a copying process.