Difference: LaunchingAPPXDesktopClientFromWebPageViaJavaWebstart (56 vs. 57)

Revision 572011-03-08 - JoeOrtagus

Line: 1 to 1
 
META TOPICPARENT name="APPXAdministrator"

APPX Desktop Client Launched via Java Web Start

Added:
>
>
 This document will explain how to start the APPX Desktop Client via Java Web Start Technology.

Overview

Line: 4 to 5
 This document will explain how to start the APPX Desktop Client via Java Web Start Technology.

Overview

Changed:
<
<
When you publish the APPX Desktop Client using Java Web Start technology you ensure the most current version of the application will be deployed, as well as the correct version of the Java Runtime Environment (JRE). Since the APPX Desktop Client will only be configured on the web server, you will not need to install the client on each desktop in your enterprise, just have the user base run the application for a published URL. This document applies to APPX Desktop Client version 4.2.a and above. These instructions do not require any APPX server configuration other than an APPX Login Manager configured to accept logins. APPX server on any platform may be connected to via the client when launched with Java Web Start. The size of the APPX Java Web Start bundle is about 1.3 MB. When the APPX Desktop Client is run for the first time, Java Web Start will download the entire package ; the next time it will check only for modified jar files (an upgrade) and download them. If this is not the case, the application will start immediately.
>
>
When you publish the APPX Desktop Client using Java Web Start technology you ensure the most current version of the application will be deployed, as well as the correct version of the Java Runtime Environment (JRE). Since the APPX Desktop Client will only be configured on the web server, you will not need to install the client on each desktop in your enterprise, just have the user base run the application for a published URL. This document applies to APPX Desktop Client version 5.0.4b1 and above. These instructions do not require any APPX server configuration other than an APPX Login Manager configured to accept logins. APPX server on any platform may be connected to via the client when launched with Java Web Start. The size of the APPX Java Web Start bundle is about 1.3 MB. When the APPX Desktop Client is run for the first time, Java Web Start will download the entire package ; the next time it will check only for modified jar files (an upgrade) and download them. If this is not the case, the application will start immediately.
 

Required software components

APPX Desktop Client Java Web Start Bundle

Changed:
<
<
You can get the APPX Desktop Client Java Web Start Bundle from here.
>
>
You can get the APPX Desktop Client Java Web Start Bundle from here.
 

APPX Server

Added:
>
>
 You need a functioning APPX installation. Follow instructions in this document to install APPX on Windows if you don't already have APPX installed.

Web Server

Added:
>
>
 You need a functioning web server configured with jnlp mime type support. Apache and IIS are two common servers.

Quick steps

Line: 30 to 37
 

Download and place the APPX Desktop Client Java Web Start Bundle.

Changed:
<
<
I downloaded version 4.2.a from here. Place the bundle in a directory off of your web server's web root and follow the steps below to install and configure.
>
>
I downloaded version 5.0.4b1 from here. Place the bundle in a directory off of your web server's web root and follow the steps below to install and configure.
 
  • I am going to use the command line tool wget to fetch the file bundle:

Changed:
<
<
[joe@webserver /]$ cd /var/www/html 
[joe@webserver /]$ sudo wget http://www.appx.com/ftp/appx/products/appx/client/4.2.a/java_web.tgz

>
>
[joe@webserver /]$ *cd /var/www/html* 
[joe@webserver /]$ *sudo wget http://www.appx.com/ftp/appx/products/appx/client/5.0.4.beta1/java_web.tgz*

 [joe@webserver html]$
Changed:
<
<
>
>
 
  • Now let's untar the files
Changed:
<
<
[joe@webserver html]$ sudo tar xzvf java_web.tgz
>
>
[joe@webserver html]$ *sudo tar xzvf java_web.tgz*
 
Changed:
<
<
appx/

>
>
appx/

 appx/appx32.gif appx/README.txt appx/INSTALL.txt
Line: 63 to 63
 appx/appx-nativelib.jar appx/appx.jar appx/appx.jnlp
Changed:
<
<
>
>
 
Changed:
<
<
[joe@webserver html]$ ls -la
>
>
[joe@webserver html]$ *ls -la*
 
Changed:
<
<
total 1216

>
>
total 1216

 drwxr-xr-x 3 root root 4096 Mar 4 14:27 . drwxr-xr-x 10 root root 4096 Jun 26 2007 .. drwxrwxrwx 2 root root 4096 Mar 3 14:40 appx -rw-r--r-- 1 root root 1233805 Mar 4 14:27 java_web.tgz
Changed:
<
<
>
>
 
Changed:
<
<
[joe@webserver html]$ cd appx
[joe@webserver appx]$ ls
>
>
[joe@webserver html]$ *cd appx*
[joe@webserver appx]$ *ls*
 
Changed:
<
<
appx32.gif  appx.html  appx.jar  appx.jnlp  APPXLaunchButton.png  appx-nativelib.jar  INSTALL.txt  README.txt  splash.gif
>
>
appx32.gif  appx.html  appx.jar  appx.jnlp  APPXLaunchButton.png  appx-nativelib.jar  INSTALL.txt  README.txt  splash.gif
 

APPX Desktop Client Web Start Bundle Components

appx32.gif

Line: 97 to 84
 

APPX Desktop Client Web Start Bundle Components

appx32.gif

Added:
>
>
 The appx32.gif file is the file used as an application runtime icon. It is referenced by the appx.jnlp file that we review later in this document.

README.txt

Added:
>
>
 README.txt contains the following very brief instructions to the reader.
Changed:
<
<
>
>
 Place these files in a directory named /appx/ off your web server's webroot.

You need to change three items, all references to www.example.com to read your site URL:

Line: 116 to 104
 appx.jnlp: --->

