Documentation Contents

Java Platform, Standard Edition Installation Guide
Contents Previous

20 Installing With a Configuration File

This page describes the configuration file that supplements JDK command line installation options.Windows, macOS, and Linux command-line installers support the configuration file, but not every operating system supports all configuration file options.

An installer configuration file is an alternative to, and extension of, options specified on the installer command line. You can use a configuration file to standardize installations, and you can use a configuration file to specify options that are not available on the command line.

This page has these sections:

"Using a Configuration File"
"Configuration File Options"
"Sample Configuration File"
"System Runtime Configuration File"

Using a Configuration File

If you are installing the JRE on Windows, use the INSTALLCFG command-line option to specify a configuration file:

jre INSTALLCFG=configuration_file_path

jre is the installer base file name, for example, jre-8u05-windows-i586.exe.
configuration_file_path is the path to the configuration file.

If you are installing JRE on Solaris, Linux, or macOS, create a configuration file name named /etc/java/config/jre-install.properties. When you launch the JRE installer, it looks for a a configuration file with this specific path and name.

Configuration File Options

The following table lists the installer configuration file options that apply for each operating system.

Note:

You may substitute the value Enable for 1 and the value Disable for 0.

You may use the same options at the command line when running the JRE Windows Offline Installer. See "Command-Line Installation".

Table 20-1 Configuration File Options

Option	Operating Systems	Values	Description	JRE Offline Installer	Saved in Runtime Config file
`DEPLOYMENT_RULE_SET=`	Windows macOS Linux	`path`	Specifies the path and file name of your organization's deployment rule set. See Deployment Rule Set in the Java Platform, Standard Edition Deployment Guide.	yes	yes
`INSTALL_SILENT=`	Windows	`Enable`, `Disable`	Performs a silent (non-interactive) installation. Default: `Disable`	yes	yes
`INSTALLDIR=`	Windows	`path`	Specifies the folder/directory into which the files are installed. Default: Operating system default path For Windows, this will only work for first time install of a family. Linux and Solaris use operating system tools for this purpose and installation directory relocation will be handled by operating system tools (for example: `rpm --prefix=path`)]	yes	no
`STATIC=`	Windows	`Enable`, `Disable`	Performs a static installation (see "Static Installation"). Default: `Disable`	yes	no
`USAGETRACKER_CFG=`	Windows macOS Linux	`path`	Specifies the path and file name of the Java Usage Tracker properties file. See Java Usage Tracker Guide.	yes	yes
`AUTO_UPDATE=`	Windows macOS	`Enable`, `Disable`	Enables the auto update feature. Default: `Enable`	yes	yes
`WEB_JAVA=`	Windows macOS Linux	`Enable`, `Disable`	Configures the installation so downloaded Java applications are, or are not, allowed to run in a web browser or by Java Web Start. Default: `Enable`	yes	no
`WEB_JAVA_SECURITY_LEVEL=`	Windows macOS Linux	`H` (high), `VH` (very high)	Configures the installation's security level for Java applications running in a browser or run with Java Web Start. Default: `H`	yes	no
`WEB_ANALYTICS=`	Windows	`Enable`, `Disable`	Enables or disables the installer to send installation-related statistics to an Oracle server. Default: `Enable`	yes	yes
`EULA=`	Windows	`Enable`, `Disable`	Prompts the user to accept the end-user license agreement (EULA) if a Java applet or Java Web Start application is launched. Default: `Disable`	yes	yes
`REBOOT=`	Windows	`Enable`, `Disable`	If disabled, prompts you to restart your computer after installing the JRE. However, in most cases, the installer does not need to restart your computer after installing the JRE. Default: `Enable`	yes	no
`NOSTARTMENU`=	Windows	`Enable`, `Disable`	Specifies that the installer installs the JRE without setting up Java start-up items. Default: `Disable`	yes	no
`SPONSORS=`	Windows(32 bit)	`Enable`, `Disable`	Installs Java without being presented with any third-party sponsor offers. Default: `Enable`	no	no
`REMOVEOUTOFDATEJRES=`	Windows	`0`, `1`	NOTE: Applicable to online and offline installers only (`.exe` files and wrappers). Enables uninstallation of existing out-of-date JREs during JRE install. Using `REMOVEOUTOFDATEJRES=0` leaves all out-of-date Java versions on the system. Using `REMOVEOUTOFDATEJRES=1` removes all out-of-date Java versions from the system. For example, running `jre1.8.0_60.exe /s REMOVEOUTOFDATEJRES=1` will remove all JREs below the security baseline. JREs above the security baseline will not be uninstalled.	yes	no

Sample Configuration File

The following is a sample configuration file for Windows. It specifies the following:

Perform a silent install.
Install the JRE in the directory C:\java\jre.
Set the security level for unsigned Java applications running in a browser to very high.

Example 20-1 Sample Configuration File for Windows

INSTALL_SILENT=Enable
INSTALLDIR=C:\java\jre
WEB_JAVA_SECURITY_LEVEL=VH

System Runtime Configuration File

After installing the JRE with a configuration file, the installer saves the file (with a subset of options used during install) in one of the following locations in your computer, depending on your operating system:

Windows: %ALLUSERSPROFILE%\Oracle\Java\java.settings.cfg

The value of the environment variable %ALLUSERSPROFILE% is typically C:\ProgramData.
Solaris and Linux: /etc/Oracle/Java/java.settings.cfg
macOS: /Library/Application/Support/Oracle/Java/java.settings.cfg

Contents Previous

Copyright © 1993, 2019, Oracle and/or its affiliates. All rights reserved.