en:user_advanced:installation
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
en:user_advanced:installation [2018/06/26 09:44] – [Uptodate source code from SVN] anupama | en:user_advanced:installation [2019/05/29 09:06] – [Source Component] anupama | ||
---|---|---|---|
Line 24: | Line 24: | ||
Prerequisites for compiling the source component and source distribution on Windows: | Prerequisites for compiling the source component and source distribution on Windows: | ||
* Java JDK 6.x or later. For compiling on Windows 64 bit, need the 64 bit version of JDK. For compiling Greenstone 3.06 and onwards, need JDK 7.x or later. | * Java JDK 6.x or later. For compiling on Windows 64 bit, need the 64 bit version of JDK. For compiling Greenstone 3.06 and onwards, need JDK 7.x or later. | ||
- | * PERL: if you're using GS3.07 or earlier, get ActivePerl for Windows. From GS3.08 onwards, binaries and source distributions come with a Strawberry Perl located in the GS3's '' | + | * PERL: if you're using GS3.07 or earlier, get ActivePerl for Windows. From GS3.08 onwards, binaries and source distributions come with a [[http:// |
* Visual Studio 8 or later (Visual Studio 12 on 64 bit Windows 10 worked too.) | * Visual Studio 8 or later (Visual Studio 12 on 64 bit Windows 10 worked too.) | ||
* (If you want to compile GS2 or GS3 with debugging on, you will need Microsoft SDK) | * (If you want to compile GS2 or GS3 with debugging on, you will need Microsoft SDK) | ||
Line 92: | Line 92: | ||
<TABAREA tabs=" | <TABAREA tabs=" | ||
<TAB> | <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. | ||
+ | |||
- Get the source component zip file from the downloads page. | - Get the source component zip file from the downloads page. | ||
- Unzip it directly into your Greenstone installation folder, make sure not to create intermediary folders. 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 directly into your Greenstone installation folder, make sure not to create intermediary folders. 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 98: | Line 100: | ||
- Go into your Greenstone installation folder, '' | - Go into your Greenstone installation folder, '' | ||
- The Java Runtime (JRE) included with Greenstone 3 binaries is a 32 bit Java 7 runtime. This means that //if the Windows machine that you're recompiling the binary with the source component on is not 32 bit Java 7 too//, then you will need to do the following before compiling \\ | - The Java Runtime (JRE) included with Greenstone 3 binaries is a 32 bit Java 7 runtime. This means that //if the Windows machine that you're recompiling the binary with the source component on is not 32 bit Java 7 too//, then you will need to do the following before compiling \\ | ||
- | * run '' | ||
- | * you may also want to want to delete '' | ||
* rename '' | * rename '' | ||
+ | * run '' | ||
+ | * you may also want to want to delete '' | ||
- Finally, you can compile Greenstone 3. Still in your Greenstone installation folder, run '' | - Finally, you can compile Greenstone 3. Still in your Greenstone installation folder, run '' | ||
Line 168: | Line 170: | ||
In addition to the Prerequisites for compiling Greenstone on Windows listed above, to install Greenstone from SVN source on Windows, you need to [[en: | In addition to the Prerequisites for compiling Greenstone on Windows listed above, to install Greenstone from SVN source on Windows, you need to [[en: | ||
+ | |||
+ | (**NOTE:** Some of the prerequisite packages are available from greenstone' | ||
SVN, ANT, and JAVA must be put on PATH and Visual Studio must be set up for compiling the C/C++ code, | SVN, ANT, and JAVA must be put on PATH and Visual Studio must be set up for compiling the C/C++ code, | ||
- | which can be accomplished using this file: | + | which can be accomplished using the file '' |
- | < | + | |
- | vcvars< | + | |
- | </ | + | |
<TABAREA tabs=" | <TABAREA tabs=" | ||
Line 203: | Line 204: | ||
* [[en: | * [[en: | ||
* ANT | * ANT | ||
- | * Java JDK. JDK 7 for Greenstone 3.06 and onwards | + | * Java JDK. JDK 7 for Greenstone 3.06 and onwards. \\ **WARNING: |
* C/C++ compiler: XCode on Mac, gcc/g++ on Linux | * C/C++ compiler: XCode on Mac, gcc/g++ on Linux | ||
Line 216: | Line 217: | ||
</ | </ | ||
export CXXFLAGS=" | export CXXFLAGS=" | ||
- | export JNICFLAGS=" | + | export JNICFLAGS=" |
+ | 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. 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 '' | ||
- | * you may also want to want to delete '' | + | * you may also want to want to delete '' |
- | - Most of the linux and mac machines we tested require the gnome-lib extension. Without it, if compilation fails with an error message about '' | + | - Most of the linux and mac machines we tested require the gnome-lib extension. Without it, if compilation 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/ | ||
Line 350: | Line 352: | ||
- 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=" | ||
- In the terminal, you can now finally run '' | - In the terminal, you can now finally run '' | ||
> env | grep INSTALL | > env | grep INSTALL | ||
Line 386: | Line 389: | ||
export JAVA_HOME=/ | export JAVA_HOME=/ | ||
export ANT_HOME=/ | export ANT_HOME=/ | ||
- | export PATH=$JAVA_HOME/ | + | export PATH=$JAVA_HOME/ |
- | $ANT_HOME/ | + | |
</ | </ | ||
- Checkout the code: < | - Checkout the code: < | ||
Line 400: | Line 402: | ||
- If you want to compile imagemagick from source on Unix systems (though for Mac you can also use the precompiled imagemagick binary*), < | - If you want to compile imagemagick from source on Unix systems (though for Mac you can also use the precompiled imagemagick binary*), < | ||
checkout.imagemagick.ext=true | checkout.imagemagick.ext=true | ||
- | </ | + | </ |
- | - 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 |
export CXXFLAGS=" | export CXXFLAGS=" | ||
- | export JNICFLAGS=" | + | export JNICFLAGS=" |
+ | export CXXFLAGS=" | ||
- Finally, you can start the steps for building GS3 from SVN: < | - Finally, you can start the steps for building GS3 from SVN: < | ||
ant prepare</ | ant prepare</ | ||
Line 421: | Line 424: | ||
</ | </ | ||
- | * If you want imagemagick and ghostscript on a mac, check out the precompiled binaries from svn | + | * If you want imagemagick and ghostscript on a mac, check out the precompiled binaries from svn **after** the '' |
< | < | ||
Line 435: | Line 438: | ||
cd greenstone2 | cd greenstone2 | ||
svn co http:// | svn co http:// | ||
- | cd / | ||
</ | </ | ||
- If you want to compile up gnome-lib yourself, skip this step. If you want to use a pre-compiled gnome-lib binary, 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, download the gnome-lib-minimal package for your OS by visiting http:// | ||
Line 455: | Line 457: | ||
==== 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 | - If you're on Linux or Mac, give the binary of the installer execute permissions | ||
- | - Then run it by passing in the text-only flag, as shown below. | + | - Then run it by passing in the -textonly |
- Follow the instructions on the screen thereafter. If you mistype at any stage, press ctrl-C to start again. | - Follow the instructions on the screen thereafter. If you mistype at any stage, press ctrl-C to start again. | ||
< | < | ||
- | > ./ | + | > ./ |
- | ---------------------------- | + | |
- | Extracting java installer... | + | |
- | ---------------------------- | + | |
- | + | ||
- | Extraction Complete | + | |
- | You can now run "java -jar greenstone.jar text" to run the installer from the command line | + | |
- | > | + | |
</ | </ | ||
+ | |||
+ | **NOTE:** Previously, the instructions for running the installer in text-only mode were incorrect. They advised running the installer wrongly using '' | ||
+ | |||
===== Installation for a networked lab environment ===== | ===== Installation for a networked lab environment ===== | ||
Line 484: | Line 482: | ||
* set '' | * set '' | ||
- | * set '' | + | * set '' |
* set '' | * set '' | ||
* set '' | * set '' | ||
- | Set all the property values exactly as above, except '' | + | Set all the property values exactly as above, except '' |
Now if you replicate the installation to other machines in the lab, your users can log into any machine and continue working with Greenstone3. | Now if you replicate the installation to other machines in the lab, your users can log into any machine and continue working with Greenstone3. |
en/user_advanced/installation.txt · Last modified: 2023/08/03 03:07 by anupama