Please see our Wiki at http://wiki.appx.com/wiki/bin/view/Main/LaunchingAPPXDesktopClientFromWebPageViaJavaWebstart for further documentation.

Changed:
<
<
>
>
 

INSTALL.txt

Added:
>
>
 INSTALL.txt points the reader to README.txt

appx.html

Added:
>
>
 The appx.html file exists only to provide the user with a link to click the appx.jnlp file. It is not technically needed because if someone entered the path to the jnlp file the application would launch just the same as if the jnlp file had been clicked from a link in the html file. Let's take a look at the appx.html file. This file is just a starter file that you can use to load the .jnlp file. There is a bit of javascript code that attempts to detect if a JRE is installed on the user's desktop for the Java Web Start launch. If the JRE needs to be installed or updated the script will either attempt to update the JRE or present the user with the appropriate link to download the software manually.
appx.html contents
Changed:
<
<
[joe@webserver appx]$ cat appx.html
>
>
[joe@webserver appx]$ *cat appx.html*
 
Changed:
<
<
>
>
  APPX Desktop Client Web Start
Line: 140 to 126
 
Changed:
<
<



>
>

 
APPX Desktop Client Web Start Demonstration
Changed:
<
<

>
>
 

Clicking the icon below will attempt to detect if the correct Java JRE is installed, and if possible install it. If the installer determines you need an updated JRE but it can't auto install a JRE, it will place you on Sun's download page for your platform. After the JRE requirement is met, the APPX Desktop Client will be downloaded and launched.

Changed:
<
<


>
>
 

<--Click To Launch the APPX Desktop Client Demonstration-->
<-- Start of Sun's deployJava.js script that attempts to detect if Java is installed and install it or updated -->

Line: 171 to 157
 

[joe@webserver appx]$

Changed:
<
<
>
>
 
appx.html modifications
Added:
>
>
 You should change the following two URL values in your appx.html file to match your site.
Changed:
<
<
         var url = " http://www.example.com/appx/appx.jnlp ";

>
>
         var url = " http://www.example.com/appx/appx.jnlp ";

  deployJava.launchButtonPNG = " APPXLaunchButton.png ";
Changed:
<
<
>
>
 

splash.gif

Added:
>
>
 This is the initial image displayed while the APPX Desktop Client is loading, it is referenced by name in the appx.jnlp file.

APPXLaunchButton.png

Line: 191 to 178
 The appx-nativelib.jar file contains platform specific files for the proper execution of the appx.jar file.

appx.jar

Added:
>
>
 The APPX Desktop Client in Java jar format.

appx.jnlp

Added:
>
>
 This is an XML file that defines the environment that the APPX Desktop Client will run it. The file is made up of elements, element values, element stanzas and comments. The file is documented with comments. Now take a look at the appx.jnlp file.
appx.jnlp contents
Changed:
<
<
[joe@webserver appx]$ cat appx.jnlp
>
>
[joe@webserver appx]$ *cat appx.jnlp*
 
Changed:
<
<
<-- JNLP File for APPX Desktop Client 5.0.0.a9 -->
>
>
<-- JNLP File for APPX Desktop Client 5.0.4b1 -->
 
<-- JNLP File for APPX Desktop Client  -->
Changed:
<
<
<-- example JNLP file that will launch the APPX Desktop Client 5.0.0.a9 -->
>
>
<-- example JNLP file that will launch the APPX Desktop Client 5.0.4b1 -->
 
<-- where the jnlp file lives on the web -->
Line: 214 to 198
  APPX Desktop Client Java Web Start Demo Application APPX Software, Inc.
Changed:
<
<
APPX Desktop Client version 4.2.a.
>
>
APPX Desktop Client version 5.0.4b1.
  Connects to APPX Client Login Manager.
<-- hover help for this app.  -->
Changed:
<
<
APPX Desktop Client 5.0.0.a9
>
>
APPX Desktop Client 5.0.4b1
 
<-- This is the APPX Desktop Client application icon and splash screen. -->
<-- relative to codebase -->
Line: 259 to 243
 

[joe@webserver appx]$

Changed:
<
<
>
>
 
appx.jnlp modifications
Added:
>
>
 You should change the following URL value in your appx.jnlp file to match your site.
Changed:
<
<
         codebase=" http://www.example.com/appx " href="appx.jnlp"
>
>
         codebase=" http://www.example.com/appx " href="appx.jnlp"
 Towards the end of the appx.jnlp file, notice the application-desc elements with argument attributes of -windowTitle, -remoteHost ... You can add any APPX Desktop Client startup parameter that you normally find when you select Options, Advanced upon initially starting the APPX Desktop Client.

Table of possible element / attribute available to you in a JNLP file.
Changed:
<
<
Elements and Attributes of a JNLP file
>
>
 

Changed:
<
<

Element

Attributes

>
>
Element

Attributes

 

Deleted:
<
<

Description

 
Changed:
<
<

Since

>
>
Description
 
Changed:
<
<

Required

>
>
 
Added:
>
>
Since
 
Added:
>
>
Required
 
Added:
>
>
 
Changed:
<
<

jnlp

>
>
jnlp
 

Changed:
<
<


>
>
 

Deleted:
<
<

This is the main xml element for a jnlp file. Everything is contained within the jnlp element.

 
Changed:
<
<

1.0

>
>
This is the main xml element for a jnlp file. Everything is contained within the jnlp element.
 
Changed:
<
<

yes

>
>

1.0

yes

 
Deleted:
<
<


 

Changed:
<
<

spec

The spec attribute can be 1.0, 1.5.0, or 1.6.0 or can use the wildcards such as 1.0+ or 1.6+. It denoted the minimum version of the JNLP Specification that this jnlp file can work with.

>
>
spec

