en:release:2.87_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:2.87_release_notes [2017/09/27 07:49] – [Additional notes related to running Greenstone on Windows] anupama | en:release:2.87_release_notes [2020/04/23 06:52] – [Troubleshooting and other Questions] anupama | ||
---|---|---|---|
Line 3: | Line 3: | ||
**Release Name:** 2.87 | **Release Name:** 2.87 | ||
- | **Release Date: | + | **Release Date: |
** Released: ** | ** Released: ** | ||
+ | * Greenstone v2.87: The official Greenstone 2.87. 01 Oct 2017 \\ Binaries for Windows, GNU/Linux 32 and 64 bit, Mac Mountain Lion and Mac El Capitan. Mac Mountain Lion and 32 bit linux binaries were only spot tested. The other 3 binaries were tested more extensively. The sole Windows binary is, as usual, for both 32 and 64 bit machines and was largely tested on **Windows 10** this time.\\ [[http:// | ||
** Release Candidate History ** | ** Release Candidate History ** | ||
Line 34: | Line 35: | ||
< | < | ||
- | The small Greenstone Server Interface (GSI) dialog will display. Pressing its Enter Library button will open a browser onto your Greenstone Digital Library home page.(*) | + | The small Greenstone Server Interface (GSI) dialog will display. Pressing its Enter Library button will open a browser onto your Greenstone Digital Library home page.(1) |
- | By default, the web servers restrict access to Greenstone pages to the local machine. To change this, go to File > Settings in the Greenstone Server Interface dialog, and tick "Allow external connections" | + | By default, the web servers restrict access to Greenstone pages to the local machine. To change this, go to File > Settings in the Greenstone Server Interface dialog, and tick "Allow external connections" |
**Note:** The Windows version of Greenstone includes two server applications: | **Note:** The Windows version of Greenstone includes two server applications: | ||
Line 49: | Line 50: | ||
< | < | ||
- | First, as in (1) above, the Greenstone Server Interface (GSI) dialog will appear. Eventually the Greenstone Librarian Interface (GLI) dialog will appear. Refer to the [[en: | + | First, as in (1) above, the Greenstone Server Interface (GSI) dialog will appear.\\ ** Note**: If you're using the included //apache httpd server// and running GLI starts by requesting you for the Local Library URL, then it expects the library home URL that's of the form '' |
- | (*) If the web page displays a " | + | (1) If the web page displays a " |
- | < | + | < |
**To change the GLI interface language**, run GLI, go to the '' | **To change the GLI interface language**, run GLI, go to the '' | ||
Line 67: | Line 68: | ||
When the client-GLI starts up, a small dialog appears asking you to enter the URL of the remote Greenstone server' | When the client-GLI starts up, a small dialog appears asking you to enter the URL of the remote Greenstone server' | ||
- | | + | * To get your Greenstone installation set up as a remote server so that other GLI clients can connect to it, refer to the section [[2.87_Release_Notes# |
- | | + | |
==== Installing in text-only mode ==== | ==== Installing in text-only mode ==== | ||
* Refer to [[http:// | * Refer to [[http:// | ||
+ | |||
+ | |||
+ | ==== Adding source code to a binary release ==== | ||
+ | Make sure to select the " | ||
+ | * [[http:// | ||
+ | * [[http:// | ||
+ | |||
+ | |||
+ | ==== Installing a source release ==== | ||
+ | |||
+ | Make sure to select the " | ||
+ | |||
+ | * [[http:// | ||
+ | * [[http:// | ||
Line 107: | Line 121: | ||
+ | ===== Learning to use Greenstone ===== | ||
+ | If your Greenstone is up and running and you're ready to start learning about how to use Greenstone, refer to the [[en: | ||
+ | |||
+ | |||
+ | ===== Troubleshooting and other Questions ===== | ||
+ | * Have a look at the [[http:// | ||
+ | |||
+ | * If not, then please consult the Greenstone FAQ at http:// | ||
+ | |||
+ | * If you're running Greenstone 2.87 on a machine where the version of Perl is later than 5.18 (e.g. perl 5.22), as may happen when you upgrade your Ubuntu to 16.04 or later, and your GLI does not start up properly, then first stop and restart GLI in debug mode to get better error reporting: '' | ||
+ | < | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/(/.*){ <-- HERE ,41}/ at / | ||
+ | AutoLoadConverters: | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/^[a-z]{ <-- HERE 2..}/ at / | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/^[a-z]{ <-- HERE 2..}/ at / | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/ | ||
+ | Getting Download Info: [perl, -S, / | ||
+ | WGet thread is waiting for DownloadJobs. | ||
+ | Failed when trying to parse downloadinfo.pl -describeall | ||
+ | java.lang.Exception: | ||
+ | at org.greenstone.gatherer.gui.DownloadPane.loadDownloadersInfo(DownloadPane.java: | ||
+ | at org.greenstone.gatherer.gui.DownloadPane.< | ||
+ | at org.greenstone.gatherer.gui.GUIManager.display(GUIManager.java: | ||
+ | at org.greenstone.gatherer.Gatherer.openGUI(Gatherer.java: | ||
+ | at org.greenstone.gatherer.GathererProg.main(GathererProg.java: | ||
+ | java.lang.NullPointerException | ||
+ | at org.greenstone.gatherer.gui.DownloadPane.< | ||
+ | at org.greenstone.gatherer.gui.GUIManager.display(GUIManager.java: | ||
+ | at org.greenstone.gatherer.Gatherer.openGUI(Gatherer.java: | ||
+ | at org.greenstone.gatherer.GathererProg.main(GathererProg.java: | ||
+ | java.lang.NullPointerException | ||
+ | at org.greenstone.gatherer.gui.DownloadPane.< | ||
+ | at org.greenstone.gatherer.gui.GUIManager.display(GUIManager.java: | ||
+ | at org.greenstone.gatherer.Gatherer.openGUI(Gatherer.java: | ||
+ | at org.greenstone.gatherer.GathererProg.main(GathererProg.java: | ||
+ | ShutDownHook called... | ||
+ | Attempting to forcibly terminate the GS server... | ||
+ | Issuing stop command to GS2 Local Library Server. Waiting for GS2 server to stop... | ||
+ | Successfully stopped GS2 server. | ||
+ | Done. | ||
+ | </ | ||
+ | |||
+ | 1. Optional: Back up your GS3.08' | ||
+ | |||
+ | 2. Download GS287PluginsForNewerPerlUbuntu.tar.gz, | ||
+ | |||
+ | 3. Five files should have been extracted: | ||
+ | * Put the 3 Plugin.pm files into your GS2.87' | ||
+ | * put Escape.pm into the '' | ||
+ | * put PP.pm into into the '' | ||
+ | |||
+ | 4. Use a //new terminal// to launch GLI or any commands that previously failed with errors. | ||
+ | |||
+ | ===== 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' | ||
+ | By default, Windows doesn' | ||
=====To turn on RSS support: | =====To turn on RSS support: | ||
Line 223: | Line 302: | ||
| | ||
</ | </ | ||
- | You can use it as in the following example | + | You can use it as follows |
* In a command window, go to your Greenstone installation folder and run setup.bat (if on Windows) or ' | * In a command window, go to your Greenstone installation folder and run setup.bat (if on Windows) or ' | ||
Line 231: | Line 310: | ||
* Then type " | * Then type " | ||
* To stop the webserver at any point, from your command window run " | * To stop the webserver at any point, from your command window run " | ||
- | * If you move your Greenstone 2.86 installation folder to another location at any point, then (with the server still stopped), you would need to run " | + | * If you move your Greenstone 2.87 installation folder to another location at any point, then (with the server still stopped), you may first need to run " |
* If you forgot the admin password (as is required to access the Administration Pages and to use Remote GLI), this can be reset by running " | * If you forgot the admin password (as is required to access the Administration Pages and to use Remote GLI), this can be reset by running " | ||
==== Notes on using GLI ==== | ==== Notes on using GLI ==== | ||
In GLI's File > File Associations, | In GLI's File > File Associations, | ||
- | * On Mac, you can type **open %1** for all of these, which then lets the default application on the Mac open the file extension associated with each file. You may need to find the right command for you version of *Nix. | + | * On Mac, you can type **'' |
- | * To do the same on Linux, type **xdg-open %1** (or if you are specifically on a gnome system, then use **gnome-open %1**, while on a kde system you'd use **kde-open %1**). | + | * To do the same on Windows, type **'' |
- | * To do the same on Windows, type **cmd.exe /c start "" | + | * To attempt the same on Linux, try typing '' |
==== Working with Remote Greenstone and the GLI-Client ==== | ==== Working with Remote Greenstone and the GLI-Client ==== | ||
**Instructions** | **Instructions** | ||
- | These instructions are more Greenstone 2.86-specific | + | These instructions are more specific to current and recent |
The following are steps to follow if you're on **Windows**. On **Unix based systems**, you can skip steps 1 and 2, otherwise things are similar. For instance, on Unix systems, you'll want to launch *.bash or *.sh script equivalents to the batch files listed. Also, you'll want to use forward slashes (/) instead of the Windows' | The following are steps to follow if you're on **Windows**. On **Unix based systems**, you can skip steps 1 and 2, otherwise things are similar. For instance, on Unix systems, you'll want to launch *.bash or *.sh script equivalents to the batch files listed. Also, you'll want to use forward slashes (/) instead of the Windows' | ||
Line 287: | Line 365: | ||
< | < | ||
On Linux you would do: | On Linux you would do: | ||
- | < | + | < |
(If on Vista or Windows 7, you installed Greenstone in an Admin area, such as in Program Files, then you would need change the security settings of the collect directory: Right-click > Properties, then set the folder to " | (If on Vista or Windows 7, you installed Greenstone in an Admin area, such as in Program Files, then you would need change the security settings of the collect directory: Right-click > Properties, then set the folder to " | ||
Line 433: | Line 511: | ||
* you're on Windows and have OpenOffice/ | * you're on Windows and have OpenOffice/ | ||
* you're on Linux and have OpenOffice or LibreOffice installed in a location different from "/ | * you're on Linux and have OpenOffice or LibreOffice installed in a location different from "/ | ||
- | * Once you have Open Office set up, download the Greenstone extension for it [[http:// | + | * Once you have Open Office set up, download the Greenstone extension for it [[http:// |
* Before you can use this (or any other Greenstone extension), you will need to quit GLI and GS2-server if either are open and then you will need to relaunch GLI (or run Greenstone scripts) from a fresh command terminal, in order for the extension to become available in the Greenstone environment. | * Before you can use this (or any other Greenstone extension), you will need to quit GLI and GS2-server if either are open and then you will need to relaunch GLI (or run Greenstone scripts) from a fresh command terminal, in order for the extension to become available in the Greenstone environment. | ||
* With OpenOffice and the extension installed and the Greenstone environment set up for this, Greenstone' | * With OpenOffice and the extension installed and the Greenstone environment set up for this, Greenstone' | ||
====PDFBox==== | ====PDFBox==== | ||
* The PDF Box extension provides support for conversion of PDF documents to text. It supports the latest PDF versions (unlike Greenstone' | * The PDF Box extension provides support for conversion of PDF documents to text. It supports the latest PDF versions (unlike Greenstone' | ||
- | * Download the extension [[http:// | + | * Download the extension [[http:// |
* Before you can use the extension, you will need to quit GLI and GS2-server if either are open and then you will need to relaunch GLI (or run Greenstone scripts) from a fresh command terminal, in order for the extension to become available in the Greenstone environment. | * Before you can use the extension, you will need to quit GLI and GS2-server if either are open and then you will need to relaunch GLI (or run Greenstone scripts) from a fresh command terminal, in order for the extension to become available in the Greenstone environment. | ||
* PDFBox generates HTML documents from the PDF that may contain more whitespace between lines and paragraphs than you'd wish. In such a case, you can fix this on a per-collection basis using GLI. Open your collection in GLI, go to the Format panel, select Format Features to the left and DocumentText to the right. In the text-area for HTML Format String below, create an HTML style element to set the top and margin bottoms on a paragraph element to 0. You need to escape curly braces with a back slash. In the end your format statement for DocumentText will look like: <br/> | * PDFBox generates HTML documents from the PDF that may contain more whitespace between lines and paragraphs than you'd wish. In such a case, you can fix this on a per-collection basis using GLI. Open your collection in GLI, go to the Format panel, select Format Features to the left and DocumentText to the right. In the text-area for HTML Format String below, create an HTML style element to set the top and margin bottoms on a paragraph element to 0. You need to escape curly braces with a back slash. In the end your format statement for DocumentText will look like: <br/> | ||
Line 463: | Line 541: | ||
3. Run the web server and usage.txt should become populated with information. | 3. Run the web server and usage.txt should become populated with information. | ||
+ | |||
+ | |||
===== Known Issues===== | ===== Known Issues===== | ||
en/release/2.87_release_notes.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1