en:release:3.09_release_notes
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
en:release:3.09_release_notes [2018/02/27 06:04] – anupama | en:release:3.09_release_notes [2018/10/02 06:27] – [Setting up your Greenstone to run over https] anupama | ||
---|---|---|---|
Line 14: | Line 14: | ||
* **Note to Mac users:** The security settings in newer Mac OS versions have been altered to by default disallow users from casually opening and running .dmg executables that are not from Apple itself. When attempting to open the Greenstone binary .dmg file, if it pops up an error warning about security, you will need to set up the Security on your Mac to allow you to run .dmg files downloaded from the internet. Otherwise the Greenstone mac binary will not run. To do this, Go to your Mac's System Preferences. Under " | * **Note to Mac users:** The security settings in newer Mac OS versions have been altered to by default disallow users from casually opening and running .dmg executables that are not from Apple itself. When attempting to open the Greenstone binary .dmg file, if it pops up an error warning about security, you will need to set up the Security on your Mac to allow you to run .dmg files downloaded from the internet. Otherwise the Greenstone mac binary will not run. To do this, Go to your Mac's System Preferences. Under " | ||
- | * **For Linux**, you will need to set the file to be executable before running it. (e.g. chmod a+x Greenstone-3.08-linux) | + | * **For Linux**, you will need to set the file to be executable before running it. (e.g. chmod a+x Greenstone-3.09-linux) |
* The installer initially unpacks into a temporary directory (/tmp on linux). If you wish to change this, set the TMPDIR environment variable. | * The installer initially unpacks into a temporary directory (/tmp on linux). If you wish to change this, set the TMPDIR environment variable. | ||
Note that in some cases, the following **doesn' | Note that in some cases, the following **doesn' | ||
< | < | ||
- | | + | |
Use the following instead | Use the following instead | ||
- | < | + | < |
During the installation process you will be presented with several options. For many, the default settings will be sufficient. Some important options are | During the installation process you will be presented with several options. For many, the default settings will be sufficient. Some important options are | ||
Line 38: | Line 38: | ||
<!-- | <!-- | ||
=== Installing and running GS3.09 on Mac Maverick and Yosemite machines === | === Installing and running GS3.09 on Mac Maverick and Yosemite machines === | ||
- | From GS3.07rc**2** onwards, we're including a JRE with Mac Mountain Lion binaries, so that the **3.08 Mountain Lion binaries should work on Maverick and Yosemite machines out of the box.** (At present the source code still does not compile up on these newer Mac Operating Systems.) | + | From GS3.07rc**2** onwards, we're including a JRE with Mac Mountain Lion binaries, so that the **3.09 Mountain Lion binaries should work on Maverick and Yosemite machines out of the box.** (At present the source code still does not compile up on these newer Mac Operating Systems.) |
--> | --> | ||
Line 56: | Line 56: | ||
===== Further instructions ===== | ===== Further instructions ===== | ||
+ | ==== Setting up your Greenstone to run over https ==== | ||
+ | The more secure https protocol is increasingly required by browsers and gradually superseding http. Given that you meet the following requirements and configure your GS3 as below, Greenstone 3 has now been automated to obtain an https certificate for you from the free Certification Authority " | ||
+ | Requirements: | ||
+ | * on unix (linux and mac) systems you need to have sudo permissions | ||
+ | * on windows, you probably need admin rights | ||
+ | * ensure nothing is running on port 80 when you're ready to set up https certification your GS3 | ||
+ | |||
+ | Steps: | ||
+ | - Edit build.properties as follows: | ||
+ | * set '' | ||
+ | * set a value for '' | ||
+ | * Ensure '' | ||
+ | * By default '' | ||
+ | - Make sure you have read and agree with the [[https:// | ||
+ | - Use a terminal to go into your GS3 installation folder, run '' | ||
+ | source ./ | ||
+ | ant setup-https-cert | ||
+ | </ | ||
+ | - Once the setup-https-cert ant target has finished, you can start your web GS3 server by either running the gs3-server application or by running "ant start" from the terminal. | ||
+ | - If you ran the gs3-server application, | ||
+ | - Once your https home page has loaded, confirm that your certificate is properly installed by looking for a green padlock next to the address bar. (Depending on your browser, you can click the padlock to get more information on the certificate issuer.) | ||
+ | |||
+ | There are 2 more https-related automated ant targets you can run from the command line: | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | **Important: | ||
+ | |||
+ | |||
+ | ==== PDF plugin restructuring and the NEW PDFv2Plugin ==== | ||
+ | |||
+ | From GS3.09 onward, the GS3 binaries will henceforth include additional tools for converting from PDF to various text/ | ||
+ | |||
+ | We're deprecating the old " | ||
+ | * " | ||
+ | * the recommended " | ||
+ | |||
+ | For the eventual 3.09 release, the old PDFPlugin that you're familiar with, the one which has the pdfbox_conversion flag but also makes use of the old pdftohtml, will hang around with a deprecated warning, to allow people to port over their collections and keep rebuilding with the old settings or to rebuild their collection with one of the 2 new PDF plugins. However, new collections will have the PDFv2Plugin in the document plugins pipeline by default, for GS3, and PDFv1Plugin by default for GS2 since GS2 doesn' | ||
+ | |||
+ | |||
+ | The " | ||
+ | * text: a single stream of text | ||
+ | * html: a single stream of basic html from just the extracted text, no images | ||
+ | * pretty_html: | ||
+ | * paged_pretty_html (also the default when convert_to is set to auto): pretty_html but each page is a section | ||
+ | * pagedimg_< | ||
+ | * pagedimgtxt_< | ||
+ | |||
+ | As always, text is only extracted from a PDF where extractable. This depends on user permissions for a PDF, whether the PDF contains actual extractable text and not just images of text, whether the PDF is undamaged, and any other such factors. | ||
+ | |||
+ | There may be further adjustments made, including to display strings, but so far, we've decided on the above output formats and they seem to work on my regular PDF test documents. | ||
====Changing the admin password==== | ====Changing the admin password==== | ||
Login to the administration page, ' | Login to the administration page, ' | ||
Line 182: | Line 233: | ||
Many browsers have stopped supporting Java applets, while Microsoft' | Many browsers have stopped supporting Java applets, while Microsoft' | ||
- | Instructions for using the GLI Java Web Start, which works over the JNLP protocol | + | Instructions for using the GLI Java Web Start, which works over the JNLP protocol, are below. |
- | - First follow the instructions above for [[http:// | + | - First follow the instructions above for [[http:// |
- Next, generate the SignedGatherer.jar: | - Next, generate the SignedGatherer.jar: | ||
* Use a terminal to go into the Greenstone " | * Use a terminal to go into the Greenstone " | ||
- | * Next, run | + | * Next, run < |
- | < | + | |
When it prompts, enter the password you used above. | When it prompts, enter the password you used above. | ||
- Move the created '' | - Move the created '' | ||
Line 208: | Line 258: | ||
MimeType=application/ | MimeType=application/ | ||
</ | </ | ||
- | - Launch the Java Control Panel by running '' | + | - Launch the Java Control Panel by running '' |
- | - Once the GS3 code is compiled up, start up the GS3 web server and visit your DL library home page, '' | + | - Once the GS3 code is compiled up, start up the GS3 web server and visit your DL library home page, '' |
+ | - Since you have set up the JNLP file association in a previous step, you can now click on the "The Librarian Interface" | ||
- After authorising the GLI to run, the JNLP version of the GLI Applet will eventually run and behave like the usual client-GLI (and like the old GLI applet) from this point onward. | - After authorising the GLI to run, the JNLP version of the GLI Applet will eventually run and behave like the usual client-GLI (and like the old GLI applet) from this point onward. | ||
Line 220: | Line 271: | ||
===== Important Changes and Bug Fixes ===== | ===== Important Changes and Bug Fixes ===== | ||
- | + | | |
- | | + | |
- | * lots of display items (for indexes, classifiers etc) now come from dictionaries, | + | |
- | * gs3 can work off a read only location such as dvd. | + | |
- | * hierarchy menu with suggestions for metadata editor thanks to Georgy Litvinov | + | |
- | * a lot of work has been done on getting all the text strings into properties files so the complete interface can be translated. | + | |
- | * collection groups web/ | + | |
- | * < | + | |
- | * support for classifier tabs that are just linksq | + | |
- | * The raw collectionConfig.xml file can now be edited directly from within GLI: Edit-> | + | |
- | * Tidied up collection building using manifest files. See the [[http:// | + | |
- | * streamlined compilation, and adjustments | + | |
===== IMPORTANT information ===== | ===== IMPORTANT information ===== | ||
- | For ease of access this section has been brought across from the [[en: | + | For ease of access this section has been brought across from the [[en: |
==== Troubleshooting ==== | ==== Troubleshooting ==== | ||
+ | |||
+ | === Your browser doesn' | ||
+ | **The issue:** | ||
+ | The following scenario can occur if you set up GS3 with https, and your server.protocols property in build.properties contains both '' | ||
+ | |||
+ | Switching between visiting your Greenstone 3 digital library (DL) using http and https URLs can result in the http version of the pages not remembering your login details despite you logging in. This can happen if you ever started off with the https version of the URL to a Greenstone3 DL page and then moved to using the http version of your GS3 URL, or if you ever logged in to your GS3 over https and then attempt to log in later using http. | ||
+ | |||
+ | **The solution:** | ||
+ | The solution is to either start a private window if you want to access your GS3 DL pages over http, or to first clear your browser cookies related to your GS3 DL before swapping from https to http. | ||
+ | |||
+ | **The cause:** | ||
+ | Using https causes session cookies to have the secure flag set to true. When a session cookie has the secure flag thus set, non http URLs cannot return that cookie in their subsequent requests to the server. Only https URLs can. See https:// | ||
+ | |||
+ | <!-- | ||
+ | If you're on firefox and you just logged in to to a running Greenstone 3 digital library (DL), but visiting subsequent pages in the DL shows you that it has forgotten you're logged in, then you're probably encountering a restriction that your firefox browser has. | ||
+ | |||
+ | **NOTE:** We've encountered this problem on Firefox and only for http URLs that use the domain/ | ||
+ | |||
+ | To confirm that it only happens on firefox, try another browser first. For instance, Chrome. If your being logged in is being remembered on Chrome, then you've confirmed that the phenomenon is firefox-specific. | ||
+ | |||
+ | Things to try: | ||
+ | * Close all tabs in firefox and restart firefox in the usual way. Try logging in and visiting other pages to see if it remembers your login now. | ||
+ | * If that made no difference, try launching a Private Window (Ctrl + Shift + P on firefox), visit your GS3 digital library and login again, then check whether it's being remembered across Greenstone pages now. | ||
+ | * If that also made no difference then the most likely cause is Firefox plugins or extensions or addons, or maybe its hardware acceleration feature needs to be switched off. To find out if any of this is the case, quit firefox once more by first close all tabs in firefox and quit it. Then try re-launching Firefox in Safe Mode as explained at https:// | ||
+ | |||
+ | > [[https:// | ||
+ | > A small dialog should appear. Click Start In Safe Mode (not Refresh). Is the problem still there? | ||
+ | |||
+ | (If that doesn' | ||
+ | |||
+ | After relaunching Firefox in Safe Mode, test whether your login details are being remembered this time. If it works now, it could indeed be an addon/ | ||
+ | --> | ||
=== Mac Installer fails === | === Mac Installer fails === | ||
If running the Mac installer results in a message about having failed to copy to ''/ | If running the Mac installer results in a message about having failed to copy to ''/ | ||
+ | |||
=== Using the command line to reset the admin password when it isn't recognised === | === Using the command line to reset the admin password when it isn't recognised === | ||
If at any stage, your admin password is no longer recognised from the Greenstone Reader interface (the Greenstone pages that you view through the web browser), then you can try to reset your admin password through the command line. | If at any stage, your admin password is no longer recognised from the Greenstone Reader interface (the Greenstone pages that you view through the web browser), then you can try to reset your admin password through the command line. | ||
Line 254: | Line 327: | ||
5. Once you restart the server, try out your new password. | 5. Once you restart the server, try out your new password. | ||
+ | |||
==== Useful information ==== | ==== Useful information ==== | ||
When you've built a collection of documents, you may discover that there appears to be a copy of all these documents in the collection' | When you've built a collection of documents, you may discover that there appears to be a copy of all these documents in the collection' | ||
Line 335: | Line 409: | ||
===== Updated Translations ===== | ===== Updated Translations ===== | ||
- | Thanks to the following people for new and updated translations since 3.07: | + | Thanks to the following people for new and updated translations since 3.09: |
- | * Yvan Arnaud and Emmanuel Ngoi for French translations | + | |
- | * Tomáš Fiala for Slovak translations | + | |
- | * Yamaguchi Gaku for Japanese translations | + | |
- | * Maciej Jaros for Polish translations | + | |
- | * Georgy Litvinov for Russian translations | + | |
- | * Diego Spano for Spanish translations | + | |
- | * Lavji Zala for Gujarati translations | + | |
- | <!--* Gerhard Riesthuis for Dutch translations (core, GS2)--> | + | |
en/release/3.09_release_notes.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1