Java Platform, Standard Edition

MSI Enterprise JRE Installer Guide

Release 9 for Windows

E80936-01

September 2017

This guide describes how to set up and use the Microsoft Windows Installer (MSI) Enterprise JRE Installer to install and uninstall the JRE 9 for Windows.

Java Platform, Standard Edition MSI Enterprise JRE Installer Guide, Release 9 for Windows

E80936-01

Copyright © 2015, 2017, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Contents

Preface

- Audience

- Documentation Accessibility

- Related Documents

- Conventions

1 Use the MSI Enterprise JRE Installer to Install the JRE

- System Requirements

- Installing the JRE from the MSI Enterprise Installer

- Installing the JRE from the Command Line

- Creating a Log File

- Performing a Static Installation of the JRE

- Uninstalling the JRE with Java Removal and Uninstall Tools

- Uninstalling the JRE from the Command Line

2 Use an Installer Configuration File to Install the JRE

- Installer Configuration File Options

- Example of an Installer Configuration File

- System Runtime Configuration File

Preface

This guide describes how to use the Microsoft Windows Installer (MSI) Enterprise JRE Installer to install and uninstall the Java Runtime Environment on Windows.

Note:

MSI Enterprise JRE Installer requires a commercial license for use in production. To learn more about commercial features and how to enable them, see Oracle Java SE Advanced & Suite Products.

Audience

This document is intended for administrators who have licenses for Java SE Advanced or Java SE Suite and need to install the JRE for Microsoft Windows across their enterprises.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.

Related Documents

For more information about installing Java SE 9, see:

- Overview of JDK 9 and JRE 9 Installation in Java Platform, Standard Edition Installation Guide

- Oracle Java SE Advanced and Oracle Java SE Suite

Conventions

The following text conventions are used in this document:

Convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

1 Use the MSI Enterprise JRE Installer to Install the JRE

You can use the Microsoft Windows Installer (MSI) Enterprise Installer to install and uninstall the Java Runtime Environment (JRE) 9 for Windows.

Note:

The MSI Enterprise JRE Installer requires a commercial license for use in production. To learn more about commercial features and how to enable them, see Oracle Java SE Advanced & Suite Products.

The Microsoft Windows Installer (MSI) Enterprise JRE Installer enables you to install the Java Runtime Environment across your enterprise. Because it fully supports Windows Installer 3.0, it is fully compatible with system management software, such as Systems Management Server (SMS) and Systems Center Configuration Manager (SCCM). These software management suites enable you to deploy software across your enterprise securely. In addition to the features and options you can specify with the JRE Offline Installer, you can specify a Java Usage Tracker configuration file and a deployment rule set.

This section includes the following topics:

- System Requirements

- Installing the JRE from the MSI Enterprise Installer

- Installing the JRE from the Command Line

- Creating a Log File

- Performing a Static Installation of the JRE

- Uninstalling the JRE with Java Removal and Uninstall Tools

- Uninstalling the JRE from the Command Line

System Requirements

Before installing the JRE, verify that your system meets the minimum system requirements.

See System Requirements for Installing the JDK and the JRE on Windows in the Java Platform, Standard Edition Installation Guide for minimum processor, disk space, and memory requirements.

If you have any difficulties, see General Java Troubleshooting in the Java Platform, Standard Edition Troubleshooting Guide or submit a bug report at http://bugreport.java.com/bugreport/.

Installing the JRE from the MSI Enterprise Installer

You can install the JRE by downloading and running the appropriate Oracle JRE 9 MSI Enterprise Installer for your system.

You must have administrative permissions in order to install the JRE.

1. Download the MSI Enterprise Installer (either for 32-bit or 64-bit Windows operating systems) from Information Center: Installation & Configuration for Oracle Java SE (Doc ID 1412103.2) on My Oracle Support.

a. Click the Complete List of Java SE downloads (document ID 1439822.1) link in the Downloads (Latest JDK/JRE) section.

b. Click the link of the appropriate Oracle JRE 9 MSI Enterprise Installer for your system and download it.

2. Run the installer with administrative permissions under the supported Windows Installer environments.
Follow the instructions that the installer provides. The installer notifies you if Java content is disabled in web browsers, and provides instructions for enabling it. If you previously hid some of the security prompts for applets and Java Web Start applications, then the installer provides an option for restoring the prompts.

The JRE is installed on your system. By default, Java Access Bridge is disabled. See Enabling and Testing Java Access Bridge in Java Platform, Standard Edition Java Accessibility Guide for instructions required to enable the Java Access Bridge.

3. After you complete the installation, you can delete the installer file to recover disk space.

After installation, use the Java item in the Windows Start menu to access essential Java information and functions, the help, the Java Control Panel, and to check for updates.

Installing the JRE from the Command Line

You can install the JRE by downloading the appropriate Oracle JRE 9 MSI Enterprise Installer for your system and running it from the command line.

