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/09/25 09:36] – anupama | en:release:3.09_release_notes [2018/10/02 06:30] – [PDF plugin restructuring and the NEW PDFv2Plugin] anupama | ||
---|---|---|---|
Line 56: | Line 56: | ||
===== Further instructions ===== | ===== Further instructions ===== | ||
- | ==== Set up your Greenstone to run over https ==== | + | ==== Setting |
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 " | 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: | Requirements: | ||
- | * On unix (linux and mac) systems you need to have sudo permissions | + | * on unix (linux and mac) systems you need to have sudo permissions |
- | * On windows, you probably need admin rights | + | * on windows, you probably need admin rights |
- | * Ensure | + | * ensure |
Steps: | Steps: | ||
Line 71: | Line 71: | ||
* By default '' | * By default '' | ||
- Make sure you have read and agree with the [[https:// | - Make sure you have read and agree with the [[https:// | ||
- | - Use a terminal to go into your GS3 installation folder, run '' | + | - Use a terminal to go into your GS3 installation folder, run '' |
- | source ./gs3-setup | + | source ./gs3-setup.sh |
ant setup-https-cert | 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. | - 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, | - 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.) | - 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 automated ant targets you can run from the command line: | + | There are 2 more https-related |
* '' | * '' | ||
* '' | * '' | ||
+ | **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 '' | ||
+ | |||
+ | |||
+ | The " | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | * '' | ||
+ | |||
+ | 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 253: | Line 278: | ||
==== Troubleshooting ==== | ==== Troubleshooting ==== | ||
- | === Firefox | + | === 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. | 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. | ||
Line 271: | Line 308: | ||
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/ | 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 === |
en/release/3.09_release_notes.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1