- 2019-03-19T17:54:23+13:00 (3 years ago)
- 1 edited
r32154 r32916 2 2 README 3 3 -------------------------- 4 Java Web Start version of GLI applet using our new JNLP file 5 4 6 1. 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. 7 2. Move the SignedGatherer.jar into GS3's web/applet folder. Edit GLIapplet.jnlp if necessary. 8 3. 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 9 4. Launch the Java Control Panel (jre/bin/javacpl.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. 10 5. Once the GS3 code is compiled up, start up the GS3 web server and visit http://localhost:8383/greenstone3/library?a=p&sa=gli4gs3 11 In 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. 12 6. 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. 5 GLI Java Web Start application (replacement for GLI Applet) - Additional Steps 13 6 14 -------------------------- 15 FILE: javawebstart.desktop 16 -------------------------- 7 Many browsers have stopped supporting Java applets, while Microsoft's Internet Explorer, and perhaps Microsoft Edge, still support it. For this reason, 3.09's GLI is now no longer provided as an applet, but has been converted into a Java Web Start application. 8 9 Instructions for using the GLI Java Web Start, which works over the JNLP protocol, are below. 10 11 1. Follow the instructions at http://wiki.greenstone.org/doku.php?id=en:release:3.09_release_notes#setting_up_a_remote_greenstone_3_server for setting up the Remote GS Server 12 13 2. Next, generate the SignedGatherer.jar: 14 a. Use a terminal to go into the Greenstone "gli" directory, then run 15 keytool -genkey -alias privateKey -keystore appletstore -storepass greenstone 16 Enter the appropriate details for your organization. When it asks to enter the key password for <privateKey>, choose your own password or hit Enter to use "greenstone". 17 b. Next, run 18 jarsigner -keystore appletstore -signedjar SignedGatherer.jar GLI.jar privateKey 19 When it prompts, enter the password you used in step 2a above. 20 21 3. Move the created SignedGatherer.jar file from the gli directory into GS3's web/applet subdirectory. 22 23 4. You need to associate JNLP files with Java Web Start (jre/bin/javaws). 24 25 - On Windows, create the association in the usual way: when you first access the GLI Web Start application through Greenstone, 26 a JNLP file called "GLIappWebStart.jnlp" will be offered for launching or download. 27 If JavaWS is not already the default application to open JNLP files with, rightclick on the downloaded GLIappWebStart.jnlp file 28 and choose Launch/Open with âŠ. 29 Browse to your Greenstone3's packages/jre/bin/javaws.exe or any installed Java's jre/bin/javaws.exe to use Java's Web Start application as the launcher. 17 30 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; 31 - For Linux, create a file with .desktop extension (e.g. "javawebstart.desktop") containing the following, edit the path to javaws, 32 and save this file into ~/.local/share/applications: 33 34 -------------------------- 35 FILE: javawebstart.desktop 36 -------------------------- 37 # This file makes Ubuntu associate .jnlp files with Java Web Start (javaws) 38 # This file should be adjusted and then copied into ~/.local/share/applications 39 # as a file with .desktop extension, e.g. javawebstart.desktop 40 # https://askubuntu.com/questions/235861/how-to-associate-jnlp-file-with-javaws 41 [Desktop Entry] 42 Encoding=UTF-8 43 Name=Java 7 Web Start 44 Comment=Java 7 Web Start 45 Exec=/path-to-java-jre/bin/javaws %u 46 Terminal=false 47 Type=Application 48 Icon=javaws 49 Categories=Application;Network; 50 MimeType=application/x-java-jnlp-file; 51 -------------------------- 52 53 5. Launch the Java Control Panel by running jre/bin/javacpl.exe on Windows or jre/bin/ControlPanel on Linux. 54 (GS3 binaries now include a JRE in the packages folder if you want to use the bundled JRE.) 55 In the Java Control Panel, go to the Security tab, set Security level to High if not already set. 56 Click Edit Site List, and then press Add to add the host:port that the GS3 will run on. 57 Remember, to be accessible to the outside world, the host can't be "localhost", but would be the hostname of your machine or public IP. 58 59 6. Make the GLI link on the home page active: Open web/interfaces/default/transform/pages/home.xsl for editing, find the line 60 61 <!--<gslib:libraryInterfaceLink/><br/><br/>--> 62 63 and remove the comments. i.e. change it to 64 65 <gslib:libraryInterfaceLink/><br/><br/> 66 67 7. Start up the GS3 web server and visit your DL library home page, http://[hostname]:8383/greenstone3/library. 68 69 8. Since you have set up the JNLP file association in a previous step, you can now click on the "The Librarian Interface" link 70 and your browser should offer to save or launch a file called GLIappWebStart.jnlp: One of the applications for launching it 71 should be the Java Web Start application (javaws) that you associated with .jnlp file extensions. Choose that application as the launcher. 72 If the browser is able to successfully launch it, Java Web Start will be used to run the GLI application indicated by the JNLP file. 73 If launching through the browser is not possible, then choose to save the JNLP file. 74 It will download the file to a temporary user area (like C:\Users\<user>\AppData\Local\Temp on windows). 75 And then you can rightclick on the downloaded GLIappWebStart.jnlp file, to launch it with the Java Web Start program you already 76 associated with this file type. 77 78 9. After authorising the GLI to run, the JNLP version of the GLI Applet will eventually run and behave like the usual client-GLI 79 (and like the old GLI applet) from this point onward. Refer to the client-gli section of 80 http://wiki.greenstone.org/doku.php?id=en:release:3.09_release_notes#setting_up_a_remote_greenstone_3_server 81 32 82 33 83 --------------------------
Note: See TracChangeset for help on using the changeset viewer.