1. Click the MOS link on the Oracle Java SE Advanced & Suite Products page and download the appropriate MSI Enterprise Installer (either for 32-bit or 64-bit Windows operating systems) for your system.

a. Click the Complete List of Java SE downloads (document ID 1439822.1) link in the Downloads (Latest JDK/JRE) section.

b. Click the link of the appropriate Oracle JRE 9 MSI Enterprise Installer for your system and download it.

2. Open an MS-DOS prompt with Administrative permissions.

3. Run one of the following commands depending on the type of installation that you want to perform:

- Basic UI mode:

msiexec.exe /i installer.msi [INSTALLCFG=configuration_file_path] [options] /qb

- Silent or unattended mode:

msiexec.exe /i installer.msi [INSTALLCFG=configuration_file_path] [options] /qn

The following items describe the variables used in these commands:

- installer.msi: The name of the MSI Enterprise JRE Installer that you obtained in the previous step.

- configuration_file_path: The path of the installer configuration file. See Use an Installer Configuration File to Install the JRE.

- options: Options with specified values, separated by spaces. Use the same options as listed in Installer Configuration File Options. You can also use standard Windows Installer options.

Creating a Log File

You can use a log file to verify that an installation succeeded.

To create a log file describing the installation, append /L C:\path\setup.log to the install command and scroll to the end of the log file to verify.

The following is an example of creating a log file:

msiexec.exe /i installer.msi /qn /L C:\path\setup.log

This example causes the log to be written to the C:\path\setup.log file.

Performing a Static Installation of the JRE

You can perform a static installation of the JRE if you want the Java Auto Update feature to leave that JRE installed during a Java update.

To perform a static installation of the JRE, specify the command-line option or the configuration file option STATIC=1. The Java Auto Update feature will leave that JRE installed during a Java update.

A later version of the same JRE family will be installed in a separate directory. This mode ensures that vendors, who require a specific version of the JRE for their product, can be certain that the JRE will not be overwritten by a newer version.

The default installation directory of a static JRE is C:\Program Files (x86)\Java\jren (for 32-bit versions) or C:\Program Files\Java\jren (for 64-bit versions), where n is the full Java SE release and update number (for example, n = 1.9.0_20 for release 9 update 20).

Uninstalling the JRE with Java Removal and Uninstall Tools

You can uninstall the JRE by using either the Java Removal Tool or the Java Uninstall tool.

To uninstall the JRE, with the Java Removal Tool, use the Add/Remove Programs utility in the Microsoft Windows Control Panel. The Java Removal Tool is integrated with the uninstallation process, and it will guide you through the removal of older JREs.

To uninstall the JRE, with the online Java Uninstall tool, go to https://www.java.com/en/download/uninstallapplet.jsp

The Java Uninstall tool helps you improve your computer security by finding and uninstalling older versions of Java. The Uninstall tool shows you a list of the Java versions on your computer and then removes those that are out-of-date.

Note:

The Java Uninstall tool will not run if your system administrator specified a deployment rule set in your organization.

The deployment rule set enables enterprises to directly manage their Java desktop environment and continue using legacy business applications in an environment of ever-tightening Java applet and Java Web Start application security policies. The deployment rule set enables administrators to specify rules for applets and Java Web Start applications. These rules might specify that a specific JRE version must be used. Consequently, the Java Uninstall tool will not run if it detects a deployment rule set that ensures required JREs are not uninstalled.

See Deployment Rule Set in the Java Platform, Standard Edition Deployment Guide.

Uninstalling the JRE from the Command Line

You can uninstall both the 32-bit and the 64-bit JRE from the command line.

Run the following command to uninstall the JRE:

msiexec /x {MSI product code of JRE}

In the command, use the MSI product code of the JRE version that you want to uninstall.

For example

- The following command uninstalls the 32-bit JRE, version 1.8.0_25:

msiexec /x {26A24AE4-039D-4CA4-87B4-2F83218025F0}

- The following command uninstalls the 64-bit JRE, version 1.8.0_25:

msiexec /x {26A24AE4-039D-4CA4-87B4-2F86418025F0}

In the examples, the values that are in braces are the MSI product code of the JRE that you want to uninstall. The text in bold, 18025, represents JRE version 1.8.0_25 that you want to uninstall.

2 Use an Installer Configuration File to Install the JRE

When installing the Java Runtime Environment (JRE) from the command line, you can use an installer configuration file to supplement the JDK command-line installation options.

Note:

The MSI Enterprise JRE Installer requires a commercial license for use in production. To learn more about commercial features and how to enable them see Oracle Java SE Advanced & Suite Products.

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

This section includes the following topics:

- Installer Configuration File Options

- Example of an Installer Configuration File

- System Runtime Configuration File

Installer Configuration File Options

The following table lists all of the installer configuration file options.

Note:

You can substitute Enable for 1 and Disable for 0.

With the exception of AUTO_UPDATE and STATIC, you can use these options when running the MSI Enterprise JRE Installer from the command line. See Installing the JRE from the Command Line.

Table 2-1 Configuration File Options

Option

Values

Description

AUTO_UPDATE=

Enable, Disable

Enables the auto update feature.

Default: Enable

Note:

This option is not available for the MSI Enterprise JRE Installer.

DEPLOYMENT_RULE_SET=

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.

EULA=

Enable, Disable

If a Java applet or Java Web Start application is launched, then the user is prompted to accept the end-user license agreement (EULA).

Default: Disable

INSTALL_DIR=

path

Folder or directory into which the files are installed.

The default install directory for Java is:

%ProgramFiles%\Java\jre$version

For Windows, this only works for the first-time installation of a family. Linux and Solaris use operating system tools for this purpose and the installation directory relocation is handled by operating system tools. For example:

rpm --prefix=path

NOSTARTMENU=

Enable, Disable

Specifies that the installer installs the JRE without setting up Java start-up items.

Default: Disable

REMOVEOLDERJRES=

0, 1

Applicable to Enterprise MSI only.

Enables uninstallation of all existing JREs on the system during JRE installation. The REMOVEOLDERJRES option does not remove static JRE installations.

Using REMOVEOLDERJRES=0 leaves all Java versions on the system. Using REMOVEOLDERJRES=1 removes all existing non-statically installed Java versions from the system.

For example, running

msiexec /i jre1.9.0.msi REMOVEOLDERJRES=1

removes all of the existing non-statically installed JREs from the system.

REMOVEOUTOFDATEJRES=

0, 1

Applicable to online and offline installers.

Used to uninstall any existing out-of-date Java versions during JRE install. This flag will work with the JRE installer executable in the silent mode.

For example, running

msiexec /s jre1.9.0.msi REMOVEOUTOFDATEJRES=1

removes all of the insecure JREs. JREs above the security baseline will not be uninstalled

Note:

Use the REMOVEOUTOFDATEJRES option in place of attempting to use modifyremove support.

REBOOT=

Enable, Disable

If disabled, then the installer never 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

STATIC=

Enable, Disable

Performs a static installation (see Performing a Static Installation of the JRE).

Default: Disable

Note:

This option is not available for the MSI Enterprise JRE Installer.

USAGETRACKERCFG=

path

Specifies the path and file name of the Java Usage Tracker properties file.

WEB_ANALYTICS=

Enable, Disable

Allows or disallows the installer to send installation-related statistics to an Oracle server.

Default: Enable

WEB_JAVA_SECURITY_LEVEL=

H (high), VH (very high)

Configures the installation's security level for Java applications running in a browser or running with Java Web Start.

Default: H

WEB_JAVA=

Enable, Disable

Configures the installation so that downloaded Java applications are, or are not, allowed to run in a web browser or by Java Web Start.

Default: Enable

Example of an Installer Configuration File

You an use the example of an installer configuration file to create your own configuration files for Windows.

The following is an example of an installer configuration file for Windows. It specifies the following:

- Perform a silent installation.

- 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 2-1 Example of an Installer Configuration File for Windows

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

System Runtime Configuration File

After installing the JRE, the installer creates the system runtime configuration file.

After using an installer configuration file to install the JRE, the installer saves it as a system runtime configuration file in %ALLUSERSPROFILE%\Oracle\Java\java_settings.cfg. The value of the environment variable %ALLUSERSPROFILE% is typically C:\ProgramData.

Oracle Legal Notices

Copyright Notice

Copyright © 1994-2017, Oracle and/or its affiliates. All rights reserved.

License Restrictions Warranty/Consequential Damages Disclaimer

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

Warranty Disclaimer

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

Restricted Rights Notice

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

Hazardous Applications Notice

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

Trademark Notice

Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.

Third-Party Content, Products, and Services Disclaimer

This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Pre-General Availability Draft Documentation Notice

If this document is in public or private pre-General Availability status:

This documentation is in pre-General Availability status and is intended for demonstration and preliminary use only. It may not be specific to the hardware on which you are using the software. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to this documentation and will not be responsible for any loss, costs, or damages incurred due to the use of this documentation.

Private Pre-General Availability Draft Documentation Notice

If this document is in private pre-General Availability status:

The information contained in this document is for informational sharing purposes only and should be considered in your capacity as a customer advisory board member or pursuant to your pre-General Availability trial agreement only. It is not a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. The development, release, and timing of any features or functionality described in this document remains at the sole discretion of Oracle.

This document in any form, software or printed matter, contains proprietary information that is the exclusive property of Oracle. Your access to and use of this confidential material is subject to the terms and conditions of your Oracle Master Agreement, Oracle License and Services Agreement, Oracle PartnerNetwork Agreement, Oracle distribution agreement, or other license agreement which has been executed by you and Oracle and with which you agree to comply. This document and information contained herein may not be disclosed, copied, reproduced, or distributed to anyone outside Oracle without prior written consent of Oracle. This document is not part of your license agreement nor can it be incorporated into any contractual agreement with Oracle or its subsidiaries or affiliates.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.