|
Installation GuideJava TM Web StartVersion 1.0.1_01 |
This installation guide provides documentation for the system requirements and installation instructions for this release of Java Web Start.
Please send comments and feedback to javawebstart-feedback@sun.com.
System Requirements
Upgrading From the 1.0 Release
Upgrading From the 1.0-beta Release
Installing on Windows 95/98/NT/2000
Installing on Solaris/Linux
Using Java Web Start with Netscape 6/6.01
Adding a New JRE
Troubleshooting the Installation
This release of Java Web Start has been tested following systems:The platform requirements for using Java Web Start are the same as recommended for JRE implementations.
- Windows 95/98/NT/2000 using JRE 1.2.2, JRE 1.3.0 and JRE 1.3.1
- Solaris using JRE 1.2.2, JRE 1.3.0 and JRE 1.3.1
- Linux (RH 6.1/x86) using JRE 1.2.2, JRE 1.3.0 and JRE 1.3.1
Before installing this release of Java Web Start, the 1.0 version should not be uninstalled because it will cause the download cache to be cleared, and all of the previously installed Java Web Start applications will have to be downloaded again. The installation for this release will overwrite the 1.0 release, and update the browsers to use this new release. To reactivate the 1.0 release, you will have to re-installed it.The configuration files and program files folder used by Java Web Start have not changed, so all your settings should be kept the same after the upgrade.
On Windows, a special upgrade bundle that does not include a Java Runtime Environment is provided. It is recommended to download and install that if you already got Java Web Start 1.0 installed.
The cache layout and the location of javaws.cfg have changed between 1.0-beta and this release. This can, in rare circumstances, cause this release of Java Web Start to not work. Cleaning the user-local configuration directory should solve this problem. It is located at ~/.javaws/ on Solaris/Linux, and typically on C:\Windows\Profiles\.javaws or C:\Windows\Profiles\<username>\.javaws on Windows.
Download the javaws-1_0_1_01-win-us-rt.exe file from the java.sun.com Web site by clicking on the Download Now icon. Then locate and execute the downloaded file. This will launch a standard Windows-style installer that will guide you through the installation. The installer prompts for the installation directory (default is c:\Program Files\Java Web Start). Most likely, this will be acceptable. Click the next button, and the installer will install all necessary files and settings for Java Web Start. The installer will prompt you to restart the Netscape Navigator browser if it is running.The installer looks in the Windows Registry for already installed Java Runtime Environments (JREs), version 1.2.2 and higher, and automatically configures Java Web Start to use them. The installer will also install Java 2 Runtime Environment 1.3.0_03 if it is not present.
The installation registers the file extension .jnlp and the MIME type application/x-java-jnlp-file with Windows, so Java Web Start will be launched from both Netscape Navigator and Internet Explorer (and most other browsers) when a link to a JNLP file is activated. The installer also installs shortcuts to the Application Manager on the desktop and in the Windows Start menu.
The Solaris and Linux versions of Java Web Start is delivered as a ZIP file. The ZIP file contains the installation script, install.sh, along with the readme.html. The installation script is a sh shell script for Solaris, and a bash shell script for Linux. The installer does not come with a JRE, so that must be preinstalled on the system.Download the javaws-1_0_1_01-solsparc-us.zip for Solaris/SPARC, javaws-1_0_1_01-solx86.zip for Solaris/x86, or javaws-1_0_1_01-linux.zip for Linux/x86.
When you are prompted for a place to save the Java Web Start installer, pick a directory that would make a sensible permanent home for your copy of Java Web Start, for example, your home directory.
When the download finishes, unzip and execute the Java Web Start install script. The script will prompt you for the location of a Java 2 compatible JRE. For example: (the text in red is entered by the user)
mushmouth% unzip javaws-1_0_1_01-solsparc.zip
mushmouth% ./install.sh
...
Do you agree to the above license terms? [yes or no]
yes
In order to use Java Web Start you must have a version of Java 2 standard edition installed. If you do not, you can download one from http://java.sun.com.
Please enter the path of your installation (e.g. /usr/local/java/jdk1.2.2): /usr/local/java/jdk1.2.2
Creating javaws.cfg...
Extracting...
Updating action...
Updating ~/.mailcap...
Updating ~/.mime.types...The installer will create the javaws subdirectory and installs all the Java Web Start files into it.
The installer also updates the .mailcap and .mime.types files, so Java Web Start will be invoked when Netscape Navigator encounters a link to a JNLP link. On Solaris, it installs hooks into CDE so double-clicking on .jnlp files in the File Manager will also launch Java Web Start.
Make sure to restart Netscape to ensure that it picks up the new MIME type.
For Netscape 6/6.01 users, please setup the Java Web Start MIME type (JNLP) in the Edit->Preferences->Navigator->Helper Applications section. The file extension is "jnlp", MIME Type is "application/x-java-jnlp-file", and it should be handle by the javaws executable file in your Java Web Start directory.Also note that you must use the non-javascript version of the demos page, due to a problem with the Javascript with Netscape 6/6.01. For more information please refer to the developer's guide.
Java Web Start is bundled with the Java 2 Runtime Environment 1.3.0_03 on Windows. Thus, this JRE will be automatically available to applications launched with Java Web Start. On Solaris and Linux, the installer prompts for the location of a Java 2 Runtime Environment. This can either be a 1.2.2 or a 1.3.0 release.It is possible to associate new JREs to Java Web Start by using the Preference Panel in the built-in Application Manager. The Launching from the built-in Application Manager section describes how to launch the Application Manager.
In the Preference Panel, select the Java tab. This tab lists all the current associated JREs that are available for an application to be launched on. The easiest way to add a new JRE, is to click on the Find... button, which opens up a Wizard that allows you to search the harddisk for already installed JREs.
In the second pane, either:
This will guarantee that the search starts at the given directory.
- Type the search path in the file chooser dialog and press enter, instead of clicking on the next button, or
- Make sure to select a directory before clicking the next button.
If Java Web Start prints out a bad installation error message, then it has not been configured with the right information about your JRE locations. Check the contents of the javaws.cfg file. It will be in the installation directory of Java Web Start (typically at C:\Program Files\Java Web Start\javaws.cfg on Windows).These configuration entries need to reflect the locations of the Java 2 SE JRE installations on your system. For example:
javaws.cfg.jre.0.path=/usr/local/java/jdk1.3/solaris/bin/java
javaws.cfg.jre.0.platform=1.3
javaws.cfg.jre.0.product=1.3.0
javaws.cfg.jre.1.path=/usr/local/java/jdk1.2.2/solaris/bin/java
javaws.cfg.jre.1.product=1.2.2-W
javaws.cfg.jre.1.platform=1.2
javaws.cfg.jre.default=0Modify this file to reflect your system configuration by adding, removing, or deleting javaws.cfg.jre.<n>.location, javaws.cfg.jre.<n>.path, javaws.cfg.jre.<n>.platform and javaws.cfg.jre.<n>.product entries. Make sure that the javaws.cfg.jre.default=<n> refers to an existing entry. Entries are numbered consecutively starting at 0.
Java Web Start will not work with any version of the JRE 1.1.x software, or earlier versions.
 |
||
|