The spec attribute can be 1.0, 1.5.0, or 1.6.0 or can use the wildcards such as 1.0+ or 1.6+. It denoted the minimum version of the JNLP Specification that this jnlp file can work with.

 

Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Changed:
<
<


>
>
 
Changed:
<
<

codebase

>
>

codebase

 

Changed:
<
<

The codebase attribute specifies the base location for all relative URLs specified in href attributes in the JNLP file.

>
>
The codebase attribute specifies the base location for all relative URLs specified in href attributes in the JNLP file.
 

Changed:
<
<

1.0

>
>
1.0
 

Deleted:
<
<


 
Changed:
<
<


>
>
 
Changed:
<
<

href

>
>

href

 

Deleted:
<
<

The href specifies the URL of the JNLP file itself.

 
Changed:
<
<

1.0


>
>
The href specifies the URL of the JNLP file itself.
 
Changed:
<
<

>
>

1.0

 
Deleted:
<
<


 
Deleted:
<
<
 
Changed:
<
<

version

>
>
 
Changed:
<
<

The version of the application being launched, as well as the version of the JNLP file itself.

1.0

>
>
 
Changed:
<
<


>
>
version
 
Changed:
<
<

information

>
>
 
Changed:
<
<


The information element contains other elements that describe the application and it's source.

>
>
The version of the application being launched, as well as the version of the JNLP file itself.

1.0

information

The information element contains other elements that describe the application and it's source.

 

Changed:
<
<

1.0

yes

>
>
1.0

yes

 
Changed:
<
<
>
>
 
Deleted:
<
<


os

 
Changed:
<
<
>
>
 
Changed:
<
<

Specifies the operating system for which this information element should be considered.

1.5.0

>
>
os
 
Changed:
<
<

>
>
 
Changed:
<
<


>
>
Specifies the operating system for which this information element should be considered.

1.5.0

 
Changed:
<
<


>
>
 

Deleted:
<
<

arch

 
Changed:
<
<

Specifies the architecture for which this information element should be considered

1.5.0

>
>
arch
 
Changed:
<
<


>
>
Specifies the architecture for which this information element should be considered
 
Changed:
<
<


>
>
1.5.0

 
Deleted:
<
<

 

Deleted:
<
<

platform

Specifies the platform for which this information element should be considered.

 
Changed:
<
<
>
>
platform
 
Changed:
<
<

1.5.0

>
>
Specifies the platform for which this information element should be considered.
 
Changed:
<
<


>
>

1.5.0

 

Changed:
<
<


locale

>
>

locale

 

Changed:
<
<

Specifies the locale for which this information element should be considered.

1.5.0


>
>
Specifies the locale for which this information element should be considered.
 
Changed:
<
<

title

>
>
1.5.0
 
Changed:
<
<


The title element specifies the title of the application.

>
>

title

The title element specifies the title of the application.

1.0

yes

vendor

The vendor element specifies the provider of the application.

 
Added:
>
>
 
Deleted:
<
<

1.0

 
Changed:
<
<

yes

>
>
1.0

yes

 
Added:
>
>
 
Changed:
<
<

vendor

>
>
homepage
 
Changed:
<
<


>
>
 
Changed:
<
<

The vendor element specifies the provider of the application.

>
>
The homepage of the application.

1.0

href

A URL pointing to where more information on this application can be found.

 

Deleted:
<
<

1.0

yes

 
Changed:
<
<
>
>
1.0

yes

description

 
Deleted:
<
<

homepage


 

Changed:
<
<

The homepage of the application.

>
>
A short statement describing the application.

1.0

kind

An indicator as to what type of description this is, legal values are one-line, short, and tooltip.

 
Added:
>
>
 
Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Changed:
<
<


>
>
 
Changed:
<
<

href

>
>

icon

 
Added:
>
>
 
Changed:
<
<

A URL pointing to where more information on this application can be found.

>
>
Describes an icon that can be used to identify the application to the user.

1.0

href

A URL pointing to the icon file, may be in one of the following formats: gif, jpg, png, ico.

 

Deleted:
<
<

1.0

 
Changed:
<
<

yes

>
>
1.0
 
Changed:
<
<

description

>
>

yes

 
Changed:
<
<


>
>
kind
 

Changed:
<
<

A short statement describing the application.

>
>
Indicates the suggested use of the icon, can be: default, selected, disabled, rollover, splash, or shortcut.
 
Added:
>
>
 
Deleted:
<
<

1.0

 
Changed:
<
<
>
>
1.0
 
Changed:
<
<



>
>
 
Changed:
<
<

>
>
 
Added:
>
>

width

 
Changed:
<
<

kind

>
>
 
Changed:
<
<

An indicator as to what type of description this is, legal values are one-line, short, and tooltip.

>
>
Can be used to indicate the resolution of the image.
 

Deleted:
<
<

1.0


 
Changed:
<
<

icon


>
>
1.0
 
Changed:
<
<

Describes an icon that can be used to identify the application to the user.

1.0

>
>
 
Changed:
<
<


>
>
 
Changed:
<
<


>
>
 
Added:
>
>
height
 
Deleted:
<
<
 
Deleted:
<
<

href

 
Deleted:
<
<

A URL pointing to the icon file, may be in one of the following formats: gif, jpg, png, ico.

 
Changed:
<
<

1.0

>
>
Can be used to indicate the resolution of the image.
 
Changed:
<
<

yes

>
>
1.0
 
Changed:
<
<


>
>
 
Changed:
<
<

kind

>
>
 
Changed:
<
<

Indicates the suggested use of the icon, can be: default, selected, disabled, rollover, splash, or shortcut.

>
>

depth

Can be used to indicate the resolution of the image.

 

Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Changed:
<
<


>
>

offline-allowed

 
Deleted:
<
<

width

 

Deleted:
<
<

Can be used to indicate the resolution of the image.

 
Changed:
<
<

