Java Platform, Standard Edition Installation Guide
Contents    Previous   

20 Installing the JDK and the JRE with a Configuration File

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

Note: Windows, macOS, Linux, and Solaris command-line installers support the configuration file, but not every operating system supports all configuration file options.

This page has these sections:

Using a Configuration File

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

installer INSTALLCFG=configuration_file_path

  • installer is the installer base file name, for example, jre-8u211-windows-x64.exe or jdk-8u211-windows-x64.exe.

  • configuration_file_path is the path to the configuration file.

If you are installing the JRE or JDK on Solaris, Linux, or macOS, create a configuration file name named /etc/java/config/jre-install.properties. When you launch the JRE or JDK installer, it looks for 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:

Table 20-1 Configuration File Options

Option Operating Systems Values Description Default Value Saved in Runtime Configuration File?
AUTO_UPDATE= Windows, macOS Enable, Disable Enables the auto update feature. Enable yes
DEPLOYMENT_RULE_SET= Windows, macOS, Linux, Solaris 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. None 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. Disable yes
INSTALL_SILENT= Windows Enable, Disable Performs a silent (non-interactive) installation. Disable yes
INSTALLDIR= Windows path Specifies the folder/directory into which the files are installed. 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) Operating system default path no
INSTALLDIRPUBJRE= Windows path When installing the JDK, this option specifies the folder where the public JRE is installed. When specifying this option, you must also specify which folder where the JDK is installed with the INSTALLDIR option. Operating system default path No
NOSTARTMENU= Windows Enable, Disable Specifies that the installer installs the JDK or JRE without setting up Java start-up items. Disable no
REBOOT= Windows Enable, Disable If disabled, prompts you to restart your computer after installing the JDK or JRE. However, in most cases, the installer does not need to restart your computer after installing the JDK or JRE. Enable no
REMOVEOUTOFDATEJRES= Windows 0, 1

Note: Applicable to online and offline installers only (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.

0 no
STATIC= Windows Enable, Disable Performs a static installation (see "Static Installation"). Disable no
USAGETRACKER_CFG= Windows, macOS, Linux, Solaris path Specifies the path and file name of the Java Usage Tracker properties file. See Java Usage Tracker Guide. None yes
WEB_ANALYTICS= Windows Enable, Disable Enables or disables the installer to send installation-related statistics to an Oracle server. Enable yes
WEB_JAVA_SECURITY_LEVEL= Windows, macOS, Linux, Solaris H (high), VH (very high) Configures the installation's security level for Java applications running in a browser or run with Java Web Start. H no
WEB_JAVA= Windows, macOS, Linux, Solaris 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. Enable no

Sample Configuration File

The following is a sample JRE 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 JDK or 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, 2021, Oracle and/or its affiliates. All rights reserved.