en:user_advanced:installation
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:user_advanced:installation [2023/07/29 09:18] – [Source Distribution] anupama | en:user_advanced:installation [2023/08/03 03:07] (current) – [Source Distribution] anupama | ||
---|---|---|---|
Line 204: | Line 204: | ||
- If you wish to compile up the GLI jar files, such as for Remote Greenstone situations, run the following from within the gli 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: '' | ||
- 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 |
</ | </ | ||
Line 272: | Line 272: | ||
<tabbox Greenstone3> | <tabbox Greenstone3> | ||
- 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 400: | Line 400: | ||
<tabbox Greenstone3> | <tabbox Greenstone3> | ||
- 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, | ||
+ | # as per instructions above, then run the following commands: | ||
+ | #mv gnome-lib gnome-lib.orig | ||
+ | #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 a Mac OS version |
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 419: | Line 424: | ||
> export PERL_MM_OPT= | > export PERL_MM_OPT= | ||
> ant install</ | > ant install</ | ||
+ | - **For Mac OS, from El Capitan onwards:** If you don't already have an imagemagick installed on your system and want to have // | ||
**Note:** | **Note:** | ||
- | 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 (version 8 from GS3.11 and onwards) |
<tabbox Greenstone2> | <tabbox Greenstone2> |
en/user_advanced/installation.1690622337.txt.gz · Last modified: 2023/07/29 09:18 by anupama