1.0


>
>
Indicates that this application can operate when the client system is disconnected from the network.
 
Changed:
<
<

>
>
1.0
 
Changed:
<
<


>
>
 
Changed:
<
<

height

>
>
shortcut
 
Changed:
<
<

Can be used to indicate the resolution of the image.

1.0

>
>
 
Changed:
<
<
>
>
 
Changed:
<
<



>
>
The shortcut element can be used to indicate an application's preferences for desktop integration.
 
Changed:
<
<

>
>
1.5.0
 
Changed:
<
<

depth

Can be used to indicate the resolution of the image.

>
>
 
Changed:
<
<

1.0


>
>
 
Deleted:
<
<
 
Deleted:
<
<

offline-allowed


 
Changed:
<
<

Indicates that this application can operate when the client system is disconnected from the network.

>
>

online

Can be used to describe the application's preference for creating a shortcut to run online or offline.

 
Added:
>
>
 
Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.5.0
 
Changed:
<
<

shortcut

>
>
 
Changed:
<
<
>
>

desktop

 
Deleted:
<
<


 
Added:
>
>
 
Deleted:
<
<

The shortcut element can be used to indicate an application's preferences for desktop integration.

 
Changed:
<
<

1.5.0

>
>
Can be used to indicate an application's preference for putting a shortcut on the users desktop.
 
Changed:
<
<


>
>
1.5.0
 
Changed:
<
<


>
>
 
Changed:
<
<

online

>
>
 
Changed:
<
<

Can be used to describe the application's preference for creating a shortcut to run online or offline.

>
>
menu
 
Changed:
<
<

1.5.0


>
>
 
Changed:
<
<

>
>
Can be used to indicate an application's preference for putting a menu item in the users start menus.
 
Changed:
<
<

desktop

>
>
 
Changed:
<
<


>
>
1.5.0
 
Changed:
<
<

Can be used to indicate an application's preference for putting a shortcut on the users desktop.

1.5.0

>
>
 
Deleted:
<
<


 
Changed:
<
<

>
>
 
Changed:
<
<

menu

>
>
 
Changed:
<
<


Can be used to indicate an application's preference for putting a menu item in the users start menus.

>
>
sub-menu

 
Added:
>
>
Can be used to indicate an application's preference for where to place the menu item.
 
Deleted:
<
<

1.5.0

 
Added:
>
>

1.5.0

 
Added:
>
>
 
Deleted:
<
<


 
Changed:
<
<


>
>
 
Changed:
<
<

sub-menu

>
>

association

 
Added:
>
>
 
Deleted:
<
<

Can be used to indicate an application's preference for where to place the menu item.

 
Changed:
<
<

1.5.0

>
>
Can be used to hint to the JNLP client that it wishes to be registered with the operating system as the primary handler of certain extensions and a certain mime-type.
 
Changed:
<
<


>
>
 
Changed:
<
<

association

>
>
1.5.0
 
Deleted:
<
<


 
Changed:
<
<

Can be used to hint to the JNLP client that it wishes to be registered with the operating system as the primary handler of certain extensions and a certain mime-type.

>
>
 
Changed:
<
<

1.5.0


>
>
 
Changed:
<
<

>
>
extensions
 
Changed:
<
<


>
>
 
Changed:
<
<

extensions

>
>
Contains a list of file extensions (separated by spaces) that the application requests it be registered to handle.
 
Changed:
<
<

Contains a list of file extensions (separated by spaces) that the application requests it be registered to handle.

1.5.0

>
>
1.5.0
 

Deleted:
<
<



 
Changed:
<
<

mime-type

Contains the mime-type that the application requests it be registered to handle.

>
>
 
Changed:
<
<
>
>

mime-type

Contains the mime-type that the application requests it be registered to handle.

 
Deleted:
<
<

1.5.0

 
Changed:
<
<


>
>

1.5.0

 

Changed:
<
<

related-content


>
>

related-content

 

Changed:
<
<

Describes an additional piece of related content that may be integrated with the application.

1.5.0

>
>
Describes an additional piece of related content that may be integrated with the application.

1.5.0

 

Deleted:
<
<


 
Changed:
<
<


>
>
 
Changed:
<
<

>
>
 
Changed:
<
<

href

A URL pointing to the related content.

>
>
href
 
Changed:
<
<

1.5.0

>
>
A URL pointing to the related content.
 
Changed:
<
<

yes

>
>
 
Changed:
<
<


>
>
1.5.0
 
Changed:
<
<


>
>
 
Changed:
<
<

>
>
yes
 
Deleted:
<
<


 
Changed:
<
<


>
>
 
Changed:
<
<


>
>
 
Changed:
<
<
>
>
 
Changed:
<
<

update


>
>
 
Changed:
<
<
>
>
 
Deleted:
<
<

The update element is used to indicate the preferences for how application updates should be handled by the JNLP Client.

1.6.0

 
Deleted:
<
<
 
Changed:
<
<


>
>
 
Deleted:
<
<


 
Changed:
<
<
>
>
update
 
Changed:
<
<

check

Indicates the preference for when the JNLP Client should check for updates. It can be always, timeout, or background..

>
>
 
Changed:
<
<

1.6.0

>
>
The update element is used to indicate the preferences for how application updates should be handled by the JNLP Client.
 
Changed:
<
<


>
>
1.6.0
 
Changed:
<
<


>
>
 
Deleted:
<
<

 
Added:
>
>
 
Deleted:
<
<

policy

 
Changed:
<
<

Indicates the preference for how the JNLP Client should handle an application update when it is known an update is available before the application is launched. It can be always, prompt-update, or prompt-run.

>
>
check
 
Changed:
<
<

1.6.0

>
>
Indicates the preference for when the JNLP Client should check for updates. It can be always, timeout, or background..
 
