Changeset 20091

Show
Ignore:
Timestamp:
27.07.2009 16:11:31 (10 years ago)
Author:
kjdon
Message:

added some notes about tomcat/java

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • greenstone3/trunk/README.txt

    r19839 r20091  
    1313See the README-SVN.txt file for extra notes about installing directly from SVN. 
    1414 
    15 Greenstone 3 requires Java and Ant to run. These may be installed during  
    16 Greenstone installation. 
     15Greenstone 3 requires Java and Ant to run. These will be installed during a 
     16Greenstone binary installation. 
    1717 
    1818Running Greenstone: 
     
    3030Greenstone). You will need to manually start/stop an external Tomcat  
    3131(see below for notes about using a version of Tomcat external to Greenstone). 
     32 
     33You will need to run 'gs3-setup' (Windows) or 'source gs3-setup.sh' (Linux/Mac) 
     34before running ant targets. 
    3235 
    3336Once the Tomcat server is running, Greenstone will be available in a browser  
     
    4548 
    4649You can build collections using the Greenstone Librarian Interface (GLI).  
    47 To start GLI, select it from the Start Menu (Windows), run 'ant gli" from the  
     50To start GLI, select it from the Start Menu (Windows), run 'ant gli' from the  
    4851greenstone3 directory, or cd to greenstone3/gli and run gli.sh/bat.  
    4952 
    5053Once you have created and built a collection, you can see it by clicking 'Preview collection' on the Build panel. 
     54 
     55Java/Tomcat Notes 
     56-------------------------------------------------------- 
     57 
     58Binary releases of Greenstone are compiled with Java 1.5 and come with JRE 1.5 and Tomcat 6. Tomcat 6 does not work with Java 1.4. 
     59 
     60To recompile the source from a binary release:  
     61* Download the source code component and unpack into Greenstone3 directory. 
     62* You will need to install a JDK, 1.5 or later. 
     63* Rename the packages/jre folder to something else (eg jre.old) 
     64* Set JAVA_HOME environment to be the root of your Java installation. 
     65* run 'ant install' 
     66 
     67If you wish to use Java 1.4: 
     68* Do all the above steps but before running ant install, 
     69* delete packages/tomcat/.flagfile and run 'ant prepare-tomcat' to get Tomcat 5. 
     70 
     71Greenstone 3 from SVN will download Tomcat 5 if you are using Java 1.4, otherwise will download Tomcat 6. 
    5172 
    5273Greenstone Admin