Difference: LaunchingAPPXDesktopClientFromWebPageViaJavaWebstart (67 vs. 68)

Revision 682013-02-21 - JoeOrtagus

 			 META TOPICPARENT 
			 name="APPXAdministrator" 
		
 APPX Desktop Client Launched via Java Web Start
- META TOPICPARENT
+ name="APPXAdministrator"
   APPX Desktop Client Launched via Java Web Start 
  Overview
   Required software components 
  APPX Desktop Client Java Web Start Bundle
   Web Server
 
   Quick steps
   Detailed steps 
  Download and place the APPX Desktop Client Java Web Start Bundle. 
  index.html
   appx.jnlp 
  Table of possible element / attribute available in a JNLP file.
 
 
   Configure your web server's jnlp Mime type settings. 
  Apache web server Mime type settings
   Microsoft IIS web server Mime type settings 
  Windows 2000 IIS Server
   Windows Server 2003 and XP IIS Server
   Windows Vista IIS Server
 
 
 
   Troubleshooting tips
   Comments:
 
 

 Overview
-<
<
+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.4 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.2.2. 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 18 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
-<
<
+You can get the APPX Desktop Client Java Web Start Bundle from here for Unix or Linux or here for Windows.
->
>
+You can get the APPX Desktop Client Java Web Start Bundle from here for Unix or Linux or here for Windows.
  APPX Server
-<
<
+[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]$
->
>
+[joe@webserver /]$ *cd /var/www/html* 
[joe@webserver /]$ <strong>sudo wget http://www.appx.com/ftp/appx/products/appx/client/5.2.2/java_web.tgz
</strong>[joe@webserver html]$
  Now let's untar the files
