Ignore:
Timestamp:
2007-02-05T14:37:10+13:00 (15 years ago)
Author:
kjdon
Message:

updated instructions

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/gsdl3/README.txt

    r13383 r13849  
    1717---------------------------------------------------------
    1818
    19 [TODO: check once release is done]
    2019Download the appropriate installer from sourceforge.net/projects/greenstone3 and run it.
    2120
     
    2726---------------------------------------------------------
    2827
    29 To start up the local Tomcat server, run 'ant start'.
    30 'ant restart' and 'ant stop' restarts and shuts down the server.
    31 This will only start/stop a local server (one installed by Greenstone). You will need to manually start/stop external Tomcat.
     28To start up Greenstone, select Greenstone 2 Digital Library from the Start menu (Windows), or run 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 chnage some settings for your library and restart the Tomcat server. Closing this program will stop Tomcat running.
     29
     30Alternatively, you can start Tomcat directly through using Ant. 'ant start', 'ant restart' and 'ant stop' starts, restarts and shuts down Tomcat, respectively. This will only start/stop a local server (one installed by Greenstone). You will need to manually start/stop an external Tomcat (see below for notes about using a version of Tomcat external to Greenstone).
    3231
    3332Once the Tomcat server is running, Greenstone will be available in a browser at "http://localhost:8080/greenstone3" (or whatever port you specified during the
    3433installation process).
    35 You can change the port number by changing the 'tomcat.port' property in build.properties, then running 'ant configure'.
    36 
    37 [TODO: notes about running server program]
     34You can change the port number using File->Settings in the server program, or by changing the 'tomcat.port' property in build.properties, then running 'ant configure'.
    3835
    3936Building Collections:
     
    4845Note that GLI doesn't start up the Greenstone Tomcat server so you should
    4946run 'ant start' before previewing your collection.
     47
     48
    5049Greenstone Admin
    5150------------------------------------------------------
    5251
    53 [TODO: notes about admin tool]
     52The Greenstone admin tool is currently under development.
    5453
    5554Using SOAP:
     
    6261To set up a SOAP server on a new site, run
    6362ant soap-deploy-site
    64 This will prompt you for the sitename (the directory name), and the site uri - this should be a unique identifier for the site's web service.
     63This will prompt you for the sitename (the directory name), and the site uri - this should be a unique identifier for the site's web service. 
    6564
    6665For a non-interactive version, run
     
    7069(or http://<computer-web-address>:<port>/greenstone3/services/<siteuri>)
    7170
     71Note: Deploying a SOAP service for any site other than localsite requires the Greenstone source code to be installed. This is not installed by default for a binary distribution. To get the source code, re-run the installer, select custom install and deselect everything except the source code.
    7272
    7373Using External Tomcat:
     
    7575
    7676If you want to use an existing Tomcat, set the path to its base directory
    77 in build.properties (tomcat.installed.path) 
     77in build.properties (tomcat.installed.path). Also set the tomcat.port property to be the port you are running Tomcat on, and change tomcat.server if the web address is not localhost. Then run 'ant configure'.
    7878
    7979 You will need to modify the Tomcat setup slightly.
     
    81811. Tell Tomcat about the Greenstone web app. There are two ways to do this.
    8282
    83 A. Copy the file greenstone3/resources/tomcat/greenstone3.xml into Tomcat's conf/Catalina/localhost directory. You'll need to edit the file and replace @gsdl3webdir@ with the full path to the web directory of your greenstone 3 installation. Any path separator is fine here ('/', '\\', '\').
     83A. Copy the file greenstone3/resources/tomcat/greenstone3.xml into Tomcat's conf/Catalina/localhost directory. You'll need to edit the file and replace @gsdl3webhome@ with the full path to the web directory of your greenstone 3 installation. Any path separator is fine here ('/', '\\', '\').
    8484
    8585B. Alternatively, you can move (and rename) the greenstone3/web directory to tomcat/webapps/greenstone3 (i.e. the resulting directories will be like
     
    8989i.e.
    9090web.home=${tomcat.installed.path}/webapps/greenstone3
    91 And then run 'ant configure-web' to reset gsdl3home.
     91And then run 'ant configure' to reset gsdl3home.
    9292
    93932. Set up the JNI libraries and Java wrappers.
     
    188188ant compile
    189189
    190 The compile target, under GNU/Linux and Mac OS X, does Java and C/C++ compilation. For Windows, since Visual Studio is not a standard component, only Java compilation is carried out. Pre-compiled binaries are provided for the C/C++ components (src/packages and Greenstone 2 style building). If you have Visual Studio installed (version 6), you can run the compile-windows-c++ targets to compile the code locally. (Don't forget to setup the Visual Studio environment first, by running, e.g. C:/Program Files/Microsoft Visual Studio/VC98/Bin/VCVARS32.BAT or equivalent.)
     190The compile target does Java and C/C++ compilation. On Windows, you need to set the compile.windows.c++.setup property to be your Visual Studio setup batch file.
    191191
    192192Any sub targets can be run by themselves. Run 'ant -projecthelp' for a list of public targets, otherwise you can look at the build.xml file to see which targets depend on other ones.
    193 
    194 If you run your install using an external Tomcat, the SOAP web service for localsite (used by the gateway servlet) will not be loaded. You need to start up Tomcat, then run 'ant soap-deploy-site' and accept the defaults for sitename and siteuri (both localsite). If you want to use the gateway servlet without restarting Tomcat, you will need to reload the site information. Visit the URL http://localhost:8080/greenstone3/gateway?a=s&sa=c  (substituting your server name and port number if necessary). See the user guide for more information about run time reconfiguration.
    195193
    196194
Note: See TracChangeset for help on using the changeset viewer.