Difference: LaunchingAPPXDesktopClientFromWebPageViaJavaWebstart (42 vs. 43)

Revision 432009-03-16 - JoeOrtagus

Line: 1 to 1

META TOPICPARENT	name="APPXAdministrator"

APPX Desktop Client Launched via Java Web Start

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

Line: 7 to 7

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.

Required software components

APPX Desktop Client Java Web Start Bundle

Changed:

<
<

You can get the APPX Desktop Client Java Web Start Bundle from here coming soon!

>
>

You can get the APPX Desktop Client Java Web Start Bundle from here

APPX Server

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

Line: 47 to 47

Changed:

<
<

[joe@webserver html]$ sudo tar xzvpf appx.tgz

>
>

[joe@webserver html]$ sudo tar xzvf java_web.tgz

Line: 55 to 55

appx/
appx/appx32.gif

Added:

>
>

appx/README.txt appx/INSTALL.txt

appx/appx.html appx/splash.gif

Added:

>
>

appx/APPXLaunchButton.png

appx/appx-nativelib.jar appx/appx.jar appx/appx.jnlp

Line: 75 to 78

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

Changed:

<
<

-rw-r--r-- 1 root root 1212317 Mar 4 14:27 appx.tgz

>
>

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

Line: 88 to 91

Changed:

<
<

appx32.gif appx.html appx.jar appx.jnlp appx-nativelib.jar 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

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.

Deleted:

<
<

appx.jar

The APPX Desktop Client in Java jar format.

appx.jpg

appx-nativelib.jar

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

appx.html

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

Line: 120 to 118

Deleted:

<
<

Line: 162 to 159

Added:

>
>

appx.jar

The APPX Desktop Client in Java jar format.

appx.jnlp

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

Line: 2600 to 2599

Added:

>
>

APPXLaunchButton.png

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.

INSTALL.txt

INSTALL.txt points the reader to README.txt

README.txt

README.txt contains the following very brief instructions to the reader.

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:

In appx.html
appx.html: ---> var url = "http://www.example.com/appx/appx.jnlp";
appx.html: ---> deployJava.launchButtonPNG = "http://www.example.com/appx/APPXLaunchButton.png";


In appx.jnlp:
appx.jnlp: ---> <jnlp spec="1.5+" codebase="http://www.example.com/appx" href="appx.jnlp" version ="5.0.0.a9"> 

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

splash.gif

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

appx.html

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