Changed:
<
<


>
>
 
Changed:
<
<
>
>
1.6.0

 
Deleted:
<
<



 
Changed:
<
<
>
>
 
Changed:
<
<


>
>

policy

Indicates the preference for how the JNLP Client should handle an application update when it is known an update is available before the application is launched. It can be always, prompt-update, or prompt-run.

 
Added:
>
>
 
Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.6.0
 
Changed:
<
<

security

>
>
 
Changed:
<
<
>
>

 
Deleted:
<
<


 
Added:
>
>
 
Deleted:
<
<

This element can be used to request enhanced permissions.

 
Changed:
<
<

1.0

>
>
 
Changed:
<
<


>
>
1.0
 
Changed:
<
<
>
>
 
Changed:
<
<

all-permissions

>
>
security
 
Added:
>
>
 
Deleted:
<
<


 
Changed:
<
<

Requests that the application be run with all permissions.

>
>
 
Changed:
<
<

1.0


>
>
This element can be used to request enhanced permissions.
 
Changed:
<
<
>
>
1.0

 
Deleted:
<
<
 
Deleted:
<
<

j2ee-application-client-permissions


 
Changed:
<
<

>
>
all-permissions
 
Changed:
<
<

Requests that the application be run with a permission set that meets the security specifications of the J2EE Application Client environment.

1.0

>
>
 
Changed:
<
<



>
>
Requests that the application be run with all permissions.
 
Changed:
<
<



>
>
 
Changed:
<
<
>
>
1.0
 
Deleted:
<
<

1.0


 
Changed:
<
<
>
>
 
Changed:
<
<

resources


>
>
j2ee-application-client-permissions
 
Changed:
<
<
>
>
 
Changed:
<
<

Describes all the resources that are needed for an application.

1.0

>
>
Requests that the application be run with a permission set that meets the security specifications of the J2EE Application Client environment.

1.0

 

Deleted:
<
<

yes

 
Changed:
<
<


>
>
 
Changed:
<
<

os

>
>

 
Deleted:
<
<

Specifies the operating system for which the resources element should be considered.

 

Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Added:
>
>
 
Changed:
<
<


>
>

resources

 
Deleted:
<
<

arch

 

Deleted:
<
<

Specifies the architecture for which the resources element should be considered.

1.0

 
Added:
>
>
Describes all the resources that are needed for an application.

1.0

 
Added:
>
>
 
Changed:
<
<



>
>
yes
 
Changed:
<
<

>
>
 
Changed:
<
<

locale

Specifies that the locales for which the resources element should be considered.

>
>
 
Changed:
<
<



>
>
os
 
Changed:
<
<

java (or java se)


>
>
 
Changed:
<
<

Specifies what version(s) of Java to run the application with.

>
>
Specifies the operating system for which the resources element should be considered.
 
Added:
>
>
 
Deleted:
<
<

1.6.0 (java)

 
Changed:
<
<
>
>
1.0
 
Changed:
<
<



>
>

 
Deleted:
<
<

 

Changed:
<
<

version

>
>
arch
 
Added:
>
>
 
Deleted:
<
<

Describes an ordered list of version ranges to use.

 
Changed:
<
<

1.0

>
>
Specifies the architecture for which the resources element should be considered.
 
Changed:
<
<

yes

>
>
1.0
 
Changed:
<
<


>
>
 
Changed:
<
<

href

>
>
 
Changed:
<
<

The URL denoting the supplier of this version of java, and where it may be downloaded from.

>
>

locale

Specifies that the locales for which the resources element should be considered.

 

Deleted:
<
<

1.0

 
Changed:
<
<


>
>
 
Changed:
<
<


>
>

java (or java se)

 
Deleted:
<
<

java-vm-args

 

Deleted:
<
<

Indicates an additional set of standard and non-standard virtual machine arguments that the application would prefer the JNLP

 
Changed:
<
<
Client to use when launching Java.

1.0

>
>
Specifies what version(s) of Java to run the application with.

1.6.0 (java)

 
Added:
>
>
 
Deleted:
<
<


 
Changed:
<
<

>
>
 
Changed:
<
<


>
>
 
Changed:
<
<

initial-heap-size

Indicates the initial size of the Java heap.

1.0

>
>
version
 
Changed:
<
<


>
>
Describes an ordered list of version ranges to use.
 
Changed:
<
<


>
>
 
Changed:
<
<

max-heap-size

Indicates the maximum size of the Java heap.

>
>
1.0
 
Changed:
<
<
>
>
 
Changed:
<
<

1.0


>
>
yes
 
Changed:
<
<
>
>
 
Changed:
<
<

jar


>
>
 
Changed:
<
<
>
>
href
 
Changed:
<
<

Specifies a JAR file that is part of the application's classpath.

>
>

The URL denoting the supplier of this version of java, and where it may be downloaded from.

 
Added:
>
>
 
Changed:
<
<

1.0

>
>
1.0
 

Deleted:
<
<

yes

 
Changed:
<
<


>
>
 
Changed:
<
<

href

>
>
 
Added:
>
>

java-vm-args

 
Added:
>
>
 
Deleted:
<
<

The URL of the jar file.

 
Changed:
<
<

1.0

>
>
Indicates an additional set of standard and non-standard virtual machine arguments that the application would prefer the JNLP
 
Changed:
<
<

yes

>
>
Client to use when launching Java.
 
Changed:
<
<


>
>
1.0
 
Changed:
<
<

version

>
>
 
Changed:
<
<

The requested version of the jar file. Requires using the version-based download protocol

1.0

>
>
 
Changed:
<
<
>
>
initial-heap-size
 
Changed:
<
<



>
>
Indicates the initial size of the Java heap.
 
Changed:
<
<

