Difference: LaunchingAPPXDesktopClientFromWebPageViaJavaWebstart (68 vs. 69)

Revision 692016-02-11 - JeanNeron

 			 META TOPICPARENT 
			 name="APPXAdministrator" 
		
 APPX Desktop Client Launched via Java Web Start
- META TOPICPARENT
+ name="APPXAdministrator"
  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 the Desktop Downloads page.
  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.
->
>
+You need a functioning APPX installation. Follow the installation instructions for the release to install APPX.
  Web Server 

You need a functioning web server configured with jnlp mime type support. Apache and IIS are two common servers.
  APPX Server
-<
<
+Install APPX Server. No special configuration is needed in the APPX Server for APPX Desktop Client connectivity when launched via Java Web Start, just make sure you have an APPX Client Manager ( Unix or Linux or Windows) listening and accepting logins.
->
>
+Install the APPX Server. No special configuration is needed in the APPX Server for APPX Desktop Client connectivity when launched via Java Web Start, just make sure you have an APPX Client Manager ( Unix or Linux or Windows) listening and accepting logins.
  Detailed steps
-<
<
+Here are the steps I used to load the APPX Desktop Client via Java Web Start. These instructions assume that you already have a working installation of APPX Server that is configured with a Client Manager (Unix or Linux or Windows) and accepting logins. You must also have a web server installed and started.
->
>
+Here are the steps I used to load the APPX Desktop Client via Java Web Start. These instructions assume that you already have a working installation of APPX Server that is configured with a Client Manager ( Unix or Linux or Windows) and accepting logins. You must also have a web server installed and started.
  Download and place the APPX Desktop Client Java Web Start Bundle.
-<
<
+For a Windows Web Server, download the Java Web Start Bundle from here. For my Linux/Unix server I downloaded version 5.0.4 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.
->
>
+For a Windows Web Server, download the Java Web Start Bundle and place the bundle in a directory off of your web server's web root. Extract the files using the appropriate command (tar or zip).
-<
<
+ I am going to use the command line tool wget to fetch the file bundle:
 



[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*
 

 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*
 

 total 1216
drwxr-xr-x  3 root root    4096 Mar  4 14:27 .
drwxr-xr-x 10 root root    4096 Jun 26  2007 ..
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*
 

 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
->
>
+<span style="color: #630000; font-size: 17.29px; font-weight: bold; line-height: 1em; font-family: Verdana, Arial, Helvetica, sans-serif; background-color: transparent;">APPX Desktop Client Web Start Bundle Components</span>
  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.
 README.txt contains the following very brief instructions to the reader.
-<
<
->
>
 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.
 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
-<
<
+ [joe@webserver appx]$ *cat appx.html*
->
>
+ [joe@webserver appx]$ *cat appx.html*
-<
<
->
>
       APPX Desktop Client Web Start
-<
<
+[joe@webserver appx]$
->
>
+[joe@webserver appx]$
  appx.html modifications 

You should change the following two URL values in your appx.html file to match your site.
-<
<
+          var url = " http://www.example.com/appx/appx.jnlp ";
->
>
+          var url = " http://www.example.com/appx/appx.jnlp ";
          deployJava.launchButtonPNG = "  ";
 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
-<
<
+ [joe@webserver appx]$ *cat appx.jnlp*
->
>
+ [joe@webserver appx]$ *cat appx.jnlp*
 <-- JNLP File for APPX Desktop Client -->
<jnlp
-<
<
+[joe@webserver appx]$
->
>
+[joe@webserver appx]$
  appx.jnlp modifications 

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

 Table of possible element / attribute available to you in a JNLP file.
-<
<
->
>
 Element
 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.
-<
<
+ [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.
-<
<
+ [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 /]$
  To clear the Web Start Cache  
 javaws -uninstall This will remove all cached applications.
 
  Clear Browser's temporary files.
-<
<
+ Bugs: 
 
 Fixed - Bug Description 1. 
  OPEN -  Bug test - Test bug. Not valid. 
 
 Comments:
->
>
+ Comments:
 Read what other users have said about this page or add your own comments.
-<
<
+Is there a .zip version of java_web.tgz? Or something that Windows Vista knows how to uncompress?

-- RogerHuffman - 26 Mar 2009

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

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
   (Edit - Preview)
 
<--/commentPlugin-->
 -- JoeOrtagus - 04 Mar 2009

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