Difference: LaunchingAPPXDesktopClientFromWebPageViaJavaWebstart (65 vs. 66)

Revision 662012-03-27 - ChrisBrower

Line: 1 to 1

META TOPICPARENT	name="APPXAdministrator"

APPX Desktop Client Launched via Java Web Start

Line: 43 to 43

Changed:

<
<

[joe@webserver /]$ cd /var/www/html 
[joe@webserver /]$ sudo wget http://www.appx.com/ftp/appx/products/appx/client/5.0.4/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/java_web.tgz*

[joe@webserver html]$

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*

appx/

Line: 66 to 66

appx/appx.jnlp

Changed:

<
<

[joe@webserver html]$ ls -la

>
>

[joe@webserver html]$ *ls -la*

total 1216

Line: 76 to 76

-rw-r--r-- 1 root root 1233805 Mar 4 14:27 java_web.tgz

Changed:

<
<

[joe@webserver html]$ cd appx
[joe@webserver appx]$ ls

>
>

[joe@webserver html]$ *cd appx*
[joe@webserver appx]$ *ls*

appx32.gif  appx.html  appx.jar  appx.jnlp  APPXLaunchButton.png appx-small.png appx-nativelib.jar  INSTALL.txt  README.txt  splash.gif

Line: 114 to 114

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*

Line: 171 to 171

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

Changed:

<
<

APPXLaunchButton.png

>
>

APPXLaunchButton.png

Changed:

<
<

APPXLaunchButton.png is an image file that is displayed for the user to click to begin the JRE detection and ultimately start the APPX Desktop Client.

>
>

APPXLaunchButton.png is an image file that is displayed for the user to click to begin the JRE detection and ultimately start the APPX Desktop Client.

appx-nativelib.jar

The appx-nativelib.jar file contains platform specific files for the proper execution of the appx.jar file.

Line: 185 to 185

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*

<?xml version="1.0" encoding="utf-8"?>
<!-- JNLP File for APPX Desktop Client 5.0.4 -->

Line: 255 to 255

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.

Deleted:

<
<

Changed:

<
<

>
>

Element

Attributes

Changed:

<
<

>
>

Description

Line: 277 to 272

Required

Changed:

<
<

>
>

jnlp

Changed:

<
<

>
>

Changed:

<
<

>
>

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

Line: 301 to 290

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.

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

codebase

Changed:

<
<

>
>

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

Changed:

<
<

>
>

href

Changed:

<
<

>
>

The href specifies the URL of the JNLP file itself.

Line: 356 to 329

1.0

Changed:

<
<

>
>

Line: 383 to 354

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

Changed:

<
<

>
>

1.0

yes

Changed:

<
<

>
>

Line: 410 to 375

Changed:

<
<

>
>

Changed:

<
<

>
>

arch

Line: 430 to 391

Changed:

<
<

>
>

platform

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

Changed:

<
<

>
>

1.5.0

Changed:

<
<

>
>

locale

Changed:

<
<

>
>

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

Line: 488 to 439

The vendor element specifies the provider of the application.

Changed:

<
<

>
>

1.0

yes

Changed:

<
<

>
>

homepage

Changed:

<
<

>
>

The homepage of the application.

Line: 524 to 467

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

Changed:

<
<

>
>

1.0

yes

Changed:

<
<

>
>

description

Changed:

<
<

>
>

A short statement describing the application.

Line: 558 to 495

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

icon

Changed:

<
<

>
>

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

Line: 590 to 521

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

Changed:

<
<

>
>

1.0

yes

Changed:

<
<

>
>

kind

Changed:

<
<

>
>

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

width

Changed:

<
<

>
>

Can be used to indicate the resolution of the image.

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

height

Changed:

<
<

>
>

Can be used to indicate the resolution of the image.

Line: 663 to 576

Can be used to indicate the resolution of the image.

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

offline-allowed

Changed:

<
<

>
>

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

Line: 690 to 597

shortcut

Changed:

<
<

>
>

Line: 703 to 608

Changed:

<
<

>
>

Line: 713 to 616

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

Changed:

<
<

>
>

1.5.0

Changed:

<
<

>
>

desktop

Changed:

<
<

>
>

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

Line: 753 to 650

Changed:

<
<

>
>

Line: 764 to 659

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

Changed:

<
<

>
>

1.5.0

Changed:

<
<

>
>

Changed:

<
<

>
>

association

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.

Line: 792 to 679

1.5.0

Changed:

<
<

>
>

Line: 807 to 692

1.5.0

Changed:

<
<

>
>

Line: 820 to 703

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

Changed:

<
<

>
>

1.5.0

Changed:

<
<

>
>

related-content

Changed:

<
<

>
>

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

1.5.0

Changed:

<
<

>
>

Line: 864 to 737

yes

Changed:

<
<

>
>

Line: 876 to 747

Changed:

<
<

>
>

update

Line: 895 to 762

Changed:

<
<

>
>

check

Line: 910 to 775

Changed:

<
<

>
>

Line: 921 to 784

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.

Changed:

<
<

>
>

1.6.0

Changed:

<
<

>
>

Changed:

<
<

>
>

Line: 947 to 804

security

Changed:

<
<

>
>

Line: 960 to 815

Changed:

<
<

>
>

all-permissions

Line: 976 to 829

1.0

Changed:

<
<

>
>

j2ee-application-client-permissions

Line: 989 to 840

1.0

Changed:

<
<

>
>

Line: 999 to 848

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

resources

Changed:

<
<

>
>

Describes all the resources that are needed for an application.

1.0

Changed:

<
<

>
>

yes

Line: 1038 to 877

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

Changed:

<
<

>
>

arch

Changed:

<
<

>
>

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

Line: 1073 to 904

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

Changed:

<
<

>
>

Changed:

<
<

>
>

java (or java se)

Changed:

<
<

>
>

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

1.6.0 (java)

Changed:

<
<

>
>

Changed:

<
<

>
>

version

Line: 1116 to 937

yes

Changed:

<
<

>
>

Line: 1127 to 946

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

Changed:

<
<

>
>

java-vm-args

Changed:

<
<

>
>

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

Line: 1178 to 989

Indicates the maximum size of the Java heap.

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

jar

Changed:

<
<

>
>

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

1.0

Changed:

<
<

>
>

yes

Line: 1217 to 1018

The URL of the jar file.

Changed:

<
<

>
>

1.0

yes

Changed:

<
<

>
>

Changed:

<
<

>
>

version

Changed:

<
<

>
>

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

Line: 1253 to 1046

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

download

Changed:

<
<

>
>

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

Line: 1285 to 1072

Indicates the downloadable size of the jar file in bytes.

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

part

Changed:

<
<

>
>

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

nativelib

Changed:

<
<

>
>

Changed:

<
<

>
>

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

Line: 1331 to 1104

1.0

Changed:

<
<

>
>

Line: 1357 to 1128

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

download

Changed:

<
<

>
>

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

Line: 1383 to 1148

1.0

Changed:

<
<

>
>

Line: 1398 to 1161

1.0

Changed:

<
<

>
>

Line: 1410 to 1171

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

extension

Changed:

<
<

>
>

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

Line: 1450 to 1205

yes

Changed:

<
<

>
>

Line: 1461 to 1214

The version of the additional extension jnlp file.

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

name

Changed:

<
<

>
>

The name of the additional extension jnlp file

Line: 1487 to 1234

1.0

Changed:

<
<

>
>

ext-download

Line: 1501 to 1246

1.0

Changed:

<
<

>
>

Line: 1513 to 1256

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

Changed:

<
<

>
>

1.0

yes

Changed:

<
<

>
>

download

Changed:

<
<

>
>

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

Line: 1555 to 1290

1.0

Changed:

<
<

>
>

package

Changed:

<
<

>
>

Line: 1573 to 1304

Changed:

<
<

>
>

Line: 1591 to 1320

yes

Changed:

<
<

>
>

Line: 1605 to 1332

1.0

Changed:

<
<

>
>

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

Changed:

<
<

>
>

property

Changed:

<
<

>
>

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

name

Changed:

<
<

>
>

Name of the system property.

Changed:

<
<

>
>

1.0

yes

Changed:

<
<

>
>

value

Changed:

<
<

>
>

Value it will be set to.

Line: 1690 to 1395

yes

Changed:

<
<

>
>

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

Line: 1735 to 1432

1.0

Changed:

<
<

>
>

Changed:

<
<

>
>

Line: 1753 to 1446

1.0

Changed:

<
<

>
>

yes

Line: 1768 to 1459

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

applet-desc

Changed:

<
<

>
>

Denotes this is the jnlp file for an applet.

1.0

Changed:

<
<

>
>

Changed:

<
<

>
>

main-class

Line: 1814 to 1493

yes

Changed:

<
<

>
>

Line: 1825 to 1502

The document base for the Applet as a URL.

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

Changed:

<
<

>
>

name

Changed:

<
<

>
>

Name of the Applet.

Line: 1854 to 1523

yes

Changed:

<
<

>
>

Line: 1868 to 1535

1.0

Changed:

<
<

>
>

yes

Changed:

<
<

>
>

height

The height of the applet in pixels

Changed:

<
<

>
>

1.0

yes

Changed:

<
<

>
>

param

Changed:

<
<

>
>

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

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

name

Changed:

<
<

>
>

The name of this parameter

Changed:

<
<

>
>

1.0

yes

Changed:

<
<

>
>

value

Changed:

<
<

>
>

The value of this parameter

Line: 1960 to 1605

Denotes this is the jnlp file for a component extension.

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

installer-desc

Changed:

<
<

>
>

Denotes this is the jnlp file for an installed extension.

Changed:

<
<

>
>

1.0

Changed:

<
<

>
>

Changed:

<
<

>
>

main-class

Changed:

<
<

>
>

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

Line: 2010 to 1641

yes

Changed:

<
<

>
>

Configure your web server's jnlp Mime type settings.

Line: 2023 to 1652

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 /]$

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 /]$

Line: 2084 to 1712

-- RogerHuffman - 26 Mar 2009

Changed:

<
<

You should be able to use WinRAR to unzip a tgz file on Windows. WinRAR is a free download, available at http://download.cnet.com/WinRAR/3000-2250_4-10007677.html

, and other places as well. But your point is a good one, and we'll probably add a zip file version shortly.

>
>

You should be able to use WinRAR to unzip a tgz file on Windows. WinRAR is a free download, available at http://download.cnet.com/WinRAR/3000-2250_4-10007677.html

, and other places as well. But your point is a good one, and we'll probably add a zip file version shortly.

-- AlKalter - 26 Mar 2009

View topic | History: r73 < r72 < r71 < r70 | More topic actions...