>
>
1.0
 
Changed:
<
<

main

Indicates if this jar contains the class containing the main method of the application.

>
>
 
Changed:
<
<

1.0


>
>
 
Changed:
<
<


download

>
>

max-heap-size

Indicates the maximum size of the Java heap.

 
Deleted:
<
<

Can be used to indicate this jar may be downloaded lazily, or when needed.

 
Added:
>
>
 
Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Deleted:
<
<

 
Added:
>
>
 
Deleted:
<
<


 
Changed:
<
<
>
>

jar

 
Deleted:
<
<

size

 
Added:
>
>
 
Deleted:
<
<

Indicates the downloadable size of the jar file in bytes.

 
Changed:
<
<

1.0

>
>
Specifies a JAR file that is part of the application's classpath.
 
Added:
>
>
1.0
 
Added:
>
>
 
Deleted:
<
<


 
Changed:
<
<


>
>
yes
 
Changed:
<
<

part

>
>
 
Changed:
<
<

Can be used to group resources together so they will be downloaded at the same time.

>
>

href

The URL of the jar file.

 

Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0

yes

 
Deleted:
<
<

nativelib

 

Changed:
<
<


>
>
version
 

Deleted:
<
<

Specifies a JAR file that contains native libraries in it's root directory.

 
Changed:
<
<

1.0


>
>
The requested version of the jar file. Requires using the version-based download protocol
 
Changed:
<
<

>
>
1.0
 
Changed:
<
<


>
>
 
Changed:
<
<

href

>
>

 
Changed:
<
<

The URL of the jar file.

>
>
main

Indicates if this jar contains the class containing the main method of the application.

 
Added:
>
>
 
Deleted:
<
<

1.0

 
Changed:
<
<

yes

>
>
1.0
 
Changed:
<
<


>
>
 
Changed:
<
<

>
>
 
Changed:
<
<

version

>
>

download

 
Added:
>
>
 
Deleted:
<
<

The requested version of the jar file. Requires using the version-based download protocol

 
Changed:
<
<

1.0

>
>
Can be used to indicate this jar may be downloaded lazily, or when needed.
 
Changed:
<
<


>
>
1.0
 
Changed:
<
<
>
>
 
Changed:
<
<


download

>
>
 
Changed:
<
<

Can be used to indicate this jar may be downloaded lazily.

>
>
size
 
Added:
>
>
Indicates the downloadable size of the jar file in bytes.
 
Added:
>
>
 
Deleted:
<
<

1.0


 
Changed:
<
<

>
>
1.0
 
Changed:
<
<


>
>
 
Changed:
<
<

size

>
>
 
Changed:
<
<

Indicates the downloadable size of the jar file in bytes.

1.0

>
>
 
Changed:
<
<
>
>
 
Changed:
<
<


>
>
part
 
Deleted:
<
<


 
Deleted:
<
<

part

 
Changed:
<
<

Can be used to group resources together so they will be downloaded at the same time.

>
>
Can be used to group resources together so they will be downloaded at the same time.
 

Deleted:
<
<

1.0


 
Changed:
<
<

extension


>
>
1.0
 
Changed:
<
<

Contains pointer to an additional component-desc or installer-desc to be used with this application.

1.0

>
>
 
Changed:
<
<


>
>
 
Changed:
<
<

>
>
nativelib
 
Deleted:
<
<


 
Deleted:
<
<
 
Deleted:
<
<

href

 
Added:
>
>
 
Deleted:
<
<

The URL to the additional extension jnlp file.

 
Changed:
<
<

1.0

>
>
Specifies a JAR file that contains native libraries in it's root directory.
 
Changed:
<
<

yes

>
>
1.0

 
Deleted:
<
<
 
Deleted:
<
<


 
Changed:
<
<

version

>
>
 
Changed:
<
<

The version of the additional extension jnlp file.

>
>
href
 
Changed:
<
<

1.0

>
>
The URL of the jar file.
 
Changed:
<
<


>
>
1.0
 
Changed:
<
<
>
>
 
Changed:
<
<


name

>
>
yes
 
Changed:
<
<

The name of the additional extension jnlp file

>
>

 
Added:
>
>
version

The requested version of the jar file. Requires using the version-based download protocol

 
Added:
>
>
 
Deleted:
<
<

1.0


 
Changed:
<
<

>
>
1.0
 
Changed:
<
<

ext-download

>
>
 
Changed:
<
<


>
>
 
Changed:
<
<

Can be used in an extension element to denote the parts contained in a component-extension.

1.0

>
>
 
Changed:
<
<
>
>
 
Changed:
<
<


>
>
download
 
Deleted:
<
<


 
Deleted:
<
<

ext-part

 
Deleted:
<
<

Describes the name of a part that can be expected to be found in the extension.

 
Changed:
<
<

1.0

yes

>
>
Can be used to indicate this jar may be downloaded lazily.
 
Changed:
<
<
>
>

1.0

 
Deleted:
<
<


download

 
Changed:
<
<
>
>

size

Indicates the downloadable size of the jar file in bytes.

1.0

 
Deleted:
<
<

Can be used to indicate this extension may be downloaded eagerly or lazily.

1.0

 
Added:
>
>
 
Changed:
<
<


>
>
 
Changed:
<
<


>
>
 
Changed:
<
<

part

>
>
part
 
Added:
>
>
Can be used to group resources together so they will be downloaded at the same time.
 
Deleted:
<
<

Denotes the name of a part in this jnlp file to include the extension in.

 
Deleted:
<
<
 
Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Changed:
<
<

package

>
>
 
Changed:
<
<


>
>

extension

 
Added:
>
>
 
Deleted:
<
<

Can be used to indicate to the JNLP Client which packages are implemented in which JAR files.

 
Changed:
<
<

1.0

