Differences

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

--- en:release:3.11_release_notes [2024/02/11 23:09] – [Mac OS Notes] kjdon
+++ en:release:3.11_release_notes [2024/09/15 22:56] (current) – kjdon
@@ Line 11: / Line 11: @@
 ** Released: **
-   * Binaries for Windows, GNU/Linux 32 and 64 bit machines, a Mac binary for Mac Monterey (OS version 12.6.7)\\ All the binaries have only been spot-tested, since the 3.11 release candidate 1 binaries, which came out some months before, were tested more extensively on all the tutorials. Source distributions and source components have been tested (in week of 28 July 2023) to compile on Mac Monterey/12.6.7, Windows 10, Ubuntu 32 (12.04) and 64 bit (20.04.6 LTS). \\ [[http://svn.greenstone.org/main/tags/3.11/|svn tag page]] [[https://trac.greenstone.org/browser/main/tags/3.11|trac tag page]]. Code revision up to 37940. Tag revision: 37949.
+   * Binaries for Windows, GNU/Linux 32 and 64 bit machines, a Mac binary for Mac Monterey (OS version 12.6.7)
+   * Download from [[https://www.greenstone.org/download]]
+   * All the binaries have only been spot-tested, since the 3.11 release candidate 1 binaries, which came out some months before, were tested more extensively on all the tutorials. Source distributions and source components have been tested (in week of 28 July 2023) to compile on Mac Monterey/12.6.7, Windows 10, Ubuntu 32 (12.04) and 64 bit (20.04.6 LTS). \\ [[http://svn.greenstone.org/main/tags/3.11/|svn tag page]] [[https://trac.greenstone.org/browser/main/tags/3.11|trac tag page]]. Code revision up to 37940. Tag revision: 37949.
       * The Mac binary is generated on Monterey/12.6.7 (a VM). For rc1, most of the testing work was done on the same Monterey/12.6.7. The final release's spot-testing was also done on a Monterey/12.6.7, but slightly distinct: the physical machine that runs the release virtual machine/VM. (There was a fix made after the release candidate 1 was released, when we noticed the installed Mac Monterey's GS3-server and GLI had issues launching on a Monterey other than the VM it had been generated on.)
       * The Windows release candidate 1 binary was tested on Windows 10, and the final release also spot tested on the same.
@@ Line 30: / Line 33: @@
 ==== Installing and running the binary release====
-  * Download the appropriate binary release for your operating system and run it.
+  * [[https://www.greenstone.org/download | Download]] the appropriate binary release for your operating system and run it.
 === Mac OS Notes ===
@@ Line 44: / Line 47: @@
 === Linux Notes ===
-  * You will need to set the file to be executable before running it. e.g. \\ In a terminal ''chmod a+x Greenstone-3.11-linux''\\ or on Ubuntu, you can right-click on the installer, choose Properties, Go to the Permissions tab and ensure the "Execute: Allow executing file as program" tickbox is ticked.
+  * You will need to set the file to be executable before running it. e.g. \\ In a terminal ''chmod a+x Greenstone-3.11-linux-x64''\\ or on Ubuntu, you can right-click on the installer, choose Properties, Go to the Permissions tab and ensure the "Execute: Allow executing file as program" tickbox is ticked.
     * The installer initially unpacks into a temporary directory (/tmp on linux). If you wish to change this, set the TMPDIR environment variable.
 Note that in some cases, the following **doesn't** work
 <code> export TMPDIR=/something/else
- ./Greenstone-3.11-linux</code>
+ ./Greenstone-3.11-linux-x64</code>
 Use the following instead
-<code> TMPDIR=/something/else ./Greenstone-3.11-linux</code>
+<code> TMPDIR=/something/else ./Greenstone-3.11-linux-x64</code>
 ===Windows Notes ===
@@ Line 66: / Line 69: @@
   * Choosing a password for the administration pages. These pages allow the admin user to inspect and manage the list of registered Greenstone users. You can add new users, and change group settings for existing users. Greenstone user registration is needed if you want to use remote GLI login to the Greenstone server, or if you want to make collections/documents only accessible by certain groups of users. (//If the password is not set during installation, the default password for the 'admin' user is 'admin'. You can change the password any time after installation, by running the Greenstone 3 server and visiting the Administration pages. See [[#disabling_admin_access_in_installer| below]]//).
-==== Running Greenstone ====
+==== Running the installer in text-only mode ====
-Once you have successfully installed Greenstone3, you can start up the server by choosing Grenstone3 Digital Library from the Start menu (Windows) or running gs3-server.sh/bat. This launches a small server program which starts up Tomcat and launches a browser. A small window pops up which allows you to change some settings for your library and restart the Tomcat server. Closing this program will stop Tomcat running. By default, your library will be available at localhost:8383/greenstone3/library. File->Settings in the Greenstone Server window gives you options to change the port number and which browser it uses by default.
-More notes about running Greenstone can be found in the README.txt file in the top level Greenstone folder.
-==== Building Collections ====
-To build collections, run GLI from the Start menu (Windows) or by running gli/gli.sh/bat in the top level Greenstone3 folder. Tutorial exercises about building collections in Greenstone 3 can be found [[en:tutorials | here]]. Make sure you select the Greenstone3 tab at the top if it is not already selected.
-==== Installing in text-only mode ====
+You may want to run in text-only mode if you are installing on a headless server for example.
-* Refer to [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#running_the_installer_in_text-only_mode|Running the installer in text-only mode]]
+  - If you're on Linux or Mac, give the binary of the installer execute permissions
+  - Then run it by passing in the -textonly flag, as shown below.
+  - Follow the instructions on the screen thereafter. If you mistype at any stage, press ctrl-C to start again.
+<code>
+> ./Greenstone-3.11-linux-x64 -textonly
+</code>
 ==== Adding source code to a binary release ====
@@ Line 86: / Line 88: @@
   * [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#source_distribution|Windows: Source Distribution instructions]]
   * [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#source_distribution1|Linux/Mac: Source Distribution instructions]]
+===== Running Greenstone =====
+Once you have successfully installed Greenstone3, you can start up the server by choosing Grenstone3 Digital Library from the Start menu (Windows) or running gs3-server.sh/bat. This launches a small server program which starts up Tomcat and launches a browser. A small window pops up which allows you to change some settings for your library and restart the Tomcat server. Closing this program will stop Tomcat running. By default, your library will be available at localhost:8383/greenstone3/library. File->Settings in the Greenstone Server window gives you options to change the port number and which browser it uses by default.
+More notes about running Greenstone can be found in the README.txt file in the top level Greenstone folder.
+==== On a Mac ====
+You can either
+  - open a terminal, navigate to the folder you installed Greenstone in, and run ./gs3-server.sh
+  - Open Finder. Use menu option Go->Go To Folder, and type in the folder where you installed Greenstone (eg /Users/kjdon/Greenstone3). Then there are 3 round greenstone icons like: {{ :wiki:favicon.ico |}}
+    - gs3-server - double clicking will start the library server, and open a browser to your library home page
+    - gli - starts the librarian interface, which you can use to build/edit collections.
+    - gems - used for editing metadata sets.
+==== Building Collections =====
+To build collections, run GLI from the Start menu (Windows) or by running gli/gli.sh (gli/gli.bat on windows) in a terminal cd'd to the top level Greenstone3 folder. Tutorial exercises about building collections in Greenstone 3 can be found [[en:tutorials | here]]. Make sure you select the Greenstone3 tab at the top if it is not already selected.