Differences

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

--- en:release:2.87_release_notes [2024/08/12 22:09] – [Working with Remote Greenstone and the GLI-Client] kjdon
+++ en:release:2.87_release_notes [2025/08/07 23:50] (current) – [For those migrating from earlier versions] kjdon
@@ Line 42: / Line 42: @@
 ==== Installing in text-only mode ====
-* Refer to [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#running_the_installer_in_text-only_mode|Running the installer in text-only mode]].
+* Refer to [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation_287#running_the_installer_in_text-only_mode|Running the installer in text-only mode]].
 ==== Adding source code to a binary release ====
-Make sure to select the "Greenstone 2" tab of:
-  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#source_component|Windows: Source Component instructions]]
+  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation_287#source_component|Windows: Source Component instructions]]
-  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#source_component1|Linux/Mac: Source Component instructions]]
+  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation_287#source_component1|Linux/Mac: Source Component instructions]]
 ==== Installing a source release ====
-Make sure to select the "Greenstone 2" tab of:
+  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation_287#source_distribution|Windows: Source Distribution instructions]]
+  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation_287#source_distribution1|Linux/Mac: Source Distribution instructions]]
-  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#source_distribution|Windows: Source Distribution instructions]]
-  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#source_distribution1|Linux/Mac: Source Distribution instructions]]
 When the installation process is finished, you can run the Greenstone Server or the Greenstone Librarian Interface (GLI).
+==== Uninstallation ====
+On Windows, the uninstaller is accessible from the Start menu.
+For most people under Linux systems, a Greenstone installation can be removed with the usual //rm// command. However, by using this method, any collections you've created will also be deleted. If you're on Linux or Mac and wish to uninstall Greenstone, the recommended way to do so is by using the Uninstaller, as this will give you the option to retain your collections. To launch the Uninstaller, you can either run "bash uninstall.sh" from the //uninstall// folder, or will first need to give execute permissions to the uninstall/Uninstall.sh file in your Greenstone installation before you can run it:
+<code>cd uninstall
+chmod u+rx Uninstall.sh
+./Uninstall.sh</code>
 ===== Running the Greenstone Server =====
@@ Line 88: / Line 94: @@
 **To change the GLI interface language**, run GLI, go to the ''File > Preferences'' menu. Then in the General tab, set the Interface Language. If your script is not covered by the Latin 1 charset, then you may also need to set the Font to something that supports your script. In such a case, try setting the value for the ''Font'' field to ''Arial Unicode MS, BOLD, 12''.
-===== Remote Greenstone =====
-The Client-GLI is the version of the Greenstone Librarian Interface that can be run on a machine different to the one that is running the Greenstone server. To be able to run the Client-GLI application, you will need Sun Java 1.5.0 or greater installed and you will need to have:
-  * Java's //bin// folder on your PATH
-  * JAVA_HOME set to point to your Java installation folder
-If you follow Java's installation instructions, they will direct you on how to add the Java installation's bin folder to your system's PATH environment variable and how to set the JAVA_HOME environment variable.
-If on Windows, you can run client-GLI from its shortcut in the Start Menu. On Linux and Mac systems, you would use a terminal to go into your Greenstone installation folder and then run
-<code>./gli/client-gli.sh</code>
-When the client-GLI starts up, a small dialog appears asking you to enter the URL of the remote Greenstone server's gliserver.pl file. This URL generally has the form: %%http://<host>:<port>/greenstone/cgi-bin/gliserver.pl%%, where you have to fill in the host and port values for the remote Greenstone server. After clicking OK, the client-GLI application window will appear. Client-GLI looks and works just like the GLI, except that most of the document processing takes place on the remote machine where the Greenstone server is running.
-  * 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#Working_with_Remote_Greenstone_and_the_GLI-Client | Working with Remote Greenstone and the GLI-Client]].
@@ Line 121: / Line 111: @@
 **NOTE:** If GLI's Preview Button does not succeed in launching the browser with the collection URL, consult [[en:troubleshooting#GLI's_Preview_Button_fails_to_launch_a_web_page| this page]] for a suggested solution.
-==== Uninstallation ====
-On Windows, the uninstaller is accessible from the Start menu.
-For most people under Linux systems, a Greenstone installation can be removed with the usual //rm// command. However, by using this method, any collections you've created will also be deleted. If you're on Linux or Mac and wish to uninstall Greenstone, the recommended way to do so is by using the Uninstaller, as this will give you the option to retain your collections. To launch the Uninstaller, you can either run "bash uninstall.sh" from the //uninstall// folder, or will first need to give execute permissions to the uninstall/Uninstall.sh file in your Greenstone installation before you can run it:
-<code>cd uninstall
-chmod u+rx Uninstall.sh
-./Uninstall.sh</code>
 ===== Important Changes and Bug Fixes =====
@@ Line 255: / Line 238: @@
 **4. Migrating to 2.87**
-To switch to version 2.87 from an earlier Greenstone version with minimal risks, you could i) back up your collections, ii) install 2.87 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.87 from an earlier Greenstone version with minimal risks, you could i) back up your collections, ii) install 2.87 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.