-<
<
+ [joe@webserver html]$ *sudo tar xzvf java_web.tgz*
->
>
+ [joe@webserver html]$ *sudo tar -xzvf java_web.tgz*
-<
<
+ appx/
appx/appx32.gif
appx/README.txt
appx/INSTALL.txt
appx/appx.html
appx/splash.gif
appx/APPXLaunchButton.png
appx/appx-small.png
appx/appx-nativelib.jar
appx/appx.jar
appx/appx.jnlp
->
>
+ appx/
appx/appx.jar
appx/appx32.png
appx/downloadbutton.gif
appx/lib/
appx/lib/ckeditor_linux.jar
appx/lib/ckeditor_win.version
appx/lib/swt_linux_64.version
appx/lib/jsoup.jar
appx/lib/outldd.version
appx/lib/ckeditor_linux.version
appx/lib/ckeditor_win.jar
appx/lib/SyntaxHighlighter.version
appx/lib/capsapi_classes.jar
appx/lib/swt_linux_32.version
appx/lib/swt_linux_64.jar
appx/lib/swt_win_32.version
appx/lib/swt_linux_32.jar
appx/lib/swt_osx_64.version
appx/lib/swt_win_64.jar
appx/lib/DJNativeSwing.jar
appx/lib/swt_osx_64.jar
appx/lib/SyntaxHighlighter.jar
appx/lib/js.jar
appx/lib/swt_osx_32.version
appx/lib/jsoup.version
appx/lib/DJNativeSwing-SWT.jar
appx/lib/appx-nativelib.jar
appx/lib/outldd.jar
appx/lib/swt_osx_32.jar
appx/lib/ckeditor_osx.version
appx/lib/DJNativeSwing.version
appx/lib/swt_win_64.version
appx/lib/swt_win_32.jar
appx/lib/DJNativeSwing-SWT.version
appx/lib/ckeditor_osx.jar
appx/INSTALL.txt
appx/index.html
appx/appx.jnlp
appx/splash.png
appx/appx.css
appx/appx32.gif
appx/appx-small.png
appx/README.txt
appx/arrow.gif
-<
<
+ [joe@webserver html]$ *ls -la*
->
>
+ [joe@webserver html]$ *ls -la*
-<
<
+ 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
->
>
+drwxr-xr-x 3 root root     4096 Feb 21 13:07 appx
-rw-r--r-- 1 root root 17038663 Feb 21 13:20 java_web.tgz
-<
<
+ [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
->
>
+ total 1372
drwxr-xr-x 3 root root    4096 Feb 21 13:07 .
drwxr-xr-x 3 root root    4096 Feb 21 13:20 ..
-r-xr-xr-x 1 root root     139 Jan  9 10:07 appx32.gif
-r-xr-xr-x 1 root root    3688 Jan 14 15:23 appx32.png
-r-xr-xr-x 1 root root    4342 Feb 21 12:41 appx.css
-r-xr-xr-x 1 root root 1314083 Jan 10 17:22 appx.jar
-r-xr-xr-x 1 root root    5732 Feb 21 13:04 appx.jnlp
-r-xr-xr-x 1 root root   16233 Jan  9 10:07 appx-small.png
-r-xr-xr-x 1 root root    2073 Jan 14 15:29 arrow.gif
-r-xr-xr-x 1 root root     708 Jan  9 10:07 downloadbutton.gif
-r-xr-xr-x 1 root root    3514 Feb 21 12:54 index.html
-r-xr-xr-x 1 root root      15 Jan  9 10:07 INSTALL.txt
dr-xr-xr-x 2 root root    4096 Feb 21 12:58 lib
-r-xr-xr-x 1 root root     369 Feb 21 13:07 README.txt
-r-xr-xr-x 1 root root   15402 Jan  9 10:07 splash.png
  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.
->
>
+ appx32.png 

The appx32.png file is the file used in a popup in the index.html file that we review later in this document.
 appx.css 

The appx.css contains css formatting and is referenced in the index.html file that we review later in this document.
  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";
->
>
+Place these files on your web server.
->
>
+You need to change one item, replace appxjwsclient.example.com with the hostname and URL to the location of your files.
 In appx.jnlp:
-<
<
+appx.jnlp: --->  

Please see our Wiki at http://wiki.appx.com/wiki/bin/view/Main/LaunchingAPPXDesktopClientFromWebPageViaJavaWebstart for further documentation.
->
>
+    codebase="http://appxjwsclient.example.com/"
-<
<
+ INSTALL.txt
->
>
+Please see our Wiki at http://wiki.appx.com/wiki/bin/view/Main/LaunchingAPPXDesktopClientFromWebPageViaJavaWebstart for further documentation.
-<
<
+INSTALL.txt points the reader to README.txt
  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.
  [joe@webserver appx]$ *cat appx.jnlp*
 
  <?xml version="1.0" encoding="utf-8"?>
-<
<
+<-- JNLP File for APPX Desktop Client 5.0.4 -->
 <-- JNLP File for APPX Desktop Client  -->
-<
<
+<-- example JNLP file that will launch the APPX Desktop Client 5.0.4 -->

<-- where the jnlp file lives on the web -->
->
>
+<jnlp
  spec="6.0+"
  codebase="http://appxjwsclient.example.com/"
  href="appx.jnlp">
-<
<
+      APPX Desktop Client  Java Web Start Demo Application
->
>
+    APPX
       APPX Software, Inc.
-<
<
+      APPX Desktop Client version 5.0.4.
      Connects to APPX Client Login Manager.
      <-- hover help for this app.  -->
      APPX Desktop Client 5.0.4
      <-- This is the APPX Desktop Client application icon and splash screen. -->
      <-- relative to codebase -->
->
>
+    APPX
    APPX
    APPX 5.2.2 via JWS
-<
<
+      <-- allow app to run without Internet access -->
      <offline-allowed />
->
>
+<--    <offline-allowed/> -->
-<
<
+   <-- The APPX Desktop Client requires the all-permissions value for the security element -->
       <all-permissions />
-<
<
+      <-- Acceptable JVMs in preferred order, best first -->
      <-- Sun JVM -->
->
>
-<
<
+      <-- This swing.noxp value prevents a "look and feel" issue on Vista -->
-<
<
+      <-- application code, load before launch. JNLP 1.6 main="true" indicates jar with main class -->
->
>
-<
<
+   <-- application class with main method -->
   <-- This is the section where you would add startup parameters for the APPX -->
   <-- Desktop Client.  Items such as TCP port number, initial window size etc -->
    <application-desc main-class="start.Appx">
-<
<
+      <-- command line arguments -->
      -windowTitle=APPX - $(host):$(port)
      -remotePort=8064
      -remoteUser=prospect
      -remoteHost=demo.appx.com
      -remotePassword=prospect
      -screenRows=28
      -screenColumns=110
      -SSLMode=disabled
->
>
+    -windowTitle=APPX Desktop JWS Client - $(host):$(port) PID:$(pid)
    -resizeMainWindowPane=true
    <-- -screenRows=35 -->
    <-- -screenColumns=128 -->
    <-- -remotePort=1 -->
    <-- -remoteHost=www.example.com -->
    <-- -rows=28 -->
    <-- -cols=110 -->
    <-- -useScrollNavBar=true -->
    <-- -arrowScrollRegion=true -->
    <-- -dockingScrollbar=false -->
    </application-desc>
->
>
 [joe@webserver appx]$
  appx.jnlp modifications 

You should change the following URL value in your appx.jnlp file to match your site.
-<
<
+          codebase=" http://www.example.com/appx " href="appx.jnlp"
->
>
+codebase="http://appxjwsclient.example.com/"
 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.

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