Greenstone Wiki

User Tools

Site Tools

You are here: index » en » release » 2.86_release_notes
en:release:2.86_release_notes

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
en:release:2.86_release_notes [2016/07/12 05:26] – anupamaen:release:2.86_release_notes [2025/08/07 23:52] (current) – updated mailing list address kjdon
Line 1: Line 1:
 +
 +
 +
  
 **Release Name:** 2.86 **Release Name:** 2.86
Line 74: Line 77:
   * If you wish to work with password protected collections, here's [[http://wiki.greenstone.org/doku.php?id=en:release:2.86_release_notes&#problemauthenticated_collections_require_constant_authentication|a workaround]] to the bug of constantly requiring to authenticate yourself.   * If you wish to work with password protected collections, here's [[http://wiki.greenstone.org/doku.php?id=en:release:2.86_release_notes&#problemauthenticated_collections_require_constant_authentication|a workaround]] to the bug of constantly requiring to authenticate yourself.
   * 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#Working_with_Remote_Greenstone_and_the_GLI-Client | Working with Remote Greenstone and the GLI-Client]].   * 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#Working_with_Remote_Greenstone_and_the_GLI-Client | Working with Remote Greenstone and the GLI-Client]].
 +
 +
 +==== 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.
 +
 +<code>
 +> ./Greenstone-2.86rc2-linux text-only
 +----------------------------
 +Extracting java installer...
 +----------------------------
 +
 +Extraction Complete
 +You can now run "java -jar greenstone.jar text" to run the installer from the command line
 +>
 +</code>
  
  
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="Source comp Linux/Mac, Source comp Win, Source dist Linux/Mac, Source dist Win">+
 <!-----Source comp Linux/Mac-----> <!-----Source comp Linux/Mac----->
-<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: \\ <code>cd <your greenstone folder>   - Use a terminal to extract the downloaded file's contents into your Greenstone installation folder: \\ <code>cd <your greenstone folder>
Line 107: Line 127:
 ./makegli.sh ./makegli.sh
 ./makejar.sh ./makejar.sh
-</code> \\ **Note** that some Linux machines don't need gnome-lib at all, in which case, the first compilation step above would just be ''./makegs2.sh''. To tell whether your Linux machine needs gnome-lib, try compiling it without it first. If compilation fails during wvware, then you need gnome-lib. The Mac Mountain Lion and Leopard machines we tested it on required gnome-lib. +</code> 
-</TAB>+**Note** that some Linux and Mac machines may require to you to export ''CFLAGS="-fPIC $CFLAGS"'' before running the ''./makegs2.sh'' script. If compilation fails when the ''CFLAGS'' has not been set to include ''-fPIC'', then try 
 +<pre> 
 +export CFLAGS="-fPIC $CFLAGS" 
 +make distclean 
 +makegs2.sh gnome-lib 
 +</pre> 
 +**Note** also that some Linux machines don't need gnome-lib at all, in which case, the first compilation step above would just be ''./makegs2.sh''. To tell whether your Linux machine needs gnome-lib, try compiling it without it first. If compilation fails during wvware, then you need gnome-lib. The Mac Mountain Lion and Leopard machines we tested it on required gnome-lib.\\ Note also that on 64 bit unix systems, ''-fPIC'' is automatically prepended to the ''CFLAGS'' environment variable by the ''./makegs2.sh'' script, as this tends to be needed for compiling.
 <!-----Source comp Win-----> <!-----Source comp Win----->
-<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**
 <code>@echo off <code>@echo off
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's gli subfolder: ''cd gli''. Next, type: ''makegli.bat''. To re-compile the GLI jar files, such as used for Remote Greenstone situations, type: ''makejar.bat''.   - If you want to re-compile GLI go into your Greenstone's gli subfolder: ''cd gli''. Next, type: ''makegli.bat''. To re-compile the GLI jar files, such as used for Remote Greenstone situations, type: ''makejar.bat''.
-</TAB>+
 <!-----Source dist Linux/Mac-----> <!-----Source dist Linux/Mac----->
-<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://trac.greenstone.org/browser/gs2-extensions/gnome-lib/trunk \\ Then unzip the downloaded gnome-lib minimal package into your greenstone2-home/ext    - 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://trac.greenstone.org/browser/gs2-extensions/gnome-lib/trunk \\ Then unzip the downloaded gnome-lib minimal package into your greenstone2-home/ext 
Line 155: Line 181:
 </code> \\ **Note** that some Linux machines don't need gnome-lib at all, in which case, the first compilation step above would just be ''./makegs2.sh''. To tell whether your Linux machine needs gnome-lib, try compiling it without it first. If compilation fails during wvware, then you need gnome-lib. The Mac Mountain Lion and Leopard machines we tested it on required gnome-lib. </code> \\ **Note** that some Linux machines don't need gnome-lib at all, in which case, the first compilation step above would just be ''./makegs2.sh''. To tell whether your Linux machine needs gnome-lib, try compiling it without it first. If compilation fails during wvware, then you need gnome-lib. The Mac Mountain Lion and Leopard machines we tested it on required gnome-lib.
   - You will need to enable the Administration pages if you want access to them. Do so by editing your Greenstone installation's ''etc/main.cfg'' file. Change the ''status'' field value from ''disabled'' to ''enabled''. In that case, you may also want to change the admin password for the Adminstration pages. Use a DOS prompt to run: ''gsicontrol.bat configure-admin'' which will allow you to (re)set the password for username ''admin'' (the default admin password is the same as the username). The password has to be between 3 and 8 characters long.   - You will need to enable the Administration pages if you want access to them. Do so by editing your Greenstone installation's ''etc/main.cfg'' file. Change the ''status'' field value from ''disabled'' to ''enabled''. In that case, you may also want to change the admin password for the Adminstration pages. Use a DOS prompt to run: ''gsicontrol.bat configure-admin'' which will allow you to (re)set the password for username ''admin'' (the default admin password is the same as the username). The password has to be between 3 and 8 characters long.
-</TAB> + 
-<!-----Source comp Win-----> +<!-----Source dist Win-----> 
-<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**
 <code>@echo off <code>@echo off
Line 191: Line 217:
   - If you wish to compile up the GLI jar files, such as for Remote Greenstone situations, run the following from within the gli folder: ''makejar.bat''.   - If you wish to compile up the GLI jar files, such as for Remote Greenstone situations, run the following from within the gli folder: ''makejar.bat''.
   - You will need to enable the Administration pages if you want access to them. Do so by editing your Greenstone installation's ''etc/main.cfg'' file. Change the ''status'' field value from ''disabled'' to ''enabled''. In that case, you may also want to change the admin password for the Administration pages. Use a DOS prompt to run: ''gsicontrol.bat configure-admin'' which will allow you to (re)set the password for username ''admin'' (the default admin password is the same as the username). The password has to be between 3 and 8 characters long.   - You will need to enable the Administration pages if you want access to them. Do so by editing your Greenstone installation's ''etc/main.cfg'' file. Change the ''status'' field value from ''disabled'' to ''enabled''. In that case, you may also want to change the admin password for the Administration pages. Use a DOS prompt to run: ''gsicontrol.bat configure-admin'' which will allow you to (re)set the password for username ''admin'' (the default admin password is the same as the username). The password has to be between 3 and 8 characters long.
-</TAB> +</tabbox>
-</TABAREA>+
  
-==== 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. 
- 
-<code> 
-> ./Greenstone-2.86rc2-linux text-only 
----------------------------- 
-Extracting java installer... 
----------------------------- 
- 
-Extraction Complete 
-You can now run "java -jar greenstone.jar text" to run the installer from the command line 
-> 
-</code> 
  
 ==== 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, you can proceed to add a comment. Once you're done leaving comments, you can press the green Logout link.   * 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, you can proceed to add a comment. Once you're done leaving comments, you can press the green Logout link.
  
-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. If you're admin, you can create a user account as follows:
  
 +  - 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 "admin") and password, which will be what you chose upon installing Greenstone.
 +  - 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 "personal-collections-editor".
 +  - Press the Submit button.
  
  
Line 376: Line 395:
 **4. Migrating to 2.86** **4. Migrating to 2.86**
  
-To switch to version 2.86 from an earlier Greenstone version with minimal risks, you could i) back up your collections, ii) install 2.86 in a new home directory (to specified to the installer), and iii) copy the collect sub-directory from the old to the new version. If you are presently using a recent previous version of Greenstone (2.8x), the collections should be immediately available for use; if not, particularly for collections built under older versions of Greenstone, it should suffice to rebuild the collections under the new version. Any problems can be addressed to this list or the main Greenstone users list (http://list.waikato.ac.nz/mailman/listinfo/greenstone-users).+To switch to version 2.86 from an earlier Greenstone version with minimal risks, you could i) back up your collections, ii) install 2.86 in a new home directory (to specified to the installer), and iii) copy the collect sub-directory from the old to the new version. If you are presently using a recent previous version of Greenstone (2.8x), the collections should be immediately available for use; if not, particularly for collections built under older versions of Greenstone, it should suffice to rebuild the collections under the new version. Any problems can be addressed to the greenstone mailing list [[greenstone-users@lists.sourceforge.net]].
  
 If you want to transfer information on users and user groups, the corresponding databases (users.gdb, key.gdb) should be copied from the etc sub-directory in the old collection to the new one. Of course if you have customised your previous version (main.cfg, style.css, macros, etc.), the old versions should also be copied to the new installation. When all is working perfectly, the old installation can be deleted. If you want to transfer information on users and user groups, the corresponding databases (users.gdb, key.gdb) should be copied from the etc sub-directory in the old collection to the new one. Of course if you have customised your previous version (main.cfg, style.css, macros, etc.), the old versions should also be copied to the new installation. When all is working perfectly, the old installation can be deleted.
Line 497: Line 516:
 These instructions are more Greenstone 2.86-specific than the [[http://wiki.greenstone.org/wiki/index.php/Remote_Greenstone|general instructions]] for setting up Greenstone 2 as a remote server.  These instructions are more Greenstone 2.86-specific than the [[http://wiki.greenstone.org/wiki/index.php/Remote_Greenstone|general instructions]] for setting up Greenstone 2 as a remote server. 
  
-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' backward slash (\) when specifying file paths.+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' backward slash (\) when specifying file paths.
  
  
Line 577: Line 596:
  
 **Useful resources** **Useful resources**
-  * [[http://wiki.greenstone.org/wiki/images/d/dd/GS_OAI.pdf|Diego Spano's presentation on Greenstone and OAI.]] This gives a good background about OAI, as well as a very useful overview of Greenstone's OAI support.+  * [[http://wiki.greenstone.org/lib/exe/fetch.php?media=gs_oai.pdf|Diego Spano's presentation on Greenstone and OAI.]] This gives a good background about OAI, as well as a very useful overview of Greenstone's OAI support.
  
  
Line 1027: Line 1046:
  
 **Important:** If you are one of our valued translators and have contributed again since the 2.85 release, and we missed adding your name here due to unfortunate oversight, then your name belongs in the above list. Therefore please contact us and we'll be thrilled to add you in here. **Important:** If you are one of our valued translators and have contributed again since the 2.85 release, and we missed adding your name here due to unfortunate oversight, then your name belongs in the above list. Therefore please contact us and we'll be thrilled to add you in here.
 +
en/release/2.86_release_notes.1468301185.txt.gz · Last modified: 2016/07/12 05:26 (external edit)