LAX Properties

InstallAnywhere 2013

LaunchAnywhere properties can be set in the LaunchAnywhere Properties and Uninstaller Properties dialog boxes, accessible in the Create LaunchAnywhere for Java Application customizer and the Create Uninstaller customizer, both in the Install sequence.

LAX Properties

Property

Definition

lax.application.name

The name of the application that the launcher executes.

lax.class.path

The classpath for the application. By default, set to $IA_CLASSPATH$ (the classpath specified in the InstallAnywhere Designer environment.)

When you specify the classpath, use either forward (/) or backward (\) slashes to separate directories within a path. Use either colons or semicolons to separate multiple paths—LaunchAnywhere substitutes the proper characters for the installation platform at install time.

Tip: Never use colons as directory separators in lax.class.path. InstallAnywhere treats colons as path separators. Instead, use slashes to separate directories in a path. LaunchAnywhere replaces the slashes, as necessary, with platform-specific directory separators at install time.

lax.command.line.args

A list of arguments passed to the application's main method. These are specified exactly the same way as they would be on the command line. For example, if the application is invoked as

java myApp arg1 arg2

set this property to

"arg1 arg2"

Be sure to place quotes around any arguments that have spaces.

When it is necessary to pass in an argument that is only known at install time (for instance, the installation directory), use an InstallAnywhere variable.

lax.dir

The path to directory holding LaunchAnywhere's native launcher.

If you are specifying a path in Windows, make sure to use escaped backslashes (such as C:\\Program Files\\OfficeSuite.exe).

lax.java.compiler

The JIT compiler that is being used for execution of this application.

Note: Runtime only. The lax.java.compiler property cannot be set via the LaunchAnywhere Properties or Uninstaller Properties dialog boxes.

lax.main.method

The name of the application's starting method that this LaunchAnywhere Executable invokes.

lax.main.class

The class that gets launched by this LaunchAnywhere Executable. This class must contain a method with a name defined by the lax.main.method property.

lax.nl.current.vm

The full path to the VM executable to be used. If the LaunchAnywhere Executable cannot find the VM specified, it searches the system for the VMs in lax.nl.valid.vm.list.

lax.nl.env.variable_name

lax.nl.env.exact_case.variable_name

Use to access any system environment variable.

Case-insensitive—If you want to specify the property name as a case-insensitive string, use lax.nl.env.variable_name.

For example, to access the system environment variable PATH, you could specify lax.nl.env.PATH or lax.nl.env.path.

Case-sensitive—If you want to specify the property name as a string in the exact case as it is defined in the environment, use lax.nl.env.exact_case.variable_name.

For example, to access system environment variable Path, specify lax.nl.env.exact_case.Path.

Note: These properties are resolved at application runtime, when LaunchAnywhere executes. You can also get access to system environment variables via InstallAnywhere variables.

Note: Windows and UNIX only.

lax.nl.env.path

The system PATH for the computer this application is running on.

Note: Runtime only. The lax.nl.env.path property cannot be set via the LaunchAnywhere Properties or Uninstaller Properties dialog boxes.

lax.nl.java.compiler

This property defines the name of the JIT (Just-In-Time compiler) that your application should use. Set this option to no value (that is, blank) to use the default JIT. You can also specify the name of a specific JIT by defining it in this property. Set lax.nl.java.compiler to off if no JIT is to be used.

lax.nl.java.launcher.main.class

The class that contains the main method called by LaunchAnywhere.

lax.nl.java.launcher.main.method

The name of the main method called by LaunchAnywhere.

lax.nl.java.option.additional

LaunchAnywhere writes the value of this property to the command line verbatim. Java VM properties or settings not directly supported by current LAX configuration properties can be included as part of the command line used to invoke Java. For example, to pass a custom variable as part of the command line, set lax.nl.java.option.additional to -Dmyvariable=value.

lax.nl.java.option.check.source

Set to on or off to tell the VM to verify bytecodes.

lax.nl.java.option.debugging

Turns debugging on or off in the Virtual Machine so that an application can be debugged. Set to on to enable debugging.

lax.nl.java.option.garbage.collection.
background.thread

Defines whether or not to have a low-priority background thread that does garbage collection. Set to on or off.

lax.nl.java.option.garbage.collection.extent

Sets the behavior for garbage collection:

min: Garbage collect everything except classes.

full: Garbage collect everything.

lax.nl.java.option.java.heap. size.initial

Defines the initial heap size for the installer that will be invoked. This number is always specified in bytes, not in kilobytes or megabytes, and is analogous to the VM parameter -ms or Xms. The default is 16777216 (16 MB).

lax.nl.java.option.java.heap. size.max

Defines the maximum heap size in bytes for the installer that will be invoked. This number is always specified in bytes, not in kilobytes or megabytes, and is analogous to the VM parameter -mx or Xmx. The default is 50331648 (48 MB).

lax.nl.java.option.verbose

Defines the level of content in output messages:

gc: Output garbage collection messages.

normal: Output all normal verbose messages.

all: Output all normal and garbage collection messages.

none: Do not output any verbose messages.

lax.nl.java.option.verify.mode

Sets when Java will verify classes for security and errors. Values can be remote, all, or none.

lax.nl.message.vm.not.loaded

Defines the message to show the end user in a dialog box if no VM can be found.

lax.nl.valid.vm.list

The list of VMs that this LaunchAnywhere Executable allows the Java application to be run against. The value for this property can be any space- or comma-delimited combination of valid VM criteria supported by InstallAnywhere. Some common criteria include

ALL (any VM)
JDK (any Java JDK)
JRE (any Java JRE)
IBM, SUN, HP, APPLE
1.4.*
1.5+
1.6*

For strict selection criteria, connect vendor, type, and version operators with an underscore character (<vendor>_<type>_<version>). For example, SUN_JDK_1.4* selects VMs from Sun that are JDKs of version 1.4.0_0 or newer.

The value of this property overrides the value listed in lax.nl.current.vm if the VM listed in that property is not of a valid type. The order of the valid VM list specifies the precedence in which VMs found on the system should be chosen if a valid VM is not listed in lax.nl.current.vm.

Note: For details on valid VM selection criteria, see About Java VM Selection Criteria.

lax.resource.dir

The platform name in exact case.

lax.root.install.dir

The root directory of the entire installation (same as $USER_INSTALL_DIR$).

lax.stderr.redirect

The location of your application's stderr output. Set to null to suppress, to console to write to a console window, or to any file name to output to a file.

This property maps to the corresponding text box in the Advanced Designer (Project page. General Settings view > Log Settings area): Send stderr to.

lax.stdout.redirect

The location of your application's stdout output. Set to null to suppress, console to write to a console window, or to any file name to output to a file.

This property maps to the corresponding text box in the Advanced Designer (Project page. General Settings view > Log Settings area): Send stdout to.

lax.user.dir

The working directory for your application. The default value for this property is . (period).

Leave as is to set the working directory to the directory where the LaunchAnywhere Executable resides. To override the default behavior, specify an absolute or relative path. (A relative path is relative to the LaunchAnywhere Executable location.)

lax.version

The version number of the LaunchAnywhere.

LISTPROPS

This property lists all system properties available to the Java application (it can take any value.) You must redirect stdout and stderr to see the results of this output.