old:user_advanced:installation
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
old:user_advanced:installation [2021/09/30 02:50] – created anupama | old:user_advanced:installation [2023/07/20 11:23] (current) – [Source Distribution] anupama | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | |||
+ | |||
+ | |||
Up to date for GS3.10, checked 20 Feb 2021. | Up to date for GS3.10, checked 20 Feb 2021. | ||
This page is up to date for 3.06 (5 November 2014). Much of it was checked again to be up to date after 3.08. | This page is up to date for 3.06 (5 November 2014). Much of it was checked again to be up to date after 3.08. | ||
Line 94: | Line 97: | ||
To make it easier for developers, a batch file containing placeholders you can adjust is already prepared and discussed at [[http:// | To make it easier for developers, a batch file containing placeholders you can adjust is already prepared and discussed at [[http:// | ||
==== Source Component ==== | ==== Source Component ==== | ||
- | <TABAREA tabs="Greenstone3, | + | <tabbox |
- | <TAB> | + | |
**Note:** Greenstone 3 does not at present compile successfully if it was installed in a place containing spaces. The solution is to move the installed GS3 folder out into a different location, one without spaces in the filepath, //before// compiling. Once compiling is done, you can move your installed GS3 folder back to its original location. | **Note:** Greenstone 3 does not at present compile successfully if it was installed in a place containing spaces. The solution is to move the installed GS3 folder out into a different location, one without spaces in the filepath, //before// compiling. Once compiling is done, you can move your installed GS3 folder back to its original location. | ||
Line 118: | Line 120: | ||
Therefore, to run GLI after compiling GS3 for 64 bit, add the bin folder of JRE 7 for 64 bit to the PATH, or set JAVA_HOME to JDK 7 64 bit and add its bin folder to the PATH. Then run GLI in this environment. | Therefore, to run GLI after compiling GS3 for 64 bit, add the bin folder of JRE 7 for 64 bit to the PATH, or set JAVA_HOME to JDK 7 64 bit and add its bin folder to the PATH. Then run GLI in this environment. | ||
- | </TAB> | + | <tabbox Greenstone2> |
- | <TAB> | + | |
- Get the source component zip file from the downloads page. | - Get the source component zip file from the downloads page. | ||
- Unzip it in your Greenstone installation. If Windows prompts you about whether you want existing folders merged (and existing files replaced), tick the box to confirm for all and click in the affirmative. | - Unzip it in your Greenstone installation. If Windows prompts you about whether you want existing folders merged (and existing files replaced), tick the box to confirm for all and click in the affirmative. | ||
Line 133: | Line 134: | ||
**Note:** Building collections that use lucene as their indexer requires Java. If you compiled up GS2 using a later version of Java than the version of JRE included in the binary (Java 7), then building a lucene collection may produce error messages about incompatible java versions. In such a case, rename your GS2 installation '' | **Note:** Building collections that use lucene as their indexer requires Java. If you compiled up GS2 using a later version of Java than the version of JRE included in the binary (Java 7), then building a lucene collection may produce error messages about incompatible java versions. In such a case, rename your GS2 installation '' | ||
- | </TAB> | + | </tabbox> |
- | </ | + | |
==== Source Distribution ==== | ==== Source Distribution ==== | ||
- | <TABAREA tabs="Greenstone3, | + | <tabbox |
- | <TAB> | + | |
- Get the source distribution zip file from the downloads page. | - Get the source distribution zip file from the downloads page. | ||
- //Unzip it in a location with no spaces in the filepath.// | - //Unzip it in a location with no spaces in the filepath.// | ||
Line 149: | Line 148: | ||
To run GLI or the gs3-server after compiling the source code on a 64 bit Windows machine, you need your environment to be set up with JDK 7+ (or JRE 7+) for 64-bit and Ant: set the JAVA_HOME environment variable to your 64 bit JDK and add the JDK's '' | To run GLI or the gs3-server after compiling the source code on a 64 bit Windows machine, you need your environment to be set up with JDK 7+ (or JRE 7+) for 64-bit and Ant: set the JAVA_HOME environment variable to your 64 bit JDK and add the JDK's '' | ||
- | </TAB> | + | <tabbox Greenstone2> |
- | <TAB> | + | |
- Get the source distribution zip file from the downloads page. | - Get the source distribution zip file from the downloads page. | ||
- Unzip it | - Unzip it | ||
Line 164: | Line 162: | ||
- 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' | ||
- If you don't already have an imagemagick installed and want to have // | - If you don't already have an imagemagick installed and want to have // | ||
- | </TAB> | + | </tabbox> |
- | </ | + | |
Line 184: | Line 181: | ||
which can be accomplished using the file '' | which can be accomplished using the file '' | ||
- | <TABAREA tabs="Greenstone3, | + | <tabbox |
- | <TAB> | + | |
Run the following: | Run the following: | ||
< | < | ||
Line 193: | Line 189: | ||
ant install | ant install | ||
</ | </ | ||
- | </TAB> | + | <tabbox Greenstone2> |
- | <TAB> | + | |
Then run: | Then run: | ||
< | < | ||
Line 201: | Line 196: | ||
* Choose yes twice | * Choose yes twice | ||
* Choose step 4 to compile ALL without debugging | * Choose step 4 to compile ALL without debugging | ||
- | </TAB> | + | </tabbox> |
- | </ | + | |
For more detailed instructions on source installation, | For more detailed instructions on source installation, | ||
Line 216: | Line 210: | ||
==== Source Component ==== | ==== Source Component ==== | ||
- | <TABAREA tabs="Greenstone3, | + | <tabbox |
- | <TAB> | + | |
- Download and extract the Source Component for your Operating System into the top-level folder of your Greenstone 3 binary installation. For Linux/Mac, download the tar.gz version as zip doesn' | - Download and extract the Source Component for your Operating System into the top-level folder of your Greenstone 3 binary installation. For Linux/Mac, download the tar.gz version as zip doesn' | ||
- | - Set up ant and Java: set JAVA_HOME (to JDK 7 for Greenstone 3.06) and add its '' | + | - Set up ant and Java: set JAVA_HOME (to JDK 7 for Greenstone 3.06, JDK 8 for Greenstone 3.11 onwards) and add its '' |
export JAVA_HOME=/ | export JAVA_HOME=/ | ||
export ANT_HOME=/ | export ANT_HOME=/ | ||
export PATH=$JAVA_HOME/ | export PATH=$JAVA_HOME/ | ||
- | </ | + | </ |
export CXXFLAGS=" | export CXXFLAGS=" | ||
- | export JNICFLAGS=" | + | export JNICFLAGS=" |
export CXXFLAGS=" | export CXXFLAGS=" | ||
- | - The Java Runtime (JRE) included in binaries from Greenstone 3.07 onward is version 7. For 32 bit linux binaries, the included JRE is 32 bit and for 64 bit linux binaries the JRE is 64 bit. //If you have set up a system Java of a version different from the JRE included//, then \\ | + | - The Java Runtime (JRE) included in binaries from Greenstone 3.07 onward is version 7 and version 8 for Greenstone 3.11 onward. For 32 bit linux binaries, the included JRE is 32 bit and for 64 bit linux binaries the JRE is 64 bit. //If you have set up a system Java of a version different from the JRE included//, then \\ |
* rename the '' | * rename the '' | ||
* run '' | * run '' | ||
Line 250: | Line 243: | ||
The gnome-lib environment may conflict with graphical applications on Linux systems. After compiling, open a fresh terminal to run GLI or other graphical applications. But make sure the new terminal has the environment set up for Java and Ant too before running any Greenstone applications like the Greenstone Server (gs3-server) and GLI. | The gnome-lib environment may conflict with graphical applications on Linux systems. After compiling, open a fresh terminal to run GLI or other graphical applications. But make sure the new terminal has the environment set up for Java and Ant too before running any Greenstone applications like the Greenstone Server (gs3-server) and GLI. | ||
- | </ | + | |
- | <!-- ############# | + | |
- | <TAB> | + | <tabbox Greenstone2> |
- Download the Source Component tar.gz file that matches with your Greenstone binary version, and put it in your Greenstone installation folder. For Linux/Mac, you want the tar.gz version because the zip version doesn' | - Download the Source Component tar.gz file that matches with your Greenstone binary version, and put it in your Greenstone installation folder. For Linux/Mac, you want the tar.gz version because the zip version doesn' | ||
- 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 328: | Line 321: | ||
where the WebServerName and WebServerPort are what you specified when you [[en: | where the WebServerName and WebServerPort are what you specified when you [[en: | ||
- | </TAB> | + | </tabbox> |
- | </ | + | |
==== Source Distribution ==== | ==== Source Distribution ==== | ||
Line 346: | Line 338: | ||
</ | </ | ||
- | <TABAREA tabs="Greenstone3, | + | <tabbox |
- | <TAB> | + | |
- Download the Source Distribution for your Operating System and extract it into the location where you want Greenstone installed. For Linux/Mac, download the tar.gz version as zip doesn' | - Download the Source Distribution for your Operating System and extract it into the location where you want Greenstone installed. For Linux/Mac, download the tar.gz version as zip doesn' | ||
- | - Make sure JAVA_HOME is set (to JDK 7 for Greenstone 3.06) and that its '' | + | - Make sure JAVA_HOME is set (to JDK 7 for Greenstone 3.06, JDK 8 from Greenstone 3.11 onwards) and that its '' |
- Most of the linux and mac machines we tested require the gnome-lib extension. Without it, if compiling fails with an error message about '' | - Most of the linux and mac machines we tested require the gnome-lib extension. Without it, if compiling fails with an error message about '' | ||
- Use the terminal to extract the downloaded gnome-lib-minimal extension and set up the gnome-lib environment for compiling as follows:\\ < | - Use the terminal to extract the downloaded gnome-lib-minimal extension and set up the gnome-lib environment for compiling as follows:\\ < | ||
cd gs2build/ | cd gs2build/ | ||
- | tar -xvzf gnome-lib-minimal-< | + | cd gnome-lib |
- | cd gnome-lib-minimal | + | # gnome-lib can take longer to compile. |
+ | # Alternatively, | ||
+ | # had grabbed and extracted the gnome-lib-minimal tarball as above, then: | ||
+ | #tar -xvzf gnome-lib-minimal-< | ||
+ | #cd gnome-lib-minimal | ||
source ./ | source ./ | ||
cd ../../.. | cd ../../.. | ||
</ | </ | ||
- | - If you're on Mac OS version 10.11/El Capitan, set CFLAGS, CXXFLAGS and JNIFLAGS as follows: \\ < | + | - **If you're on Mac OS version 10.11/El Capitan**, set CFLAGS, CXXFLAGS and JNIFLAGS as follows: \\ < |
export CXXFLAGS=" | export CXXFLAGS=" | ||
- | export JNICFLAGS=" | + | export JNICFLAGS=" |
export CXXFLAGS=" | export CXXFLAGS=" | ||
- In the same terminal, you can now finally run '' | - In the same terminal, you can now finally run '' | ||
Line 372: | Line 367: | ||
The gnome-lib environment may conflict with graphical applications on Linux systems. After compiling, open a fresh terminal to run GLI or other graphical applications. Make sure the new terminal has the environment set up for Java and Ant too before running any Greenstone applications like the Greenstone Server (gs3-server) and GLI. | The gnome-lib environment may conflict with graphical applications on Linux systems. After compiling, open a fresh terminal to run GLI or other graphical applications. Make sure the new terminal has the environment set up for Java and Ant too before running any Greenstone applications like the Greenstone Server (gs3-server) and GLI. | ||
- | </ | + | |
- | <!-- ####################################################### | + | |
- | <TAB> | + | <tabbox Greenstone2> |
- Download the Source Distribution and extract it. For Linux/Mac, please use the tar.gz version as zip doesn' | - Download the Source Distribution and extract it. For Linux/Mac, please use the tar.gz version as zip doesn' | ||
- 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 386: | Line 381: | ||
- 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> |
- | </ | + | |
==== Uptodate source code from SVN ==== | ==== Uptodate source code from SVN ==== | ||
- | <TABAREA tabs="Greenstone3, | + | <tabbox |
- | <TAB> | + | |
- Make sure you have SVN installed and on your Path | - Make sure you have SVN installed and on your Path | ||
Line 440: | Line 433: | ||
</ | </ | ||
- | </TAB> | + | <tabbox Greenstone2> |
- | <TAB> | + | |
- First grab all the source code from SVN by running the following commands in your terminal \\ < | - First grab all the source code from SVN by running the following commands in your terminal \\ < | ||
svn co http:// | svn co http:// | ||
Line 455: | Line 447: | ||
</ | </ | ||
- 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> |
- | </ | + | |
Line 574: | Line 565: | ||
- To get the local library server (server.exe) to work from the new location: if your top-level Greenstone installation folder contains the files llssite.cfg and glisite.cfg, | - To get the local library server (server.exe) to work from the new location: if your top-level Greenstone installation folder contains the files llssite.cfg and glisite.cfg, | ||
- To get the Apache web server included with Greenstone to work: delete the file lib\java\log4j.properties. (Doing so will ensure that if you execute the gs2-server.bat file--which launches the Greenstone Server Interface--this properties file will be regenerated with the correct value for gsdlhome.) | - To get the Apache web server included with Greenstone to work: delete the file lib\java\log4j.properties. (Doing so will ensure that if you execute the gs2-server.bat file--which launches the Greenstone Server Interface--this properties file will be regenerated with the correct value for gsdlhome.) | ||
- | |||
old/user_advanced/installation.txt · Last modified: 2023/07/20 11:23 by anupama