Changeset 13849 for trunk/gsdl3/README.txt
- Timestamp:
- 2007-02-05T14:37:10+13:00 (17 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/gsdl3/README.txt
r13383 r13849 17 17 --------------------------------------------------------- 18 18 19 [TODO: check once release is done]20 19 Download the appropriate installer from sourceforge.net/projects/greenstone3 and run it. 21 20 … … 27 26 --------------------------------------------------------- 28 27 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. 28 To 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 30 Alternatively, 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). 32 31 33 32 Once the Tomcat server is running, Greenstone will be available in a browser at "http://localhost:8080/greenstone3" (or whatever port you specified during the 34 33 installation 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] 34 You 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'. 38 35 39 36 Building Collections: … … 48 45 Note that GLI doesn't start up the Greenstone Tomcat server so you should 49 46 run 'ant start' before previewing your collection. 47 48 50 49 Greenstone Admin 51 50 ------------------------------------------------------ 52 51 53 [TODO: notes about admin tool] 52 The Greenstone admin tool is currently under development. 54 53 55 54 Using SOAP: … … 62 61 To set up a SOAP server on a new site, run 63 62 ant 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. 63 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. 65 64 66 65 For a non-interactive version, run … … 70 69 (or http://<computer-web-address>:<port>/greenstone3/services/<siteuri>) 71 70 71 Note: 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. 72 72 73 73 Using External Tomcat: … … 75 75 76 76 If you want to use an existing Tomcat, set the path to its base directory 77 in build.properties (tomcat.installed.path) 77 in 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'. 78 78 79 79 You will need to modify the Tomcat setup slightly. … … 81 81 1. Tell Tomcat about the Greenstone web app. There are two ways to do this. 82 82 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 @gsdl3web dir@ with the full path to the web directory of your greenstone 3 installation. Any path separator is fine here ('/', '\\', '\').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 @gsdl3webhome@ with the full path to the web directory of your greenstone 3 installation. Any path separator is fine here ('/', '\\', '\'). 84 84 85 85 B. Alternatively, you can move (and rename) the greenstone3/web directory to tomcat/webapps/greenstone3 (i.e. the resulting directories will be like … … 89 89 i.e. 90 90 web.home=${tomcat.installed.path}/webapps/greenstone3 91 And then run 'ant configure -web' to reset gsdl3home.91 And then run 'ant configure' to reset gsdl3home. 92 92 93 93 2. Set up the JNI libraries and Java wrappers. … … 188 188 ant compile 189 189 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.)190 The 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. 191 191 192 192 Any 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.195 193 196 194
Note:
See TracChangeset
for help on using the changeset viewer.