Download
|
Install Action that executes a file download specified by the following settings:
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Download Actions Settings
Source- contains the web server directory path and file name of the file to be downloaded to the device if required by versioning.
Target- {DEVICEFILENAME} data type. Text value that specifies the web server directory path and file name of the file to be downloaded to the device if versioning indicates it is required. This string can contain any device subdirectories prefixing the file name.
Note: AppUpdate Runtime Substitution Token values can be used within the value to define target subdirectories for target files. See Appendix C Runtime Substitution Tokensfor more information.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
Install
|
Specifies an Install Action that installs an installable file such as a CAB.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are run if this step fails.
Install Action Settings
The name of the installable file is specified by the following parameters:
Command- {command value} data type. Optional text value that specifies an installation command.
File- {LOCALFILENAME} data type. Text value which specifies a file name of an installable file residing on the device. Installable files include CAB files, ActiveX DLL files, REG import files, CPF files in OMA format and other XML formats which follow install file guidelines.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
Uninstall
|
Specifies an Install Action that uninstalls an installed CAB file.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Uninstall Action Settings
The application to uninstall is specified by the following:
Name- {APPLICATIONNAME} data type. Text that specifies the name of an application installed on a device. The application name can be located by navigating on the device to Start > Settings > System > Remove Programs. Any applications appearing in the list can be specified for Uninstall.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
Process >WarmBoot
|
Specifies an Install Action that soft/warm resets the device when all actions for the specified package are completed (not at the time the WarmBoot Action is encountered or after the last action of all packages). The WarmBoot Install Action does not require parameters.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
Note: To customize the warm boot logic, place a custom executable, which must be named warmboot.exe, in the same directory as the AppUpdate executable. When the file warmboot.exe is found, it is executed instead of the default warm boot Install Action.
|
Process > Run
|
Specifies an Install Action that executes a program locally on the device.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Run Action Settings
This command execution is specified by the following:
Command- {COMMANDLINE} data type. Text value that specifies a directory path and file name on the device of the file to be run and any command line arguments to modify the run. Embedded blanks are allowed and double quotes are not required in the program path to enclose directories with embedded blanks. Command line arguments with embedded blanks should be tested as shortcuts prior to using here.
Note: AppUpdate Runtime Substitution Tokenvalues can be used within a value to define subdirectories for executable files and command line arguments as needed. See Appendix C Runtime Substitution Tokensfor more information.
Timeout- {Timeout value} data type. Integer value that specifies how long the device should wait when executing the Run Action before continuing processing.
The following are the allowable values:
{value less than zero, ex. -1}- (default) specifies that device processing will wait indefinitely for the action to finish before continuing with subsequent steps.
{"0"}- Device processing will not wait for the action to finish before continuing with subsequent steps.
{value greater than zero, ex. 10}- device processing will wait (value specified in milliseconds) for the action to finish before continuing with subsequent steps.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
Process>Terminate
|
Specifies an Install Action that terminates a module process running on the device.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Note: The Terminate Install Action will issue an error return code if the process to be terminated was not running at the time the call was made. Changing the default Critical continue only on success Action Setting to Critical continue will allow subsequent Install Action processing to continue if the Install Action cannot install a specified file or stop a process that is not running.
Terminate Action Settings
The name of the process(es) are specified by the following:
Modules- {MODULENAME} data type. Text value that specifies an executable name (cmd.exe) or wildcard inclusion of multiple executable names running on the device (ex c*.* or * for all processes).
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
File System > Copy Files
|
Specifies an Install Action that copies one or more files from one area (directory or folder) of the device to another.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Copy Files Action Settings
The name of the source folder and file name and the target folder are specified by the following:
Source- {LOCALSOURCEFILESPEC} data type. Path and file name(s) existing on the device to copy from during provisioning. Using wild card characters is allowed.
Target- {LOCALTARGETFOLDERNAME} data type. Path existing on the device to receive files during provisioning.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
File System > Move Files
|
Specifies an Install Action that moves one or more files from one area (directory or folder) of the device to another.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Move Files Action Settings
The name of the source folder and file name and the target folder are specified by the following:
Source- {LOCALSOURCEFILESPEC} data type. Path and file name(s) existing on the device to move from during provisioning. Using wild card characters is allowed. Files are removed from this location upon successful move to target.
Target- {LOCALTARGETFOLDERNAME} data type. Path existing on the device to receive the moved files during provisioning.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
File System > Delete Files
|
Specifies an Install Action that deletes a local file on the device.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Delete Files Action Settings
The name of the file to be deleted is specified by the following:
Path- {LOCALFILENAME} data type. File name(s) on the device to delete during provisioning. Using wild card characters is allowed.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
File System > Rename File
|
Specifies an Install Action that renames a file in a specified folder on the device.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Rename File Action Settings
The name of the source file (existing file name) and the target file name (new file name) are specified by the following:
Source- {EXISTINGFILENAME} data type.Path and file name existing on the device to be renamed during provisioning.
Target- {NEWFILENAME} data type. New file name not yet existing in the path specified in source. Note: Do not prefix with the path/folder specification. Use the raw file name.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
File System > Create Folder
|
Specifies an Install Action that creates a local folder (directory) on the device.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Create Folder Action Settings
The name of the folder (directory) to be created is specified by the following:
Path- {LOCALFOLDERNAME} data type. Folder name on the device to be created during provisioning.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
File System > Remove Folder
|
Specifies an Install Action that deletes a local folder (directory) on the device.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Remove Folder Action Settings
The name of the folder (directory) to be deleted is specified by the following:
Path- {LOCALFOLDERNAME} data type. Folder name on the device to delete during provisioning. All files in this folder are also deleted.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|
File System > Rename Folder
|
Specifies an Install Action that renames a folder on the device.
Actions Settings
Critical- continue only on success- (default) specifies that subsequent action steps in the package are only run if this step completes successfully. continue- specifies that subsequent action steps in the package are run regardless of the success or failure of this step. continue only on error- specifies that subsequent action steps in this package are only run if this step fails.
Rename Folder Action Settings
The name of the source folder name (existing folder/directory on the device) and the target folder name (new folder/directory on the device) are specified by the following:
Source- {EXISTINGFOLDERNAME} data type. Path existing on the device to be renamed during provisioning.
Target- {NEWFOLDERNAME} data type. New folder name not yet existing on device.
Targeted Device Type
Used to provision specific devices by processor, major version, and platform:
CPU- contains the processor type of the device.
OS Major- {osmajor value} data type. Integer that specifies the major version number of the device operating system.
OS Platform- contains the mobile operating system of the device.
|