root/main/trunk/gli/README_WebGLI.txt @ 32138

Revision 32138, 4.6 KB (checked in by ak19, 22 months ago)

New class WebGatherer?.java to replace GathererApplet?.java in JNLP use with Java Web Start. At present it's still an Applet, but now the opening button marked GLI is gone and the dialog requesting the gliserver.pl URL appears immediately instead.

Line 
1--------------------------
2README
3--------------------------
4Java Web Start version of GLI applet using our new JNLP file
5
61. Follow the instructions at http://wiki.greenstone.org/doku.php?id=en:release:3.08_release_notes#setting_up_a_remote_greenstone_3_server for setting up the Remote GS Server and the GLI applet. This will have generated SignedGatherer.jar in the gli folder.
72. Move the SignedGatherer.jar and the GLIapplet.jnlp JNLP file into GS3's web/applet folder. Edit GLIapplet.jnlp if necessary.
83. Need to associate JNLP files with Java Web Start (jre/bin/javaws). On Windows, create the association in the usual way. For Linux, create a file with .desktop extension (e.g. javawebstart.desktop) containing the content a little further below. Then put the *.desktop file into ~/.local/share/applications
94. Launch the Java Control Panel (jre/bin/javaclp.exe on Windows, ./.../jre/bin/ControlPanel on Linux). Go to the Security tab, set Security level to "High" if not already set. Click Edit Site List, and then press Add to add the host:port that the GS3 will run on.
105. Once the GS3 code is compiled up, start up the GS3 web server and visit http://localhost:8383/greenstone3/library?a=p&sa=gli4gs3
11In the current version of the code, the GLI applet will load if the browser still supports applets. Otherwise, the fallback text will appear and provide a link to the GLIapplet.jnlp file. Since you should have set up the jnlp file association in step 3 above, you can now click on the GLIapplet.jnlp link and it should first download the jnlp file to a temporary user area (C:\Users\<user>\AppData\Local\Temp on windows) and then Java Web Start will be used to launch this JNLP file.
126. After authorising the GLI to run, the JNLP version of the GLI Applet will eventually run and behave like the usual client-GLI/GLI applet from this point onward.
13
14--------------------------
15FILE: javawebstart.desktop
16--------------------------
17   
18    # This file makes Ubuntu associate .jnlp files with Java Web Start (javaws)
19    # This file should be adjusted and then copied into ~/.local/share/applications
20    # as a file with .desktop extension, e.g. javawebstart.desktop
21    # https://askubuntu.com/questions/235861/how-to-associate-jnlp-file-with-javaws
22    [Desktop Entry]
23    Encoding=UTF-8
24    Name=Java 7 Web Start
25    Comment=Java 7 Web Start
26    Exec=/home/greenstone/Desktop/linux/jre/bin/javaws %u
27    Terminal=false
28    Type=Application
29    Icon=javaws
30    Categories=Application;Network;
31    MimeType=application/x-java-jnlp-file;
32
33--------------------------
34LINKS
35--------------------------
36Reading on Java Web Start and Java Native Launch protocol (JNLP). The relationship between Java Web Start and JNLP:
37https://docs.oracle.com/cd/E84882_01/otn/pdf/E84699_01.pdf
38"Java Web Start is a technology that builds on the file association facilities of browsers through the use of Java Native Launch Protocol."
39 
40
41Google search: Migrate Java 1.9 webstart
42
43https://docs.oracle.com/javase/9/whatsnew/toc.htm
44https://docs.oracle.com/javase/9/deploy/migrating-java-applets-jnlp.htm
45https://docs.oracle.com/javase/9/deploy/self-contained-application-packaging.htm
46http://www.oracle.com/technetwork/java/javase/migratingfromapplets-2872444.pdf
47https://docs.oracle.com/javase/8/docs/technotes/guides/deploy/applet_dev_guide.html
48https://dzone.com/articles/java-web-start-jnlp-hello
49
50https://docs.oracle.com/javase/tutorial/uiswing/examples/misc/index.html
51https://bugs.openjdk.java.net/browse/JDK-8178799
52https://www.v3.co.uk/v3-uk/news/2443810/oracle-signals-the-end-of-java-applet-support-for-browsers
53https://schneide.wordpress.com/2016/10/11/the-migration-path-for-java-applets/
54https://docs.oracle.com/javase/9/deploy/jnlp-file-syntax.htm
55https://docs.oracle.com/javase/tutorial/deployment/deploymentInDepth/embeddingJNLPFileInWebPage.html
56https://stackoverflow.com/questions/7313317/jnlp-as-a-applet-in-html-page
57
58https://stackoverflow.com/questions/17338711/jarsigner-manifest-permissions
59https://stackoverflow.com/questions/19659134/how-do-i-fix-missing-codebase-permissions-and-application-name-manifest-attri
60https://docs.oracle.com/javase/7/docs/technotes/guides/jweb/security/manifest.html#codebase
61https://docs.oracle.com/javase/tutorial/deployment/jar/modman.html
62https://docs.oracle.com/javase/tutorial/deployment/jar/build.html
63https://stackoverflow.com/questions/18907695/ioexception-invalid-header-field-when-creating-jar-file-with-manifest
64https://docs.oracle.com/javase/tutorial/deployment/jar/manifestindex.html
65https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#JARManifest
66https://community.oracle.com/thread/1536875?start=0
Note: See TracBrowser for help on using the browser.