Product Uninstaller Launcher JVM Resolution Properties

InstallShield 11 Universal

The Launchers view Explorer/Advanced tab provides you with access to the JVM Resolution properties for the Product Uninstaller Launcher.

There is no Advanced tab in Dynamic Suite Installers—the Launchers view contains only the Product Uninstaller JVM Resolution.
This function only applies to Universal Installer and Dynamic Suite Installer project types. That is because Universal Static Suite Installers use the Product Uninstaller Launchers in each referenced product (if they were configured).

The Product Uninstaller Launcher automatically uses the JVM matched at run time based on the settings specified in the JVM Resolution view. The default settings for the Product Uninstaller JVM Resolution are all that is required to accomplish this. Other launchers defined in the Launchers view can also use that same JVM. This enables you to search for a JVM when the installer executes, and then use the same JVM for the installer, the Java product(s) being installed, and the Product Uninstaller Launcher.

To use a different JVM for the Product Uninstaller Launcher and application Launcher(s), set the Standard, Advanced, and Platform properties as described below. Platform-specific property values need to be entered for each targeted platform on which the JVM needs to be resolved, even if the property settings are identical for those platforms. The reason for this is to enable different search processes on each targeted platform.

Standard Properties

Property	Description
Display Name	This property represents the name for this JVM resolution as it displays in the interface. It is for administrative use only.
JVM ID	This is a required field that specifies the ID for the JVM to be used, and is case sensitive. Leave this property set to the default value of "jvm." If it is changed here, then it must also be changed in the JVM ID property of any application Launcher you have included in your project in the Launchers view.
Install Location	If you are bundling a JVM, then specify in this property the directory to which the bundled JVM should be installed on the target machine. The default is "_jvm." This can be changed to an absolute path, or a path that is relative to the Install Location of the root product. If you are not bundling a JVM, then leave this property set to the default value.
Use Installed JVM	If set to "True," then the JVM installed to the Install Location specified in the previous property will be searched for. Leave this property set to "False" (the default) if you do not bundle a JVM.
Active	Change this property to "True" for the Product Uninstaller Launcher to search for a JVM instead of using the same JVM as the installer.
Resolve on Reinstalls	Select whether JVM Resolution for the uninstaller should be performed when the product or Dynamic Suite is reinstalled. If "True" (the default), then JVM Resolution for the Product Uninstaller Launcher will be done when the product/suite is installed again (after it has previously been installed). If changed to "False," then JVM Resolution for the uninstaller will only be done the first time the product/suite is installed—the Product Uninstaller JVM Resolution will be skipped the next and subsequent times the same product/suite is installed. Therefore, if you included a bundled JVM with the initial installation, then this property should be set to "False"; otherwise, it should be set to "True."

Advanced Properties

Property	Description
Build Categories	This optional property represents the categories within which you can assign to this function. You can create as many Build Categories as you desire and assign them to the functions and/or software objects you want to be able to exclude from a build. Then, in the Build Configuration/ Advanced/Build Configuration Exclusion property, you would select the build category(ies) to exclude from that build. For platform-type Build Categories, select the platform(s) with which you want this function to be associated. Then, in the Releases view, Platform Support, select the platforms to be included in the Build Configuration's build. The product will only include support for the platform(s) that are selected to be included in that build.
Comments (Premier Only)	This optional property enables you to specify comments about this action. These comments are stored in the project file and are for your use only. They are ignored at run time.

Property

Description

Build Categories

This optional property represents the categories within which you can assign to this function. You can create as many Build Categories as you desire and assign them to the functions and/or software objects you want to be able to exclude from a build. Then, in the Build Configuration/ Advanced/Build Configuration Exclusion property, you would select the build category(ies) to exclude from that build.

For platform-type Build Categories, select the platform(s) with which you want this function to be associated. Then, in the Releases view, Platform Support, select the platforms to be included in the Build Configuration's build. The product will only include support for the platform(s) that are selected to be included in that build.

Comments
(Premier Only)

This optional property enables you to specify comments about this action. These comments are stored in the project file and are for your use only. They are ignored at run time.

Platform Properties

The properties for each targeted platform are the same. To activate a platform, select the platform and click its Enable check box. Its Delete icon changes to a checked check box, and its properties can then be set. To remove a platform and its properties, clear its check box, and the Delete icon returns.

Property	Description
JVM Search Instructions	Specify the JVMs that should be searched for at run time. If none are located and no bundled JVM is included in this project, an error is logged and the uninstaller exits. For instructions to set up a JVM search, see Setting Up a JVM Search.
JVM Resolution	This property determines the execution order of the search. There are two options, and they determine the sequence of the resolution, as follows: "Current, Search, Install"—Select this value if you bundled a JVM with this installation, the Use Installed JVM property is set to "True," and Install Location is non-blank. "Search, Current, Install"—Select this value if you did not bundle a JVM with this installation.
Bundled JVM Arguments	This optional property enables you to pass arguments to the JVM when it is launched. Examples of arguments (specific to the JVM) include setting the max/min heap size or turning on a trace flag.
Bundled JVM	This property identifies the prepackaged, self-extracting JVM to install. Click the ellipsis ("...") and a browse dialog box opens in the jvms directory. Select the appropriate platform directory, then select the bundled JVM file (will have an exe or bin extension). A path variable can be used for this property. You can obtain additional bundled JVMs from our Web site by selecting Tools \| Download Bundled JVM.
Timeout	This property represents the maximum time, in seconds, that this process has to resolve a JVM before it stops searching. If it times out, then the JVM resolution process fails. Set this property to "0" (zero) for the search to never time out.
Use Current JVM	Set this property to "False" so that the Product Uninstaller Launcher searches for a JVM using the properties set in this view. If left set at the default value of "True," then the Product Uninstaller Launcher will use the JVM used by the installer.