source: main/trunk/gli/README_WebGLI.txt@ 32136

Last change on this file since 32136 was 32136, checked in by ak19, 6 years ago

Committing the first checkpoint of getting the GLIApplet to work with Java Web Start/JNLP, along with the important gli\README_WebGLI.txt with instructions. This commit uses the Java Web Start as fallback if the GLI applet can't be displayed. Some strings are hardcoded in the version of the gli\GLIApplet.jnlp file at this point.

File size: 4.7 KB
RevLine 
[32136]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-----------
15# javawebstart.desktop
16# This file makes Ubuntu associate .jnlp files with Java Web Start (javaws)
17# This file should be adjusted and then copied into ~/.local/share/applications
18# as a file with .desktop extension, e.g. javawebstart.desktop
19# https://askubuntu.com/questions/235861/how-to-associate-jnlp-file-with-javaws
20[Desktop Entry]
21Encoding=UTF-8
22Name=Java 7 Web Start
23Comment=Java 7 Web Start
24Exec=/home/greenstone/Desktop/linux/jre/bin/javaws %u
25Terminal=false
26Type=Application
27Icon=javaws
28Categories=Application;Network;
29MimeType=application/x-java-jnlp-file;
30
31----------------------
32LINKS
33----------------------
34Reading on Java Web Start and Java Native Launch protocol (JNLP). The relationship between Java Web Start and JNLP:
35https://docs.oracle.com/cd/E84882_01/otn/pdf/E84699_01.pdf
36"Java Web Start is a technology that builds on the file association facilities of browsers through the use of Java Native Launch Protocol."
37
38
39Google search: Migrate Java 1.9 webstart
40
41https://docs.oracle.com/javase/9/whatsnew/toc.htm#JSNEW-GUID-9205ABFD-2024-40C8-B01E-A7328BBE4276
42https://docs.oracle.com/javase/9/deploy/migrating-java-applets-jnlp.htm#JSDPG-GUID-6B65096D-49F3-4AE2-B9ED-F8137A9B4D9E
43https://docs.oracle.com/javase/9/deploy/self-contained-application-packaging.htm#JSDPG592
44http://www.oracle.com/technetwork/java/javase/migratingfromapplets-2872444.pdf
45https://docs.oracle.com/javase/8/docs/technotes/guides/deploy/applet_dev_guide.html#JSDPG1032
46https://dzone.com/articles/java-web-start-jnlp-hello
47
48https://docs.oracle.com/javase/tutorial/uiswing/examples/misc/index.html
49https://bugs.openjdk.java.net/browse/JDK-8178799
50https://www.v3.co.uk/v3-uk/news/2443810/oracle-signals-the-end-of-java-applet-support-for-browsers
51https://schneide.wordpress.com/2016/10/11/the-migration-path-for-java-applets/
52https://docs.oracle.com/javase/9/deploy/jnlp-file-syntax.htm#JSDPG-GUID-A935D448-EA5A-42E0-B103-DD02ECAD1436
53https://docs.oracle.com/javase/tutorial/deployment/deploymentInDepth/embeddingJNLPFileInWebPage.html
54https://stackoverflow.com/questions/7313317/jnlp-as-a-applet-in-html-page
55
56https://stackoverflow.com/questions/17338711/jarsigner-manifest-permissions
57https://stackoverflow.com/questions/19659134/how-do-i-fix-missing-codebase-permissions-and-application-name-manifest-attri
58https://docs.oracle.com/javase/7/docs/technotes/guides/jweb/security/manifest.html#codebase
59https://docs.oracle.com/javase/tutorial/deployment/jar/modman.html
60https://docs.oracle.com/javase/tutorial/deployment/jar/build.html
61https://stackoverflow.com/questions/18907695/ioexception-invalid-header-field-when-creating-jar-file-with-manifest
62https://docs.oracle.com/javase/tutorial/deployment/jar/manifestindex.html
63https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#JARManifest
64https://community.oracle.com/thread/1536875?start=0
Note: See TracBrowser for help on using the repository browser.