>
>
Contains pointer to an additional component-desc or installer-desc to be used with this application.
 
Changed:
<
<


>
>
1.0
 
Changed:
<
<
>
>
 
Changed:
<
<


name

>
>

href

The URL to the additional extension jnlp file.

1.0

yes

 
Deleted:
<
<
 
Changed:
<
<

Package name contained in the jar files of the given part.

>
>

version

 
Added:
>
>
The version of the additional extension jnlp file.
 
Added:
>
>
 
Deleted:
<
<

1.0

yes

 
Changed:
<
<
>
>
1.0
 
Changed:
<
<


part

>
>

 
Added:
>
>
name
 
Added:
>
>
 
Changed:
<
<

Part name containing the jar files that include the given package name.

>
>
The name of the additional extension jnlp file

1.0

 
Changed:
<
<

1.0

>
>

ext-download

Can be used in an extension element to denote the parts contained in a component-extension.

1.0

 

Changed:
<
<

yes


>
>
 
Changed:
<
<
>
>
 
Changed:
<
<

recursive

Can be used to indicated that all package names beginning with the given name, can be found in the given part.

>
>
ext-part

Describes the name of a part that can be expected to be found in the extension.

 

Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0

yes

 
Added:
>
>
 
Deleted:
<
<

property

 
Changed:
<
<


>
>

download

 

Deleted:
<
<

Defines a system property that will be available through the System.getProperty and System.getProperties methods.

 
Changed:
<
<

1.0

>
>
Can be used to indicate this extension may be downloaded eagerly or lazily.

1.0

part

Denotes the name of a part in this jnlp file to include the extension in.

1.0

 
Deleted:
<
<


 
Deleted:
<
<
 
Changed:
<
<


>
>
 
Added:
>
>
package
 
Added:
>
>
 
Deleted:
<
<

name

 
Changed:
<
<

Name of the system property.

>
>
 
Changed:
<
<

1.0

yes

>
>
Can be used to indicate to the JNLP Client which packages are implemented in which JAR files.
 
Changed:
<
<
>
>
1.0

 
Deleted:
<
<
 
Changed:
<
<


>
>

name

Package name contained in the jar files of the given part.

1.0

yes

 
Deleted:
<
<

value

 
Changed:
<
<
>
>

part

 
Changed:
<
<

Value it will be set to.

1.0

>
>

Part name containing the jar files that include the given package name.

1.0

 
Added:
>
>
 
Changed:
<
<

yes


>
>
yes
 

Changed:
<
<



>
>
recursive

Can be used to indicated that all package names beginning with the given name, can be found in the given part.

 

Changed:
<
<

1.0


>
>
1.0
 
Changed:
<
<
>
>
 
Changed:
<
<



>
>

property

 
Added:
>
>
 
Changed:
<
<

Note: A jnlp file must contain one of application-desc, applet-desc, component-desc, or installer-desc

>
>
Defines a system property that will be available through the System.getProperty and System.getProperties methods.
 
Added:
>
>
 
Deleted:
<
<

1.0

 
Changed:
<
<

yes

>
>
1.0
 
Changed:
<
<

applicaation-desc

>
>
 
Changed:
<
<


>
>

 
Changed:
<
<

>
>
name
 
Added:
>
>
 
Deleted:
<
<

Denotes this is the jnlp file for an application.

 
Added:
>
>
Name of the system property.
 
Added:
>
>
 
Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Changed:
<
<


>
>
yes
 
Changed:
<
<

main-class

>
>

value

 
Added:
>
>
 
Deleted:
<
<

The name of the class containing the public static void main(String[]) method of the application.

 
Changed:
<
<

1.0

>
>
Value it will be set to.
 
Changed:
<
<

yes

>
>
1.0
 
Changed:
<
<

argument

>
>
yes
 
Added:
>
>
 
Changed:
<
<


Each argument contains (in order) an additional argument to be passed to main.

>
>
 

Deleted:
<
<

1.0


 
Changed:
<
<
>
>
1.0

 
Added:
>
>
 
Deleted:
<
<

applet-desc


 
Changed:
<
<
>
>
 
Changed:
<
<

Denotes this is the jnlp file for an applet.

1.0

>
>

Note: A jnlp file must contain one of application-desc, applet-desc, component-desc, or installer-desc

1.0

yes

applicaation-desc

Denotes this is the jnlp file for an application.

1.0

 

Deleted:
<
<


 
Deleted:
<
<


 
Changed:
<
<

>
>
 
Changed:
<
<

main-class

This is the name of the main Applet class.

>
>
 
Changed:
<
<

1.0

>
>
main-class
 
Added:
>
>

The name of the class containing the public static void main(String[]) method of the application.

1.0

 
Added:
>
>
 
Deleted:
<
<

yes

 
Changed:
<
<


>
>
yes
 
Changed:
<
<

documentbase

>
>
argument

Each argument contains (in order) an additional argument to be passed to main.

 
Deleted:
<
<

The document base for the Applet as a URL.

 

Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Added:
>
>
 
Changed:
<
<


>
>

applet-desc

 
Deleted:
<
<

name

 

Deleted:
<
<

Name of the Applet.

 
Added:
>
>
Denotes this is the jnlp file for an applet.

1.0

 
Changed:
<
<

1.0

>
>
 
Deleted:
<
<

yes

 
Changed:
<
<
>
>
 
Deleted:
<
<


 
Added:
>
>
 
Deleted:
<
<

width

 
Added:
>
>
main-class

This is the name of the main Applet class.

1.0

yes

 
Changed:
<
<

The width of the applet in pixels.

>
>

documentbase

The document base for the Applet as a URL.

 
Added:
>
>
 
Changed:
<
<

1.0

>
>
1.0
 

Changed:
<
<

yes


>
>
 
Changed:
<
<
>
>
 
