en:release:2.86_release_notes
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionLast revisionBoth sides next revision | ||
en:release:2.86_release_notes [2015/09/11 04:07] – external edit 127.0.0.1 | en:release:2.86_release_notes [2017/09/27 07:34] – anupama | ||
---|---|---|---|
Line 28: | Line 28: | ||
Upon downloading the installer, run the executable: On Windows and Mac you need to double-click it to launch the installation dialog, on Linux you first need to set the downloaded executable' | Upon downloading the installer, run the executable: On Windows and Mac you need to double-click it to launch the installation dialog, on Linux you first need to set the downloaded executable' | ||
- | It may take some time for the Greenstone installation dialog to appear. Once the installation dialog displays, you generally need to keep pressing the Next button until it is finished. However, when it asks for the location to install Greenstone in, make sure to choose a location on your file system for which you have access privileges. If you want to install Greenstone into C:\Program Files on Windows 7 or Windows Vista you will need to run the installer with administrator permissions (this can be achieved by right clicking on the installer and choosing "Run as administrator" | + | It may take some time for the Greenstone installation dialog to appear. Once the installation dialog displays, you generally need to keep pressing the Next button until it is finished. However, when it asks for the location to install Greenstone in, make sure to choose a location on your file system for which you have access privileges. If you want to install Greenstone into C:\Program Files on Windows 7 or Windows Vista you will need to run the installer with administrator permissions (this can be achieved by right clicking on the installer and choosing "Run as administrator" |
* The installer initially unpacks into a temporary directory (/tmp on linux). Set the TMPDIR environment variable to change this. | * The installer initially unpacks into a temporary directory (/tmp on linux). Set the TMPDIR environment variable to change this. | ||
Line 74: | Line 74: | ||
* If you wish to work with password protected collections, | * If you wish to work with password protected collections, | ||
* 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.86_Release_Notes# | * 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.86_Release_Notes# | ||
+ | |||
+ | |||
+ | ==== Running the installer in text-only mode ==== | ||
+ | - Give the binary of the installer execute permissions | ||
+ | - Then run it by passing in the text-only flag. | ||
+ | - Follow the instructions on the screen thereafter. If you mistype at any stage, press ctrl-C to start again. | ||
+ | |||
+ | < | ||
+ | > ./ | ||
+ | ---------------------------- | ||
+ | Extracting java installer... | ||
+ | ---------------------------- | ||
+ | |||
+ | Extraction Complete | ||
+ | You can now run "java -jar greenstone.jar text" to run the installer from the command line | ||
+ | > | ||
+ | </ | ||
Line 107: | Line 124: | ||
./ | ./ | ||
./ | ./ | ||
- | </ | + | </ |
+ | **Note** that some Linux and Mac machines may require to you to export '' | ||
+ | < | ||
+ | export CFLAGS=" | ||
+ | make distclean | ||
+ | makegs2.sh gnome-lib | ||
+ | </ | ||
+ | **Note** | ||
</ | </ | ||
< | < | ||
Line 154: | Line 178: | ||
./ | ./ | ||
</ | </ | ||
- | - You will need to enable the Administration pages if you want access to them. Do so by editing your Greenstone installation' | + | - You will need to enable the Administration pages if you want access to them. Do so by editing your Greenstone installation' |
</ | </ | ||
< | < | ||
Line 190: | Line 214: | ||
- If you want to run GLI as well, this will need to be compiled. To compile it, go into your Greenstone' | - If you want to run GLI as well, this will need to be compiled. To compile it, go into your Greenstone' | ||
- If you wish to compile up the GLI jar files, such as for Remote Greenstone situations, run the following from within the gli folder: '' | - If you wish to compile up the GLI jar files, such as for Remote Greenstone situations, run the following from within the gli folder: '' | ||
- | - You will need to enable the Administration pages if you want access to them. Do so by editing your Greenstone installation' | + | - You will need to enable the Administration pages if you want access to them. Do so by editing your Greenstone installation' |
</ | </ | ||
</ | </ | ||
- | ==== Running the installer in text-only mode ==== | ||
- | - Give the binary of the installer execute permissions | ||
- | - Then run it by passing in the text-only flag. | ||
- | - Follow the instructions on the screen thereafter. If you mistype at any stage, press ctrl-C to start again. | ||
- | |||
- | < | ||
- | > ./ | ||
- | ---------------------------- | ||
- | Extracting java installer... | ||
- | ---------------------------- | ||
- | |||
- | Extraction Complete | ||
- | You can now run "java -jar greenstone.jar text" to run the installer from the command line | ||
- | > | ||
- | </ | ||
==== Setting the Preview Command in GLI==== | ==== Setting the Preview Command in GLI==== | ||
Line 329: | Line 338: | ||
* If you had already built the collection, you can Preview it straight away. Any document page in the collection should provide a link in green at the bottom labelled Add Comment. If you're not already logged in, you will be taken to a log in screen and, once authenticated, | * If you had already built the collection, you can Preview it straight away. Any document page in the collection should provide a link in green at the bottom labelled Add Comment. If you're not already logged in, you will be taken to a log in screen and, once authenticated, | ||
- | Users need to have an account in your digital library in order to add comments. | + | **Notes: |
+ | * User comments cannot be added if the GS2 server is run from GLI. Run the standalone GS2 server to add user comments instead. | ||
+ | * Users need to have an account in your digital library in order to add comments. | ||
+ | - Go to your Greenstone home web page. | ||
+ | - Click on the Administration Page link | ||
+ | - Click the Add a New User link to the left | ||
+ | - You'll be requested for the admin username (type " | ||
+ | - Enter the username and password for the new user. The password has to be between 3 and 8 characters long. | ||
+ | - In the Groups field, type " | ||
+ | - Press the Submit button. | ||
Line 421: | Line 439: | ||
< | < | ||
- | ==== Additional notes to running Greenstone on Windows ==== | + | ==== Additional notes related |
On Windows, running the Greenstone Librarian Interface (GLI) or the Greenstone Server Interface (GSI) manually from a DOS prompt could be useful in diagnosing anything that goes wrong, since it keeps any messages that were displayed during program execution visible in the DOS window. | On Windows, running the Greenstone Librarian Interface (GLI) or the Greenstone Server Interface (GSI) manually from a DOS prompt could be useful in diagnosing anything that goes wrong, since it keeps any messages that were displayed during program execution visible in the DOS window. | ||
Line 483: | Line 501: | ||
* 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.86 installation folder to another location at any point, then (with the server still stopped), you would 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 ==== | ||
Line 497: | Line 515: | ||
These instructions are more Greenstone 2.86-specific than the [[http:// | These instructions are more Greenstone 2.86-specific than the [[http:// | ||
- | The following are steps to follow if you're on **Windows**. On **Linux**, you can skip steps 1 and 2, otherwise things are similar. For instance, 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 551: | Line 569: | ||
- | 8. Enter the username and password for the new user. | + | 8. Enter the username and password for the new user. The password has to be between 3 and 8 characters long. |
* In the Groups field, type " | * In the Groups field, type " | ||
* Press the Submit button. | * Press the Submit button. | ||
Line 577: | Line 595: | ||
**Useful resources** | **Useful resources** | ||
- | * [[http:// | + | * [[http:// |
Line 688: | Line 706: | ||
* 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. | ||
Line 795: | Line 813: | ||
===== Known Issues and Patches ===== | ===== Known Issues and Patches ===== | ||
+ | |||
+ | ==== Issues with running Greenstone on Port 80 ==== | ||
+ | |||
+ | Diego Spano describes how to run Greenstone on a port other than its default (the default port is 80), including in cases where you're creating a Greenstone CD-ROM or DVD-ROM: | ||
+ | |||
+ | WSASYSNOTREADY error will appear in any machine that has port 80 in use, not only Windows 10 machines. Even more, if you enable Windows firewall, you will not be able to run Greenstone too. If you have WAMP or XAMP in your machine, GS will not run. Sometimes, antivirus will block Greenstone too. I mean, there are many reasons that will have conflict with Greenstone. | ||
+ | |||
+ | If you distribute DVDs, before burning the image, change the file llsite.cfg and replace the line " | ||
+ | |||
+ | If you are dealing with local installations, | ||
+ | |||
+ | {{wiki: | ||
====Problem: | ====Problem: | ||
Line 986: | Line 1016: | ||
===== Troubleshooting and other Questions ===== | ===== Troubleshooting and other Questions ===== | ||
+ | |||
Please consult the Greenstone FAQ at http:// | Please consult the Greenstone FAQ at http:// | ||
to see if any of your questions are answered and for workarounds of known issues. If any issues persist, write to the Greenstone Mailing List. | to see if any of your questions are answered and for workarounds of known issues. If any issues persist, write to the Greenstone Mailing List. |
en/release/2.86_release_notes.txt · Last modified: 2023/03/13 01:46 by 127.0.0.1