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

Revision 32137, 4.5 KB (checked in by ak19, 22 months ago)

Cosmetic changes to the new README_WebGLI.txt file

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----------------------
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]
21    Encoding=UTF-8
22    Name=Java 7 Web Start
23    Comment=Java 7 Web Start
24    Exec=/home/greenstone/Desktop/linux/jre/bin/javaws %u
25    Terminal=false
26    Type=Application
27    Icon=javaws
28    Categories=Application;Network;
29    MimeType=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
42https://docs.oracle.com/javase/9/deploy/migrating-java-applets-jnlp.htm
43https://docs.oracle.com/javase/9/deploy/self-contained-application-packaging.htm
44http://www.oracle.com/technetwork/java/javase/migratingfromapplets-2872444.pdf
45https://docs.oracle.com/javase/8/docs/technotes/guides/deploy/applet_dev_guide.html
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
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 browser.