Changed:
<
<

height

>
>

name

 
Added:
>
>
 
Changed:
<
<

The height of the applet in pixels

>
>
Name of the Applet.

1.0

yes

 
Changed:
<
<

1.0

>
>

 
Added:
>
>
width

The width of the applet in pixels.

1.0

 
Added:
>
>
 
Deleted:
<
<

yes

 
Changed:
<
<

param

>
>
yes
 
Added:
>
>
 
Deleted:
<
<


 
Changed:
<
<

A set of parameters that can be passed into the applet.

>
>
height

The height of the applet in pixels

 

Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Changed:
<
<


>
>

yes

param

 
Deleted:
<
<

name

 

Changed:
<
<

The name of this parameter

>
>
A set of parameters that can be passed into the applet.
 

Deleted:
<
<

1.0

yes

 
Changed:
<
<
>
>
1.0
 
Changed:
<
<


value

>
>
 
Changed:
<
<
>
>
 
Changed:
<
<

The value of this parameter

1.0

>
>
 
Changed:
<
<

yes

component-desc

>
>
name
 
Deleted:
<
<
 
Deleted:
<
<


 
Changed:
<
<

Denotes this is the jnlp file for a component extension.

>
>
The name of this parameter
 

Deleted:
<
<

1.0

 
Changed:
<
<


>
>
1.0
 
Changed:
<
<

installer-desc

>
>
yes

value

 
Deleted:
<
<


 

Deleted:
<
<

Denotes this is the jnlp file for an installed extension.

 
Changed:
<
<

1.0

>
>
The value of this parameter
 
Changed:
<
<


>
>
1.0
 
Added:
>
>
yes
 
Added:
>
>
component-desc
 
Added:
>
>
 
Added:
>
>
Denotes this is the jnlp file for a component extension.
 
Added:
>
>
 
Added:
>
>
1.0
 
Added:
>
>
 
Added:
>
>
 
Changed:
<
<


>
>

installer-desc

 
Deleted:
<
<

main-class

 

Deleted:
<
<

The name of the class containing the public static void main(String[]) method of the installer.

 
Added:
>
>
Denotes this is the jnlp file for an installed extension.
 
Added:
>
>
 
Changed:
<
<

1.0

>
>
1.0
 
Added:
>
>
 
Deleted:
<
<

yes

 
Added:
>
>

main-class

 
Changed:
<
<
>
>

The name of the class containing the public static void main(String[]) method of the installer.

1.0

yes

 

Configure your web server's jnlp Mime type settings.

Line: 2646 to 2022
  If you wish to modify the Apache global TypesConfig file and the file exists in /etc/mime.types, then you might try syntax like the following which will grep for the jnlp entry, and if not found will append an entry for jnlp support.
Changed:
<
<
[joe@webserver /]$ grep -qs 'application/x-java-jnlp-file' /etc/mime.types || echo 'application/x-java-jnlp-file jnlp' >> /etc/mime.types

>
>
[joe@webserver /]$ *grep -qs 'application/x-java-jnlp-file' /etc/mime.types || echo 'application/x-java-jnlp-file jnlp' >> /etc/mime.types*

 [joe@webserver /]$
Changed:
<
<
>
>
 Or, if you wish to modify an .htaccess file in your http://www.example.com/appx/ directory, and your web server is configured to allow .htaccess modifications then try the following syntax which will grep for the jnlp entry, and if not found will append an entry for jnlp support.
Changed:
<
<
[joe@webserver /]$ grep -qs 'application/x-java-jnlp-file' /var/www/html/appx/.htaccess || echo 'AddType application/x-java-jnlp-file jnlp' >> /var/www/html/appx/.htaccess 

>
>
[joe@webserver /]$ *grep -qs 'application/x-java-jnlp-file' /var/www/html/appx/.htaccess || echo 'AddType application/x-java-jnlp-file jnlp' >> /var/www/html/appx/.htaccess* 

 [joe@webserver /]$
Changed:
<
<
>
>
 

Microsoft IIS web server Mime type settings

Windows 2000 IIS Server
Added:
>
>
 Start the IIS Management Console and perform the following steps:
  • Right-click server computer in left pane, then select Properties from the drop-down menu.
  • In the 'Computer MIME Map,' click the [Edit] button.
Line: 2693 to 2069
 That's all there is to publishing APPX Desktop Client utilizing Java Web Start technology.

Troubleshooting tips

  • To clear the Web Start Cache
Changed:
<
<
    • javaws -uninstall This will remove all cached applications.
>
>
    • javaws -uninstall This will remove all cached applications.
 
  • Clear Browser's temporary files.

Bugs:

Changed:
<
<
  1. Fixed - Bug Description 1.
  2. OPEN - Bug test - Test bug. Not valid.
>
>
  1. Fixed - Bug Description 1.
  2. OPEN - Bug test - Test bug. Not valid.
 

Comments:

Added:
>
>
 Read what other users have said about this page or add your own comments.
Line: 2712 to 2087
  -- AlKalter - 26 Mar 2009
Changed:
<
<
The application cannot connect if the user’s browser has a proxy server configured. The browser downloads the “JAR” file without any problem, when I give the user name and password I cannot connect to APPX server. Is there any configuration that can solve this problem?
>
>
The application cannot connect if the user’s browser has a proxy server configured. The browser downloads the “JAR” file without any problem, when I give the user name and password I cannot connect to APPX server. Is there any configuration that can solve this problem?
  -- GerardoLopez - 01 Apr 2009
Deleted:
<
<
<--/commentPlugin-->
-- JoeOrtagus - 04 Mar 2009
 \ No newline at end of file
Added:
>
>
<--/commentPlugin-->
-- JoeOrtagus - 04 Mar 2009
 \ No newline at end of file
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback