See JDK 7 and JRE 7 Installation Guide for general information about installing JDK 7 and JRE 7.
The following topics are covered:
See Oracle JRE 7 and JDK 7 Certified System Configurations for information about supported platforms, operating systems, and browsers.
See Windows System Requirements for JDK and JRE for minimum processor, disk space, and memory requirements.
For any text in this document that contains the following notation, you must substitute the appropriate update version number:
For example, if you were downloading the JDK installer for 32-bit systems for update 1.7.0_01, the file name:
jdk-7<version>-windows-i586.exe would become
Similarly, if you were downloading the JDK installer for 64-bit systems for update 1.7.0_01, the file name
jdk-7<version>-windows-x64.exe would become
In this procedure, you will run the self-installing executable file to unpack and install the JDK. As part of the JDK, this installation includes an option to include the public Java Runtime Environment. (The JDK also contains a private JRE for use only by its tools; see Private Versus Public JRE for more information.)
Install the JDK by doing the following:
If you save the self-installing executable file to disk without running it from the download page at the web site, note that its byte size provided on the download page. After the download has completed, verify that you have downloaded the full, uncorrupted software file.
You must have administrative permissions in order to install the JDK on Microsoft Windows.
The file jdk-7<version>-windows-i586-i.exe is the JDK installer for 32-bit systems. The file jdk-7<version>-windows-x64.exe is the JDK installer for 64-bit systems. If you downloaded either file instead of running it directly from the web site, double-click the installer's icon. Then, follow the instructions the installer provides. The installer may ask you to reboot your computer. When finished with the installation, you can delete the downloaded file to recover disk space.
Note: Installers for JDK 7u6 and later install the JavaFX SDK and integrate it into the JDK installation directory. Installers for JDK 7u2 to 7u5 install the JDK first, then start the JavaFX SDK installer, which installs JavaFX SDK in the default directory
C:\Program Files\Oracle\JavaFX 2.0 SDK or
C:\Program Files (x86)\Oracle\JavaFX 2.0 SDK on 64-bit operating systems. If you want to install the JavaFX SDK (version 2.0.2) with JDK 7u1 or earlier, see Installing JavaFX for more information.
You can perform a silent, non-interactive, JDK installation by using the command-line arguments. The following table lists example installation scenarios and the commands required to perform them:
|Install the public JRE in silent mode||
|Install development tools and source code in silent mode but not the public JRE||
jdk.exe /s ADDLOCAL="ToolsFeature,SourceFeature"
|Install development tools, source code, and the public JRE in silent mode||
jdk.exe /s ADDLOCAL="ToolsFeature,SourceFeature,PublicjreFeature"
|Install the public JRE in the specified directory
jdk.exe /s /INSTALLDIRPUBJRE=C:\test\
You can run the JDK without setting the
PATH environment variable, or you can optionally set it so that you can conveniently run the JDK executable files (
javadoc.exe, and so forth) from any directory without having to type the full path of the command. If you do not set the
PATH variable, you need to specify the full path to the executable file every time you run it, such as:
C:\> "C:\Program Files\Java\jdk1.7.0\bin\javac" MyClass.java
It is useful to set the
PATH variable permanently so it will persist after rebooting.
To set the
PATH variable permanently, add the full path of the
jdk1.7.0\bin directory to the
PATH variable. Typically, this full path looks something like
C:\Program Files\Java\jdk1.7.0\bin. Set the
PATH variable as follows on Microsoft Windows:
Click Start, then Control Panel, then System.
Click Advanced, then Environment Variables.
Add the location of the
bin folder of the JDK installation for the
PATH variable in System Variables. The following is a typical value for the
;) and is not case-sensitive. Microsoft Windows looks for programs in the
PATHdirectories in order, from left to right.
If you are new to developing and running programs in the Java programming language, see The Java Tutorial online for some guidance. Note especially the tutorial trails under the heading Trails Covering the Basics.
You can also download the JDK documentation from the Java SE Downloads page.
If you should ever want to uninstall the JDK, use the "Add/Remove Programs" utility in the Microsoft Windows Control Panel.
See JDK and JRE File Structure for a description of the directory structure of the JDK. (Note that the file structure of the JRE is identical to that of the JDK's
Below are some tips for working around problems that are sometimes seen during or following an installation. For more troubleshooting information, see Troubleshooting Java SE:
If you see the error message "corrupt cabinet file," then the file you have downloaded is corrupted. Check the file size against the expected file size listed in these instructions. If sizes do not match, try downloading the bundle again. (A cabinet file contains compressed application, data, resource, and DLL files.)
If you see the error message "system error during decompression," then you might not have enough space on the disk that contains your
If you see the error message "This program cannot be run in DOS mode," then do the following:
Installing the JDK also installs a private JRE and optionally a public copy. The private JRE is required to run the tools included with the JDK. It has no registry settings and is contained entirely in a
jre directory (typically at
C:\Program Files\jdk1.7.0\jre) whose location is known only to the JDK.
On the other hand, the public JRE can be used by other Java applications,
is contained outside the JDK (typically at
is registered with the Windows registry (at
can be removed using Add/Remove Programs,
might be registered with browsers,
and might have the
java.exe file copied to the Windows system directory (which would make it the default system Java platform).
In Microsoft Windows, when you create a new file in Microsoft Notepad and then save it for the first time, Notepad usually adds the
.txt extension to the file name. Therefore, a file you name
Test.java is saved as
Test.java.txt. It is important to note that you cannot see the
.txt extension unless you turn on the viewing of file extensions (in Microsoft Windows Explorer, unselect "Hide file extensions for known file types" under Folder Options). To prevent the
.txt extension, enclose the file name in quotation marks, such as
"Test.java", when typing it into the Save As dialog box.
On the other hand, Microsoft WordPad does not add the
.txt extension if you specify another extension. However, you must save the file as "Text Document".
On Windows XP, it is possible to name directories using characters that are not part of the system locale's code page. If such a directory is part of the installation path, then generic error 1722 occurs, and installation is not completed. Error 1722 is a Windows Installer error code. It indicates that the installation process has failed. The exact reason for this error is not known at this time.
To prevent this problem, ensure that the user and system locales are identical, and that the installation path contains only characters that are part of the system locale's code page. User and system locales can be set in the Regional Options or Regional Settings control panel.
The associated bug number is 4895647.