en:release:2.86_release_notes
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:release:2.86_release_notes [2016/07/12 04:49] – [PDFBox] anupama | en:release:2.86_release_notes [2023/03/13 01:46] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | |||
+ | |||
+ | |||
**Release Name:** 2.86 | **Release Name:** 2.86 | ||
Line 28: | Line 31: | ||
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 77: | ||
* 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 93: | Line 113: | ||
* Perl 8 or later. For windows, you can get ActivePerl. | * Perl 8 or later. For windows, you can get ActivePerl. | ||
- | <TABAREA tabs=" | + | |
< | < | ||
- | <TAB> | + | <tabbox Source comp Linux/Mac> |
- Download the Source Component tar.gz file that matches with your Greenstone binary version, and put it in your Greenstone installation folder. | - Download the Source Component tar.gz file that matches with your Greenstone binary version, and put it in your Greenstone installation folder. | ||
- Use a terminal to extract the downloaded file's contents into your Greenstone installation folder: \\ < | - Use a terminal to extract the downloaded file's contents into your Greenstone installation folder: \\ < | ||
Line 107: | Line 127: | ||
./ | ./ | ||
./ | ./ | ||
- | </ | + | </ |
- | </TAB> | + | **Note** that some Linux and Mac machines may require to you to export '' |
+ | < | ||
+ | export CFLAGS=" | ||
+ | make distclean | ||
+ | makegs2.sh gnome-lib | ||
+ | </ | ||
+ | **Note** | ||
< | < | ||
- | <TAB> | + | <tabbox Source comp Win> |
It's handy to create a batch script to set the environment. Create a file containing the following, make sure to replace the paths with your own, and save the file as **setupenv.bat** | It's handy to create a batch script to set the environment. Create a file containing the following, make sure to replace the paths with your own, and save the file as **setupenv.bat** | ||
< | < | ||
Line 142: | Line 168: | ||
- It will take some minutes to compile after which, if there are no errors, you can start running GLI or the gs2-server. | - It will take some minutes to compile after which, if there are no errors, you can start running GLI or the gs2-server. | ||
- If you want to re-compile GLI go into your Greenstone' | - If you want to re-compile GLI go into your Greenstone' | ||
- | </ | + | |
< | < | ||
- | <TAB> | + | <tabbox Source dist Linux/Mac> |
- Download Source Distribution. | - Download Source Distribution. | ||
- If you want to compile up gnome-lib yourself, skip this step. If you want to use a pre-compiled gnome-lib binary (to save on all the time of compiling gnome-lib), download the gnome-lib-minimal package for your OS by visiting http:// | - If you want to compile up gnome-lib yourself, skip this step. If you want to use a pre-compiled gnome-lib binary (to save on all the time of compiling gnome-lib), download the gnome-lib-minimal package for your OS by visiting http:// | ||
Line 154: | Line 180: | ||
./ | ./ | ||
</ | </ | ||
- | - 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' |
- | </ | + | |
- | < | + | < |
- | <TAB> | + | <tabbox Source dist Win> |
It's handy to create a batch script to set the environment. Create a file containing the following, make sure to replace the paths with your own, and save the file as **setupenv.bat** | It's handy to create a batch script to set the environment. Create a file containing the following, make sure to replace the paths with your own, and save the file as **setupenv.bat** | ||
< | < | ||
Line 190: | Line 216: | ||
- 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' |
- | </TAB> | + | </tabbox> |
- | </ | + | |
- | ==== 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 339: | ||
* 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 483: | Line 502: | ||
* 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 516: | ||
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 570: | ||
- | 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 596: | ||
**Useful resources** | **Useful resources** | ||
- | * [[http:// | + | * [[http:// |
Line 1027: | Line 1046: | ||
**Important: | **Important: | ||
+ |
en/release/2.86_release_notes.1468298998.txt.gz · Last modified: 2016/07/12 04:49 (external edit)