Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
en:release:2.86_release_notes [2016/05/17 16:33]
anupama
en:release:2.86_release_notes [2017/09/27 20:34] (current)
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'​s permissions to executable before you can run it from the terminal. 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'​s permissions to executable before you can run it from the terminal.
  
-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"​). And if you wish to use the Greenstone Administration pages (which will be needed if you want to create user accounts for a Remote Greenstone server), then now is a good time to set a sensible password for that.+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"​). And if you wish to use the Greenstone Administration pages (which will be needed if you want to create user accounts for a Remote Greenstone server), then now is a good time to set a sensible password for that. It has to be between 3 and 8 characters long.
  
   * 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,​ 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 107: Line 124:
 ./​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>​ 
 +**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.
 </​TAB>​ </​TAB>​
 <​!-----Source comp Win----->​ <​!-----Source comp Win----->​
Line 154: Line 178:
 ./​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>​ \\ **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).+  - 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>​ </​TAB>​
 <​!-----Source comp Win----->​ <​!-----Source comp Win----->​
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'​s gli subfolder: ''​cd gli''​. Next, type: ''​makegli.bat''​. Once it's done, you can run gli from the commandline with ''​gli.bat''​ from inside the gli folder, or with ''​gli\gli.bat''​ from the toplevel Greenstone installation folder.   - If you want to run GLI as well, this will need to be compiled. To compile it, go into your Greenstone'​s gli subfolder: ''​cd gli''​. Next, type: ''​makegli.bat''​. Once it's done, you can run gli from the commandline with ''​gli.bat''​ from inside the gli folder, or with ''​gli\gli.bat''​ from the toplevel Greenstone installation 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: ''​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 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).+  - 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>​ </​TAB>​
 </​TABAREA>​ </​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 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,​ 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 483: Line 501:
   * To stop the webserver at any point, from your command window run "​./​gsicontrol.sh web-stop"​ on linux/mac and "​gsicontrol.bat web-stop"​ on windows.   * To stop the webserver at any point, from your command window run "​./​gsicontrol.sh web-stop"​ on linux/mac and "​gsicontrol.bat web-stop"​ on windows.
   * 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 "​./​gsicontrol.sh reset-gsdlhome"​ on Linux and "​gsicontrol.bat reset-gsdlhome"​ on Windows.   * 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 "​./​gsicontrol.sh reset-gsdlhome"​ on Linux and "​gsicontrol.bat reset-gsdlhome"​ on Windows.
-  * 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 "​./​gsicontrol.sh configure-admin"​ on Linux and "​gsicontrol.bat configure-admin"​ on Windows.+  * 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 "​./​gsicontrol.sh configure-admin"​ on Linux and "​gsicontrol.bat configure-admin"​ on Windows. The password has to be between 3 and 8 characters long.
  
 ==== Notes on using GLI ==== ==== Notes on using GLI ====
Line 497: Line 515:
 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 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 "​personal-collections-editor"​.   * In the Groups field, type "​personal-collections-editor"​.
   * Press the Submit button.   * Press the Submit button.
Line 577: Line 595:
  
 **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 688: Line 706:
    * With OpenOffice and the extension installed and the Greenstone environment set up for this, Greenstone'​s Word, PowerPoint and Excel Plugins will have a new option, "​-openoffice_conversion",​ allowing conversion with Open Office instead of the existing converter. Switching on this new option means that more recent Office formats like docx can be included in Greenstone collections and processed by Greenstone.    * With OpenOffice and the extension installed and the Greenstone environment set up for this, Greenstone'​s Word, PowerPoint and Excel Plugins will have a new option, "​-openoffice_conversion",​ allowing conversion with Open Office instead of the existing converter. Switching on this new option means that more recent Office formats like docx can be included in Greenstone collections and processed by Greenstone.
 ====PDFBox==== ====PDFBox====
-  * The PDF Box extension provides support for conversion of PDF documents to text. It supports the latest PDF versions (unlike Greenstone'​s standard pdftohtml program), so is useful for collections with new PDF documents. ​+  * The PDF Box extension provides support for conversion of PDF documents to text. It supports the latest PDF versions (unlike Greenstone'​s standard pdftohtml program), so it'​s ​useful for collections with new PDF documents. ​
    * Download the extension [[http://​trac.greenstone.org/​browser/​main/​tags/​2.86/​gs2-extensions/​pdf-box/​trunk|from here]], which is available in tar.gz and zip formats, and unzip into Greenstone'​s **ext** folder. The PDF Box extension does not require additional software to be installed. ​    * Download the extension [[http://​trac.greenstone.org/​browser/​main/​tags/​2.86/​gs2-extensions/​pdf-box/​trunk|from here]], which is available in tar.gz and zip formats, and unzip into Greenstone'​s **ext** folder. The PDF Box extension does not require additional software to be installed. ​
    * 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 798: Line 816:
 ==== Issues with running Greenstone on Port 80 ==== ==== 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.+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. 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.
Line 806: Line 824:
 If you are dealing with local installations,​ just open Greenstone Server --> File Menu --> Settings and the set the port number: If you are dealing with local installations,​ just open Greenstone Server --> File Menu --> Settings and the set the port number:
  
-{{wiki:port.png}}+{{wiki:gs2_change_port.png}}
  
 ====Problem:​ authenticated collections require constant authentication==== ====Problem:​ authenticated collections require constant authentication====