Variables View

InstallAnywhere 2018 » Advanced Designer » Project

Use the Variables view on the Project page to advertise variables for merge modules, configure build time variables, list variables to encrypt in or exclude from the response files, set security options, and view a list of all defined variables.

The settings in the Variables view are organized into the following areas:

Advertise Variables
Build Time Variables
Configure Variables
Security
Variables

Advertise Variables

In the Advertise Variables area, you advertise variables for merge modules.

Advertise Variables Controls

Control

Description

Advertise Variables

Click to open the Advertise Variables dialog box where you can add variables, set default values, and add comments. Advertised variables are used by dynamic merge modules and the Install Merge Module action.

On this dialog box, you can specify which variables in the merge module can be set by the parent installer and which variables in the parent installer can be set by the merge module.

Note • For more information, see Advertise Variables Dialog Box.

Build Time Variables

In the Build Time Variables area, you can configure your installer to use build time variables, which are variables that have their values set at build time.

Build Time Variables Controls

Control

Description

Build Time Variables

Click to open the Build Time Variables dialog box, which lists defined build time variables. Click the Edit Variables button on the Build Time Variables dialog box to edit the list of variables. For information on configuring build time variables, see Build Time Variables Dialog Box and Edit Build Time Variables Dialog Box.

Note • When defining a build time variable, instead of using the $ symbol as the variable delimiter (which is used for standard variables, such as $var$), you instead use the @ symbol as the delimiter for build time variables, such as @var@ or @Apple@.

Note • In addition to defining build time variables using the Advanced Designer interface, you can also configure build time variables using a property file or as environmental variables. For more information, see Resolving Variables at Build Time.

Configure Variables

Use the following controls to list the variables you would like to encrypt in or exclude from the response files, install log, and other options.

Configure Variables Controls

Control

Description

Configure

Click to open the Configure Variables dialog box, where you can add or remove configuration settings for InstallAnywhere variables. These settings allow you to suppress the appearance of variables, in the response file and the install log, or encrypt variables in all output. Possible configuration settings include:

Exclude Variable Entirely
Exclude Value Only
Encrypt Variable Value

Note • For more information on excluding variables, see Generating Response Files.

Note • For more information on encrypting variable values, see Encrypting Variable Values.

Security

Use the following controls to customize security settings for encryption.

Security Controls

Control

Description

Use JCE Encryption

Activates or deactivates Java Cryptography Extension (JCE) encryption. InstallAnywhere includes basic encryption to obfuscate encrypted elements. Checking Use JCE Encryption substitutes the JVM’s JCE encryption for InstallAnywhere’s basic encryption. If JCE encryption is not available (as in pre-1.4 JVMs), InstallAnywhere defaults to its own encryption method.

Encryption Algorithm

Type the algorithm name you want to use with JCE encryption.

Note • Using JCE encryption, along with a FIPS-compliant JCE library and supported algorithm, you can ensure your installers are FIPS 140-2 compliant. See Making a JRE VM Pack FIPS-Compliant for more information.

Caution • Encryption is not fully supported for merge modules. Sensitive information that requires encryption should not be included in a merge module.

Variables

The Variables area of the Variables view provides a scrollable list of all variables defined in the installation project.

Substitute Recursively Option

Each listed variable includes a Substitute Recursively option, enabling you to specify that you do not want the variable to be substituted at runtime. In cases where you expect that the variable could contain multiple $ characters—such as in a user-defined password—you would clear the selection of the Substitute Recursively option for a variable.

For example, suppose the installer includes a variable named $PASSWORD$ and the end user enters a value of apple$newton$found for that variable at runtime:

Substitute Recursively not selected—The value of $PASSWORD$ is set to apple$newton$found.
Substitute Recursively selected—The $newton$ portion of the apple$newton$found value is read as an unknown variable, which is replaced with a blank value, resulting in setting the value of $PASSWORD$ to applefound, which is incorrect.