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

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

Rewrote WebGatherer as a Java Web Start application, rather than an Applet which it still was during the previous commit.

File size: 4.8 KB
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
45 section "Migrating an Existing Java Applet"
46https://docs.oracle.com/javase/9/deploy/self-contained-application-packaging.htm
47http://www.oracle.com/technetwork/java/javase/migratingfromapplets-2872444.pdf
48https://docs.oracle.com/javase/8/docs/technotes/guides/deploy/applet_dev_guide.html
49https://dzone.com/articles/java-web-start-jnlp-hello
50
51https://docs.oracle.com/javase/tutorial/uiswing/examples/misc/index.html
52https://bugs.openjdk.java.net/browse/JDK-8178799
53https://www.v3.co.uk/v3-uk/news/2443810/oracle-signals-the-end-of-java-applet-support-for-browsers
54https://schneide.wordpress.com/2016/10/11/the-migration-path-for-java-applets/
55https://docs.oracle.com/javase/9/deploy/jnlp-file-syntax.htm
56https://docs.oracle.com/javase/tutorial/deployment/deploymentInDepth/embeddingJNLPFileInWebPage.html
57https://stackoverflow.com/questions/7313317/jnlp-as-a-applet-in-html-page
58
59https://stackoverflow.com/questions/17338711/jarsigner-manifest-permissions
60https://stackoverflow.com/questions/19659134/how-do-i-fix-missing-codebase-permissions-and-application-name-manifest-attri
61https://docs.oracle.com/javase/7/docs/technotes/guides/jweb/security/manifest.html#codebase
62https://docs.oracle.com/javase/tutorial/deployment/jar/modman.html
63https://docs.oracle.com/javase/tutorial/deployment/jar/build.html
64https://stackoverflow.com/questions/18907695/ioexception-invalid-header-field-when-creating-jar-file-with-manifest
65https://docs.oracle.com/javase/tutorial/deployment/jar/manifestindex.html
66https://docs.oracle.com/javase/8/docs/technotes/guides/jar/jar.html#JARManifest
67https://community.oracle.com/thread/1536875?start=0
68
69https://stackoverflow.com/questions/1199211/java-webstart-with-parameters
70https://stackoverflow.com/questions/14116640/how-to-use-jnlp-to-pass-command-line-arguments-to-the-application
Note: See TracBrowser for help on using the repository browser.